Como sincronizar os atributos dos fluxos de trabalho do ciclo de vida

Fluxos de trabalho contêm tarefas específicas, as quais podem ser executadas automaticamente para os usuários com base nas condições de execução especificadas. Há suporte para o agendamento automático de fluxos de trabalho com base nos atributos de usuário employeeHireDate e employeeLeaveDateTime no Microsoft Entra ID.

Para aproveitar ao máximo os fluxos de trabalho do ciclo de vida, o provisionamento de usuários deve ser automatizado e os atributos de agendamento relevantes devem ser sincronizados.

Agendar atributos relevantes

A tabela a seguir mostra os atributos relevantes de agendamento (gatilho) e os métodos de sincronização com suporte.

Este documento explica como configurar a sincronização da sincronização na nuvem do Microsoft Entra Connect local ou do Microsoft Entra Connect para os atributos necessários.

Noções básicas sobre a formatação de EmployeeHireDate e EmployeeLeaveDateTime

EmployeeHireDate e EmployeeLeaveDateTime contêm datas e horas que devem ser formatadas de maneira específica. Isso significa que talvez você precise usar uma expressão para converter o valor do atributo da sua origem em um formato que será aceito pelos recursos EmployeeHireDate ou EmployeeLeaveDateTime. A tabela a seguir descreve o formato esperado e fornece uma expressão de exemplo sobre como converter os valores.

Para obter mais informações sobre expressões, confira Referência para escrever expressões para mapeamentos de atributos no Microsoft Entra ID.

Os exemplos de expressão na tabela usam endDate para SAP e StatusHireDate para o Workday. No entanto, você pode optar por usar atributos diferentes.

Por exemplo, você pode usar StatusContinuousFirstDayOfWork em vez de StatusHireDate para o Workday. Nessa instância, sua expressão seria:

FormatDateTime([StatusContinuousFirstDayOfWork], , "yyyy-MM-ddzzz", "yyyyMMddHHmmss.fZ")

A tabela a seguir tem uma lista de atributos sugeridos e suas recomendações de cenário.

Para obter mais atributos, confira Referência de atributo do Workday e Referência de atributo do SAP SuccessFactors.

Importância da hora

Para garantir a precisão horária dos fluxos de trabalho agendados, é crucial considerar:

• A parte da hora do atributo deve ser definida adequadamente, por exemplo, employeeHireDate deve ter uma hora no início do dia, como 1h ou 5h, e employeeLeaveDateTime deve ter a hora no final do dia, como 21h ou 23h
• Os fluxos de trabalho não serão executados antes da hora especificada no atributo, mas o agendamento do locatário (padrão 3h) pode atrasar a execução do fluxo de trabalho. Por exemplo, se você definir employeeHireDate como 8h, mas o agendamento do locatário não for executado até 9h, o fluxo de trabalho não será processado até lá. Se uma nova contratação estiver começando às 8h, seria correto definir a hora em algo como (hora de início − agendamento do locatário) para garantir que seja executada antes da chegada do funcionário.
• É recomendável, se você estiver usando TAP (senha de acesso temporária), definir a vida útil máxima para 24 horas. Isso ajudará a garantir que o TAP não expire após ser enviado a um funcionário que talvez esteja em um fuso horário diferente. Para obter mais informações, consulte: Como configurar senha de acesso temporária no Microsoft Entra ID para registrar métodos de autenticação sem senha.
• Ao importar os dados, você deve entender se e como a origem fornece informações de fuso horário para que os usuários possam fazer ajustes possíveis para garantir a precisão horária.

Criar uma regra de sincronização personalizada na sincronização na nuvem do Microsoft Entra Connect para EmployeeHireDate

As etapas a seguir orientam você na criação de uma regra de sincronização usando a sincronização na nuvem.

1. No centro de administração do Microsoft Entra, navegue até >Gerenciamento híbrido>Microsoft Entra Connect.
2. Selecione Gerenciar sincronização de nuvem do Microsoft Entra Connect.
3. Em Configuração, selecione sua configuração.
4. Selecione Clique para editar mapeamentos. Esse link abre a tela Mapeamenots de atributo.
5. Selecione Adicionar Atributo.
6. Preencha as seguintes informações:
   • Tipo de mapeamento: direto
   • Atributo de origem: msDS-cloudExtensionAttribute1
   • Valor padrão: deixar em branco
   • Atributo de destino: employeeHireDate
   • Aplicar esse mapeamento: sempre
7. Escolha Aplicar.
8. De volta à tela Mapeamentos de atributo, você deverá ver o novo mapeamento de atributo.
9. Selecione Salvar esquema.

Para obter mais informações sobre atributos, consulte Mapeamento de atributos na sincronização na nuvem do Microsoft Entra Connect.

Como criar uma regra de sincronização personalizada no Microsoft Entra Connect para EmployeeHireDate

