Zum Hauptinhalt springen

Job UpdatePersonImageFromGraphAPI

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.

Die allgemeinen Job-Parameter wie Trigger und Mailbenachrichtigung gelten entsprechend der zentralen Jobverwaltung.