Vergleichsreport

Zweck

Der Job UpdatePersonImageFromGraphAPIJob aktualisiert die Profilbilder ausgewählter Webdesk-Personen mit dem Foto aus Microsoft 365 über die Graph-API.

Voraussetzungen

• Der Job ist im mitgelieferten Descriptor aktiv und über ein Konfigurationsformular einstellbar.
• Für die Webdesk-Groupware-Integration müssen die Graph-API-Zugangsdaten und die Berechtigungen zum Lesen von Benutzerfotos eingerichtet sein.
• Die Zielpersonen werden über die Konfiguration ausgewählt. Die Auflösung kann einzelne Personen, Personen aus ausgewählten Gruppen und Personen aus ausgewählten Mandanten umfassen.

Aktualisierungsmodus

• Mit Groupware-Bild überschreiben: Das in Azure gefundene Bild wird für jede Zielperson übernommen, auch wenn bereits ein anderes Webdesk-Bild vorhanden ist.
• Aktuellstes Bild verwenden: Das Bild aus Azure wird mit dem aktuellen Webdesk-Bild verglichen. Übernommen wird das jeweils aktuellere Bild.

Zielpersonen

Die Auswahlfelder für Personen, Gruppen und Mandanten werden kombiniert. Doppelte Personen werden vor der Verarbeitung entfernt. Ist die Auswahl leer, wird keine Person verarbeitet.

Transaktion und Fehlerverhalten

Im Modus Aktuellstes Bild verwenden wird jede Person in einer eigenen Transaktion verarbeitet. Ein gewöhnlicher Fehler beim Aktualisieren wird protokolliert und die nächste Person wird weiterverarbeitet.

Im Modus Mit Groupware-Bild überschreiben werden alle ausgewählten Personen in einer gemeinsamen Transaktion verarbeitet. Gewöhnliche Fehler werden pro Person protokolliert und die Schleife wird fortgesetzt. Fehler, die auf ungültige oder abgelaufene Graph-Authentifizierungsdaten beziehungsweise einen internen Fehler beim Abruf des OAuth-Tokens hinweisen, werden als fataler Jobfehler weitergegeben.

Purpose

The UpdatePersonImageFromGraphAPIJob job updates the profile pictures of selected Webdesk persons with the photo from Microsoft 365 via the Graph API.

Prerequisites

• The job is active in the supplied descriptor and can be set via a configuration form.
• For the Webdesk groupware integration, the Graph API credentials and the permissions for reading user photos must be set up.
• The target persons are selected via the configuration. The resolution can include individual persons, persons from selected groups, and persons from selected clients.

Update Mode

• Overwrite with groupware picture: The picture found in Azure is adopted for each target person, even if a different Webdesk picture already exists.
• Use most recent picture: The picture from Azure is compared with the current Webdesk picture. The more recent picture is adopted in each case.

Target Persons

The selection fields for persons, groups, and clients are combined. Duplicate persons are removed before processing. If the selection is empty, no person is processed.

Transaction and Error Behavior

In the mode Use most recent picture, each person is processed in its own transaction. An ordinary error during the update is logged and the next person is processed.

In the mode Overwrite with groupware picture, all selected persons are processed in a shared transaction. Ordinary errors are logged per person and the loop continues. Errors that indicate invalid or expired Graph authentication data or an internal error when retrieving the OAuth token are passed on as a fatal job error.

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