Vergleichsreport

Der Job buildCustomGroups erstellt und pflegt Webdesk-Gruppen anhand einer SQL-Einschränkung auf den TA-Personenstammdaten des TA-Systems. Im mitgelieferten Descriptor ist er aktiv und konfigurierbar.

Ablauf je Definition

1. Die SQL-Einschränkung wird an den TA-Personenservice übergeben. Die gefundenen TA-Personen werden über ihre TA-ID einer Webdesk-Person zugeordnet. Nicht gefundene Zuordnungen werden protokolliert und ignoriert; doppelte Webdesk-Personen werden nicht mehrfach übernommen.
2. Bei Neue Gruppe wird die Gruppe im ausgewählten Mandanten und in der ausgewählten Organisationsstruktur gesucht. Existiert sie noch nicht, wird sie mit dem konfigurierten Gruppennamen angelegt.
3. Bei Bestehende Gruppe wird die ausgewählte Gruppe verwendet.
4. Ist die Zielgruppe gültig und wurden Personen gefunden, werden diese Personen mit der Gruppe verknüpft.
5. Wird für eine bestehende Gruppe keine Person gefunden, leert der Job diese Gruppe. Bei einer neuen Gruppe ohne Treffer werden keine Personen verknüpft.
6. Nach dem Verknüpfen kann optional ein JavaScript ausgeführt werden.

Konfiguration

• Typ: Neue Gruppe oder bestehende Gruppe.
• Gruppenname: Name der neuen beziehungsweise ausgewählten Gruppe.
• Mandant und Organisationsstruktur: Relevant beim Anlegen einer neuen Gruppe.
• Filter: SQL-Einschränkung für die TA-Personen. Die verfügbaren Felder stammen aus den TA-Personendaten.
• Javascript, welches nach dem Insert ausgeführt wird: Optionales Skript nach dem Verknüpfen. Es erhält unter anderem die Variablen persons, group, orgService und roleService.

Hinweise

Der Job verarbeitet mehrere Definitionen nacheinander. Die bestehende Gruppe wird bei einem Treffer nicht automatisch von nicht mehr passenden Personen bereinigt; entfernt werden bestehende Mitglieder nur dann, wenn für eine bestehende Gruppe überhaupt keine Person die Einschränkung erfüllt. Ist der TA-Connector nicht erreichbar, wird dies im Job-Log protokolliert.

Die allgemeinen Job-Parameter wie Trigger und Mailbenachrichtigung gelten entsprechend der zentralen JobverwaltungThe 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.