Configurer la propriété employeeLeaveDateTime pour un utilisateur
Cet article explique comment configurer l’attribut employeeLeaveDateTime pour un utilisateur. Cette propriété peut être utilisée comme déclencheur pour les workflows « leaver » créés à l’aide de workflows de cycle de vie.
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
---|---|---|
Déléguée (compte professionnel ou scolaire) | User.Read.All et User-LifeCycleInfo.ReadWrite.All | Non disponible. |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | User.Read.All et User-LifeCycleInfo.ReadWrite.All | Non disponible. |
Pour les scénarios délégués, l’administrateur doit également avoir le rôle Administrateur général Microsoft Entra.
Remarque
Il est préférable de mettre à jour ces informations via l’automatisation à l’aide d’une solution de provisionnement RH, de Microsoft Entra Connect ou de synchronisation personnalisée. Pour plus d’informations sur ce processus, consultez Comment synchroniser les attributs pour les workflows de cycle de vie.
Définir la propriété employeeLeaveDateTime
Demande
L’exemple suivant configure le 30 septembre 2022 à 23:59 comme date et heure auxquelles l’utilisateur quittera le organization.
PATCH https://graph.microsoft.com/v1.0/users/aaaaaaaa-bbbb-cccc-1111-222222222222
{
"employeeLeaveDateTime": "2022-09-30T23:59:59Z"
}
Rétablir la valeur Null de la propriété employeeLeveDateTime
La requête retourne un code de réponse 204 No Content
.
PATCH https://graph.microsoft.com/v1.0/users/aaaaaaaa-bbbb-cccc-1111-222222222222
{
"employeeLeaveDateTime": null
}