Criar uma definição de ETL de SCIM

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 5 min. de leitura

    • Use as definições de ETL de SCIM para mapear os atributos personalizados com as tabelas sys_user ou sys_user_group.

    Antes de Iniciar

    Função necessária: scim_admin

    Aviso:
    Conceda esta função com cuidado. A função scim_admin é equivalente a conceder ao usuário a função de administrador, em que a função scmin_admin pode inserir novos registros nas tabelas que podem ignorar a lógica de negócios ou a proteção da ACL.
    Nota:
    • As definições de ETL de Grupo e Usuário de SCIM fazem parte do sistema de base para mapeamento de recursos. Você pode usar os mesmos mapeamentos de recursos e mudar os critérios conforme necessário, ou pode criar novos mapeamentos de recursos.
    • Não há suporte para campos [*] por meio de RTE no mapeamento SCIM.

    Procedimento

    1. Siga as instruções em Criar definições de carga de transformação de extração (ETL).
    2. Abra o registro recém-criado e exiba os detalhes.
    3. Na seção Entidades de ETL, crie uma entidade clicando em Novo.
      Você precisa criar entidades para os seguintes usuários:
      • scim-user: para os campos que são do SCIM.
      • Tabela de usuário (sys_user) ou grupo (sys_user_group): para os campos que você deseja mapear da tabela de banco de dados com o SCIM. Por exemplo, para personalização de detalhes do usuário por meio do SCIM, você pode usar a tabela sys_user.
      1. No formulário, preencha os campos.
        Tabela 1. Formulário de entidade de ETL
        Campo Descrição
        Nome Nome da entidade de ETL.
        Aplicação Escopo da aplicação para este registro.
        Tabela Tabela de destino para a entidade de ETL.
        Definição Entidade de ETL selecionada.
        Caminho Caminho exclusivo para esta entidade. Não especifique nenhum caminho para a entidade que representa a tabela de conjunto de importação. Quando uma entidade representa uma coleção, o caminho deve terminar com um asterisco [*]. Este requisito se aplica a entradas intermediárias e à entidade da tabela de destino.
        Sincronizar inserções Opção para garantir apenas um registro com valores de campo unificados exclusivos sincronizando as inserções de registro.
        Executar regras de negócio Opção para executar regras de negócio.
      2. Clique em Enviar.

        As entidades de ETL são criadas para scim-user e tabelas de usuário. Você precisa criar campos de entidade de ETL nessas entidades de ETL e mapear ambas as entidades criando um mapeamento de entidade de RTE.

        Entidade de ETL
    4. Crie as entidades e mapeie-as.
      1. Abra o registro enviado (scim-user e usuário).
      2. Nos campos Entidade de ETL, adicione os campos clicando em Novo.
      3. No formulário, preencha os campos.
        Tabela 2. Formulário de entidade de ETL
        Campo Descrição
        Nome Nome da definição do campo de entidade de ETL.
        Aplicação Entidade de ETL selecionada à qual esta definição de campo pertence.
        Campo/Caminho Este campo é uma coluna ou um caminho.
        • O campo é um nome de coluna quando a entidade é a tabela de importação ou destino.
        • O campo é um caminho quando o campo tem estruturas aninhadas.
        Entidade Entidade à qual esta operação se aplica. Escolha a entidade usando o ícone de pesquisa.
        Ação de coerção O que o sistema deve fazer se uma referência ou opção não puder ser encontrada. As opções são as seguintes:
        • Criar: crie uma nova referência ou opção. Atribua a referência ou opção ao registro atual.
        • Rejeitar: não salve o registro inteiro no banco de dados.
        • Ignorar: defina o valor atual como vazio.
        Definição Entidade de ETL selecionada à qual esta definição de campo pertence.
        Aglutinar Opção para consultar os registros existentes.
        Campo Entidade de ETL
      4. Envie as entradas clicando em Enviar.

        Você pode adicionar várias entradas como seu campo Entidade de ETL com base em seus requisitos.

        A entidade de ETL scim-user pode ter entidades com a extensão principal (usuário), a extensão da ServiceNow ou a extensão personalizada.

        Entidades de scim-user

        A entidade de ETL do usuário pode ter entidades da tabela do banco de dados. Por exemplo, a tabela sys_user.

        Entidades de usuário
        Nota:
        Para adicionar um filtro nos campos SCIM de entrada, use um sublinhado (_). Este sublinhado se traduz em um filtro de EQ. Por exemplo, o atributo email.type_work.value aplica o filtro de SCIM de e-mail [type eq “work”].value.

        Depois que os campos são criados nos registros de Entidade de ETL do scim-user e do usuário, é necessário criar um registro de mapeamento de Entidade de RTE. Em seguida, você deve especificar a definição de origem e de destino para mapear ambos os campos.

    5. Na seção Mapeamentos da Entidades de RTE, crie um mapeamento de entidade clicando em Novo
    6. No formulário, preencha os campos.
      Campo Descrição
      Nome Nome do mapeamento.
      Entidade de origem Entidade de origem para o mapeamento.
      Entidade de destino Entidade de destino para o mapeamento.
      Ordem Ordem na qual o mapeamento deve ser processado.
      É condicional Opção para designar o mapeamento como condicional.
      Script de condição Script que define as condições que devem ser atendidas para o mapeamento.
      Aplicação Escopo da aplicação para este registro.
      Definição Entidade de ETL selecionada à qual este mapeamento pertence.
      Ignorar Opção para designar se este mapeamento de entidade de ETL deve ser ignorado ao executar integrações de dados usando a Transformação robusta do conjunto de importação (RTE).
      Mapeamento de entidade de RTE
    7. Clique em Enviar.

      O exemplo a seguir mostra um registro criado para mapear os registros de Entidade de ETL de scim-user e do usuário.

      scim-user-mappings
    8. Abra o registro enviado (scim-user-mappings) e crie um mapeamento entre o scim-user e os registros de Entidade de ETL do usuário.
      1. Na seção Mapeamentos de campo de RTE, clique em Novo.
      2. No formulário, preencha os campos.
        Tabela 3. Campos da Entidade ETL
        Campo Descrição
        Campo de origem Escopo da aplicação para este registro.
        Aplicação Entidade de ETL selecionada à qual esta definição de campo pertence.
        Campo de destino Campo ETL de saída para a operação se a operação tiver uma única saída.
        Mapeamento de entidade Mapeamento de entidade ao qual esta operação se aplica.
        Entidade referenciada Entidade referenciada e a operação à qual ela se aplica.
        Definição Entidade de ETL selecionada à qual esta definição de campo pertence.
        Ordem Ordem na qual a operação é executada na entidade.
        Mapeamento do campo de RTE

        O campo de origem Endereço residencial - País (entidade de ETL do scim-user) mapeia o campo de destino como País (entidade de ETL do usuário).

      3. Envie as entradas clicando em Enviar.

        Você pode adicionar várias entradas como seus mapeamentos de Entidade de RTE com base em seus requisitos.

        Mapeamentos de Entidade de RTE

        Os campos de origem e de destino são mapeados conforme configurados. Quando você executa operações CRUD usando o SCIM, os valores personalizados são atualizados na respectiva tabela.

    Resultado

    Essas definições e mapeamentos de ETL permitem extrair dados de uma tabela de origem, transformar os dados conforme desejado e carregar os dados em uma tabela de destino.