Job buildCustomGroups

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 in the selected client and in the selected organizational structure. If it does not yet exist, it is created with the configured group name.
3. For Existing group, the selected group is used.
4. If the target group is valid and persons were found, these persons are linked to the group.
5. If no person is found for an existing group, the job empties this group. For a new 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. 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.

Felder