Construtor de expressões com sincronização de nuvem
O construtor de expressões é uma nova função no Azure localizada em sincronização de nuvem. Ele ajuda você a criar expressões complexas. Você pode usá-la para testar essas expressões antes de aplicá-las ao seu ambiente de sincronização de nuvem.
Usar o construtor de expressões
Para acessar o construtor de expressões:
- Entre no Centro de Administração do Microsoft Entra como pelo menos um Administrador Híbrido.
- Navegue até Identidade>Gerenciamento híbrido>Microsoft Entra Connect>Sincronização na nuvem.
Em Configuração, selecione sua configuração.
Em Gerenciar atributos, selecione Clique para editar mapeamentos.
No painel Editar mapeamentos de atributo, selecione Adicionar mapeamento de atributo.
Em Tipo de mapeamento, selecione Expressão.
Selecione **Experimente o construtor de expressões **.
Criar uma expressão
Nesta seção, você usa a lista suspensa para selecionar entre as funções com suporte. Em seguida, você preenche mais caixas, dependendo da função selecionada. Após você selecionar Aplicar expressão, a sintaxe aparece na caixa Entrada de expressão.
Por exemplo, com a seleção de Substituir na lista suspensa, mais caixas são fornecidas. A sintaxe da função é exibida na caixa azul claro. As caixas exibidas correspondem à sintaxe da função selecionada. A substituição funciona de maneira diferente dependendo dos parâmetros fornecidos.
Para este exemplo, quando oldValue e replacementValue são fornecidos, todas as ocorrências de oldValue são substituídas na origem por replacementValue.
Para saber mais, confira Substituir.
A primeira coisa que você precisa fazer é selecionar o atributo que é a origem da função de substituição. Neste exemplo, o atributo de email está selecionado.
Em seguida, encontre a caixa de oldValue e insira @fabrikam.com. Por fim, na caixa de replacementValue, preencha o valor @contoso.com.
A expressão basicamente diz, substitua o atributo de email em objetos de usuário que têm um valor de @fabrikam.com pelo valor @contoso.com. Quando seleciona Adicionar expressão, você pode ver a sintaxe na caixa Entrada da expressão.
Nota
Coloque os valores nas caixas que corresponderiam a oldValue e replacementValue com base na sintaxe ocorrida quando você selecionou Substituir.
Para obter mais informações sobre expressões com suporte, consulte Escrevendo expressões para mapeamentos de atributo no Microsoft Entra ID.
Informações sobre caixas de entrada do construtor de expressões
Dependendo de qual função você selecionou, as caixas fornecidas pelo construtor de expressões aceitam vários valores. Por exemplo, a função JOIN aceita cadeias de caracteres ou o valor associado a um determinado atributo. Por exemplo, podemos usar o valor contido no valor de atributo de [givenName] e junhá-lo com um valor de cadeia de caracteres de @contoso.com para criar um endereço de email.
Para obter mais informações sobre valores aceitáveis e como escrever expressões, consulte Escrever expressões para mapeamentos de atributo no Microsoft Entra ID.
Testar uma expressão
Nesta seção, você pode testar suas expressões. Na lista suspensa, selecione o atributo mail. Preencha o valor com @fabrikam.com e selecione Testar expressão.
O valor @contoso.com aparece na caixa Exibir saída da expressão.
Implantar a expressão
Depois de estar satisfeito com a expressão, selecione Aplicar expressão.
Essa ação adiciona a expressão à configuração do agente.
Definir um valor NULL em uma expressão
Para definir o valor de um atributo como NULL, use uma expressão com o valor de "". Essa expressão transfere um valor NULL para o atributo de destino.