O exemplo a seguir orienta você passo a passo na configuração de uma regra de sincronização personalizada que sincroniza o atributo do Active Directory com o atributo employeeHireDate no Microsoft Entra ID.

1. Abra uma janela do PowerShell como administrador e execute Set-ADSyncScheduler -SyncCycleEnabled $false para desabilitar o agendador.
2. Vá para Iniciar\Microsoft Entra Connect\ e abra o Editor de Regras de Sincronização
3. Verifique se a direção na parte superior está definida como Entrada.
4. Selecione Adicionar Regra.
5. Na tela Criar regra de sincronização de entrada, insira as informações a seguir e selecione Avançar.
   • Nome: Entrada no AD − EmployeeHireDate
   • Sistema Conectado: contoso.com
   • Tipo de objeto do sistema conectado: usuário
   • Tipo de objeto do Metaverso: pessoa
   • Precedência: 20
6. Na tela Filtro de escopo, clique em Avançar.
7. Na tela Regras de ingresso, selecione Avançar.
8. Na tela Transformações, em Adicionar transformações, insira as informações a seguir.
   • FlowType: direto
   • Atributo de destino: employeeHireDate
   • Origem: msDS-cloudExtensionAttribute1
9. Selecione Adicionar.
10. No Editor de Regras de Sincronização, verifique se a direção na parte superior está definida como Saída.
11. Selecione Adicionar Regra.
12. Na tela Criar regra de sincronização de saída, insira as informações a seguir e selecione Avançar.
    • Nome: saída para o Microsoft Entra ID – EmployeeHireDate
    • Sistema Conectado: <seu locatário>
    • Tipo de objeto do sistema conectado: usuário
    • Tipo de objeto do Metaverso: pessoa
    • Precedência: 21
13. Na tela Filtro de escopo, clique em Avançar.
14. Na tela Regras de ingresso, selecione Avançar.
15. Na tela Transformações, em Adicionar transformações, insira as informações a seguir.
    • FlowType: direto
    • Atributo de destino: employeeHireDate
    • Origem: employeeHireDate
16. Selecione Adicionar.
17. Feche o Editor de Regras de Sincronização
18. Habilite o agendador novamente executando Set-ADSyncScheduler -SyncCycleEnabled $true.

Para obter mais informações, consulte Como personalizar uma regra de sincronização e Fazer uma alteração na configuração padrão.

Editar mapeamento de atributo no aplicativo de provisionamento

Depois de configurar o aplicativo de provisionamento, editar o mapeamento de atributo. Quando o aplicativo é criado, você obtém uma lista de mapeamentos padrão entre o HRM e o Active Directory. A partir daí, edite o mapeamento existente ou adicione um novo mapeamento.

Para atualizar esse mapeamento, você seguiria as etapas a seguir:

1. Entre no centro de administração do Microsoft Entra como Administrador global.

2. Navegue até Identidade>Aplicativos>Aplicativos empresariais.

3. Abra seu aplicativo provisionado.

4. Selecione Provisionamento e, em seguida, selecione Editar mapeamento de atributo.

5. Selecione Mostrar opções avançadase selecione Editar lista de atributos para o Active Directory Local.

6. Adicione o atributo da sua origem ou atributos criados como o Tipo Cadeia de Caracteres e marque-os na Caixa de Seleção como obrigatórios.

   Observação

   O número e o nome dos atributos de origem adicionados dependerão de quais atributos você está sincronizando a partir do Active Directory.

7. Selecione Salvar.

8. A partir daí, mapeie os atributos HRM para os atributos adicionados do Active Directory. Para fazer isso, adicione novo mapeamento usando uma expressão.

9. Sua expressão deve corresponder à formatação encontrada na seção Reconhecimento da formatação EmployeeHireDate e EmployeeLeaveDateTime.

10. Selecione Ok.

Como verificar esses valores de atributo em Microsoft Entra ID

Para examinar os valores definidos nessas propriedades em objetos de usuário no Microsoft Entra ID, use o SDK do PowerShell do Microsoft Graph. Por exemplo:

# Import Module
Import-Module Microsoft.Graph.Users

# Define the necessary scopes
$Scopes =@("User.Read.All", "User-LifeCycleInfo.Read.All")

# Connect using the scopes defined and select the Beta API Version
Connect-MgGraph -Scopes $Scopes


# Query a user, using its user ID, and return the desired properties
$user = Get-MgUser -UserID "00aa00aa-bb11-cc22-dd33-44ee44ee44ee" -Property EmployeeLeaveDateTime
$User.EmployeeLeaveDateTime

Próximas etapas

• O que são fluxos de trabalho do ciclo de vida?
• Criar um fluxo de trabalho personalizado usando o Centro de administração do Microsoft Entra
• Configurar o aplicativo de provisionamento de entrada controlado por API (pré-visualização pública)
• Criar um fluxo de trabalho do Ciclo de Vida