Vergleichsreport

The buildCustomGroups job creates and maintains Webdesk groups based on an SQL restriction on the TA person master data of the TA system. In the supplied descriptor it is active and configurable.

Process per definition

1. The SQL restriction is passed to the TA person service. The TA persons found are assigned to a Webdesk person via their TA ID. Assignments that are not found are logged and ignored; duplicate Webdesk persons are not added more than once.
2. For New group, the group is searched for by its group name (short name) in the selected client and in the selected organizational structure. If it does not yet exist, it is created with the configured group name in the selected organizational structure. If it already exists, it is treated like an existing group.
3. For Existing group, the selected group is used.
4. If the target group is valid and persons were found, these persons the group membership is reconciled with the result: persons found are linked to the group, and previous members that no longer satisfy the restriction are removed from the group.
5. If no person is found for an existing group, the job empties this group. For a new newly created group with no matches, no persons are linked.
6. After linking, a JavaScript can optionally be executed.

Configuration

• Type: New group or existing group.
• Group name: Name of the new or selected group.
• Client and Organizational structure: Relevant when creating a new group.
• Filter: SQL restriction for the TA persons. The available fields come from the TA person data.
• JavaScript to be executed after the insert: Optional script after linking. It receives, among others, the variables persons, group, orgService and roleService.

Notes

The job processes multiple definitions sequentially. If there is a match, the existing group is not automatically cleaned of persons that no longer match; existing members are only removed if no person at all satisfies the restriction for an existing group. On every run the target group is fully synchronized with the result of the restriction; members added manually that do not satisfy the restriction are removed again. Therefore use groups that are maintained exclusively by this job. If the TA connector is unreachable, this is logged in the job log.

The general job parameters such as trigger and mail notification apply as defined in central job management.