Job UpdatePersonImageFromGraphAPI

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.