Deployment

Transformação por expressões regulares para sincronização do usuário

Esse recurso permite que os administradores definam expressões regulares (RegEx) para transformar dados do usuário durante o processo de sincronização. Ao configurar os parâmetros RegEx, os administradores podem extrair e modificar as informações necessárias a partir de atributos selecionados, de acordo com suas necessidades.

Atualmente, esse recurso é compatível apenas com as fontes de sincronização LDAP e Entra ID, disponíveis a partir do MyQ Server 10.2 RC 2.

Etapas para usar a transformação RegEx na sincronização de usuários:

  • Acessando as configurações de sincronização:

    • Vá para MyQ, Configurações, Sincronização de usuários.

    • Dependendo da sua configuração, clique duas vezes em “Sincronização LDAP” ou “Sincronização Entra ID” para que as configurações de sincronização sejam exibidas à direita.

  • Localizando a seção “Transformação”:

    • Na guia “Usuários”, role para baixo e expanda a seção “Transformação”.

      Transformation section

       

  • Configurando a transformação RegEx:

    • Você pode adicionar e configurar as seguintes propriedades de usuário compatíveis:

      • Alias

      • Cartão

      • PIN

      • Número pessoal

    • Clique em “Adicionar” e, para cada propriedade, insira a expressão regular desejada no campo fornecido para modificar a respectiva propriedade do usuário.

  • Testando sua expressão regular:

    • Após inserir a expressão regular desejada, você pode testar sua precisão e funcionalidade.

    • Clique no botão “Testar”.

    • Uma caixa de diálogo semelhante a outras caixas de diálogo de teste de expressões regulares no MyQ será exibida.

      • Insira a sequência de caracteres que deseja testar no campo fornecido.

      • Insira ou verifique a expressão RegEx.

      • Clique no botão “Testar”.

    • Os dados resultantes, após a transformação, serão exibidos com base na sua expressão RegEx. Isso ajuda a garantir que a expressão funcione conforme o esperado antes de aplicá-la aos dados reais do usuário.

      Testing a RegEx

       

As expressões regulares oferecem uma maneira poderosa de manipular dados de usuários durante a sincronização. Ao utilizar esse recurso, os administradores podem garantir que os dados importados para o MyQ estejam exatamente no formato e com o conteúdo desejados. Sempre teste suas expressões regulares antes de aplicá-las a dados reais para evitar resultados inesperados.

Exemplos

Cenário: Remover quaisquer caracteres que não sejam dígitos dos PINs.

  • Expressão regular: \d

Se o PIN for '12a3b4', o valor transformado será '1234'.

Se a string de origem não contiver caracteres numéricos, o valor de saída ficará vazio. Apenas os caracteres correspondentes à expressão regular serão copiados para a saída.

 

Cenário: Remover todos os caracteres, exceto os alfabéticos, dos números de cartão.

  • Expressão regular: [A-Za-z]

Para um número de cartão 1234-5678“”, isso o transformará em “12345678”.

Se a string de origem não contiver caracteres alfabéticos, o valor de saída ficará vazio. Apenas os caracteres correspondentes à expressão regular serão copiados para a saída.

 

Cenário: Manter apenas os primeiros 5 caracteres do número pessoal.

  • Expressão regular: ^.{5}

Para um número pessoal '1234567890', isso o transformará em '12345'.

Se o comprimento da string de origem for menor que 5 caracteres, o valor de saída ficará vazio. Apenas os caracteres correspondentes à expressão regular serão copiados para a saída.

 

Cenário: Manter apenas os últimos 3 caracteres do número pessoal.

  • Expressão regular: .{3}$

Para um número pessoal '1234567890', isso o transformará em '890'.

Se o comprimento da string de origem for inferior a 3 caracteres, o valor de saída ficará vazio. Apenas os caracteres correspondentes à expressão regular serão copiados para a saída.