Vergleichsreport

Zweck

Der Job buildGroupsAndAssignPersons pflegt Gruppen anhand einer oder mehrerer konfigurierter externer Datenquellen. Für jede Gruppendefinition werden die gelieferten Personen ermittelt und die Gruppenmitgliedschaften auf den aktuellen Stand gebracht.

Der Job ist im mitgelieferten Descriptor derzeit nicht aktiv, konfigurierbar und unterbrechbar.

Ablauf

1. Alle konfigurierten Gruppendefinitionen werden nacheinander verarbeitet. Bei einer Unterbrechung wird die Verarbeitung beendet. Fehler in einer Gruppendefinition werden protokolliert; die übrigen Definitionen werden weiterverarbeitet.
2. Ist keine bestehende Gruppe ausgewählt, wird eine neue Gruppe aus Organisationsstruktur, Kurzname, Name und Beschreibung angelegt. Andernfalls wird die ausgewählte Gruppe verwendet.
3. Über den konfigurierten Connector, die Abfrage und Einschränkung werden die Personenkennungen aus dem Feld für die Personenidentität gelesen. Leere Kennungen und nicht gefundene Personen werden protokolliert und ignoriert.
4. Personen, die heute bereits Mitglied sind, aber nicht mehr von der Quelle geliefert werden, werden aus der Gruppe entfernt. Das ist in hierarchischen Organisationsstrukturen nicht zulässig.
5. Neue Personen werden mit einer Gültigkeit ab heute bis zur Unendlichkeit verknüpft, soweit sich diese Gültigkeit mit der Gültigkeit von Person und Gruppe überschneidet.

Konfiguration je Gruppendefinition

• Mandant, Organisationsstruktur und optional Gruppe: Legen fest, wo die Gruppe gepflegt wird. Ohne bestehende Gruppe wird sie neu angelegt.
• Kurzname, Name und optional Beschreibung: Definieren die neue beziehungsweise zu pflegende Gruppe.
• Quelle, Abfrage und Einschränkung: Bestimmen die externe Datenquelle und die gelieferten Datensätze.
• Feld für Personenidentität: Gibt das Feld der Connector-Antwort mit der Personenkennung an.
• Typ der Personenidentität: Legt fest, ob die Kennung als Webdesk-UID, Personalnummer, E-Mail-Adresse, TA-ID oder Benutzername aufgelöst wird.

Purpose

The buildGroupsAndAssignPersons job maintains groups based on one or more configured external data sources. For each group definition, the delivered persons are determined and the group memberships are brought up to date.

In the descriptor that ships with the product, the job is currently not active, configurable and interruptible.

Process

1. All configured group definitions are processed one after the other. If interrupted, processing ends. Errors in a group definition are logged; the remaining definitions continue to be processed.
2. If no existing group is selected, a new group is created from organization structure, short name, name and description. Otherwise the selected group is used.
3. Using the configured connector, the query and Restriction, the person identifiers are read from the person identity field. Empty identifiers and persons that are not found are logged and ignored.
4. Persons who are already members today but are no longer delivered by the source are removed from the group. This is not permitted in hierarchical organization structures.
5. New persons are linked with a validity from today to infinity, to the extent that this validity overlaps with the validity of the person and the group.

Configuration per group definition

• Client, Organization structure and optionally Group: Determine where the group is maintained. Without an existing group, it is newly created.
• Short name, Name and optionally Description: Define the new group or the group to be maintained.
• Source, Query and Restriction: Determine the external data source and the records delivered.
• Person identity field: Specifies the field of the connector response that contains the person identifier.
• Person identity type: Determines whether the identifier is resolved as Webdesk UID, personnel number, e-mail address, TA ID or user name.

Several group definitions can be added or removed via the repeater. The general job parameters such as trigger and mail notification apply as described in the central job management.