Configurar a propriedade employeeLeaveDateTime para um utilizador
Este artigo descreve como configurar o atributo employeeLeaveDateTime para um utilizador. Esta propriedade pode ser utilizada como um acionador para fluxos de trabalho "leaver" criados através de Fluxos de Trabalho do Ciclo de Vida.
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | User.Read.All e User-LifeCycleInfo.ReadWrite.All | Indisponível. |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | User.Read.All e User-LifeCycleInfo.ReadWrite.All | Indisponível. |
Para cenários delegados, o administrador também tem de ter a função de Administrador Global Microsoft Entra.
Observação
Estas informações são atualizadas melhor através da automatização através de uma solução de aprovisionamento de RH, Microsoft Entra Connect ou sincronização personalizada. Para obter mais informações sobre este processo, veja Como sincronizar atributos para fluxos de trabalho de ciclo de vida.
Definir a propriedade employeeLeaveDateTime
Solicitação
O exemplo seguinte configura 30 de setembro de 2022 às 23:59 como a data e hora em que o utilizador sairá da organização.
PATCH https://graph.microsoft.com/v1.0/users/aaaaaaaa-bbbb-cccc-1111-222222222222
{
"employeeLeaveDateTime": "2022-09-30T23:59:59Z"
}
Repor a propriedade employeeLeveDateTime novamente para nulo
A solicitação retorna o código de resposta 204 No Content.
PATCH https://graph.microsoft.com/v1.0/users/aaaaaaaa-bbbb-cccc-1111-222222222222
{
"employeeLeaveDateTime": null
}