Criar um Mapa de Transformação do ETL

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 41 min. de leitura
  • O IntegrationHub ETL fornece uma configuração orientada que conduz você na conclusão de todas as tarefas necessárias para criar um mapa de transformação de ETL para uma integração específica.

    Configuração assistida

    A configuração orientada organiza todas as tarefas na ordem correta, rastreia a conclusão das tarefas e impõe todas as dependências de tarefa. Tarefas que dependem da conclusão de outras tarefas são habilitadas ou desabilitadas conforme você percorre a ferramenta e conclui as tarefas.

    Use a configuração orientada na página do Assistente do mapa de transformação de ETL para concluir as tarefas a seguir.

    Importar fonte de dados e especificar detalhes básicos

    Forneça detalhes básicos para a integração, como a origem dos dados que você deseja integrar ao CMDB, e importe os dados de origem.

    Antes de Iniciar

    A fonte de dados que você planeja selecionar para o Mapa de Transformação de ETL deve existir no mesmo escopo da aplicação que está sendo usada na sessão atual.

    Quando você abre um mapa de transformação de ETL, por padrão, o mapa não é validado. Você pode habilitar essa etapa de validação adicionando a propriedade do sistema sn_int_studio.validation.enabled à tabela Propriedades do sistema [sys_properties] e a definindo como true. Após a conclusão da validação, você escolhe como lidar com os erros de validação.

    Função exigida: cmdb_inst_admin

    Procedimento

    1. Navegar até Tudo > Configuração > IntegrationHub ETL.
      A página inicial do IntegrationHub ETL lista todas as integrações que existem no sistema, incluindo integrações que foram baixadas de ServiceNow Store. A partir do IntegrationHub ETL v3.2, as integrações são agrupadas pelo valor CMDB Application e, nesse caso, expanda o respectivo grupo para localizar uma integração.
    2. Clique no Nome de uma integração para exibir ou modificar, ou clique em Criar nova.
      Se a propriedade do sistema sn_int_studio.validation.enabled estiver definida como true, o IntegrationHub ETL validará o mapa de transformação de ETL que você está carregando. Se houver erros de validação, a caixa de diálogo Dados de mapeamento inválidos detectados será exibida, listando todos os erros específicos que foram detectados. Você pode optar por excluir os mapeamentos inválidos e continuar apenas com os mapeamentos válidos ou pode optar por manter os mapeamentos inválidos. No entanto, as notificações sobre mapeamentos inválidos continuarão a aparecer enquanto você estiver trabalhando com a integração.
      O sistema detecta erros como:
      • Campos de origem ou de destino ausentes nos registros de mapeamento de campo do Mecanismo de Transformação Robusta (RTE)
      • Colunas da tabela ausentes no conjunto de importação
        Nota:
        Nessa situação, todos os registros de metadados correspondentes no RTE não são mais válidos e são excluídos automaticamente. Registros como mapeamentos de campo e operações de transformação que estão associados às colunas da tabela ausentes no conjunto de importação são excluídos.
      • Falta uma regra de pesquisa do Mecanismo de Identificação e Reconciliação (IRE) para uma classe de pesquisa
    3. Na página do Assistente de Mapa de Transformação de ETL, na seção Especificar Detalhes Básicos da configuração assistida, selecione a tarefa Importar Dados de Origem e Fornecer Detalhes Básicos.
    4. Preencha o formulário.
      Campo Descrição
      Aplicação do CMDB

      Aplicação do CMDB associada ao mapa de transformação de ETL.

      Você pode selecionar Adicionar novo para adicionar a Aplicação do CMDB e os campos da Origem do Discovery a nova aplicação do CMDB.

      Nome Nome do mapa de transformação de ETL.
      Descrição Descrição da integração.
      Fonte de Dados Lista de todas as fontes de dados no sistema.
      Nota:
      Tenha cuidado ao modificar a fonte de dados posteriormente, pois isso pode resultar em mudanças substanciais na integração de dados. O alinhamento com a tabela de conjunto de importação da nova fonte de dados pode exigir a remoção de colunas e transformações associadas ou a adição de novas colunas. Os processos de validação do IntegrationHub ETL detectarão todas as atualizações necessárias e permitirão que você aceite ou rejeite essas atualizações.
      Amostra de Import Set

      Um Import Set existente que está associado à Fonte de Dados especificada.

      Um subconjunto dos dados do Import Set é usado para visualizar os dados de origem.

      Selecione a opção Extrair automaticamente um novo import set para extrair um novo import set da fonte de dados associada.

      A partir do IntegrationHub ETL v3.2, se nenhum Import Set for especificado, o mapa será carregado e definido automaticamente para estar no modo somente leitura. Você pode revisar as configurações no mapa, mas não pode editar mapeamentos ou transformações.

      Visualizar Substituição de Tamanho

      Número de registros de dados que são carregados e usados como amostra para a visualização deste mapa de transformação. Se definida, esta configuração personalizada substituirá o valor da propriedade do sistema do sn_int_studio.preview.size e se aplicará somente ao mapa de transformação atual.

      Se Carregar Esquema Completo estiver desabilitado, a estrutura de dados aninhada do mapa será gerada com base somente no número especificado de registros carregados.

      Campo disponível a partir do IntegrationHub ETL v3.2.

      Carregar Esquema Completo

      Habilite ou desabilite o carregamento de todo o esquema de dados para gerar a estrutura de dados do mapa.

      Quando desabilitada, a estrutura de dados aninhada do mapa é gerada com base somente no número de registros carregados como registros de amostra para visualização. O número de registros carregados é determinado pela configuração de Substituição de Tamanho da Visualização ou pela propriedade do sistema global sn_int_studio.preview.size.

      Campo disponível a partir do IntegrationHub ETL v3.2.

      Aplicação do CMDB Nome de uma nova aplicação do CMDB. Aparece se você definir a Aplicação do CMDB como Adicionar novo.
      Origem do Discovery

      Origem do Discovery associada a uma nova Aplicação do CMDB. Aparece se você definir a Aplicação do CMDB como Adicionar novo.

    5. Clique em Salvar para salvar as mudanças atuais ou em Marcar como concluída.

      Um marcador de data/hora aparece no cabeçalho quando você clica em Salvar, e permanece durante a sessão do IntegrationHub ETL para o mapa de transformação de ETL. Quando você entra novamente na sessão ou alterna entre mapas de ETL, o marcador de data/hora desaparece.

    Visualizar e preparar dados

    Analise os registros de amostra dos dados de origem brutos, que serão integrados ao CMDB. Transforme e prepare os dados para alinhar as classes e os atributos de destino, se necessário.

    Antes de Iniciar

    O número de registros nos dados de amostra é determinado globalmente pela propriedade do sistema sn_int_studio.preview.size, que é definida como 100 por padrão. O número máximo de registros nos dados de amostra que o IntegrationHub ETL pode processar é 10.000. Se você definir essa propriedade acima do limite de 10.000, o IntegrationHub ETL processará somente até 10.000 registros e uma mensagem será exibida para informar sobre isso.

    A partir do IntegrationHub ETL v3.2, você pode substituir o valor da propriedade sn_int_studio.preview.size definindo o campo Substituição de tamanho de visualização no formulário Importar dados de origem e Fornecer detalhes básicos, por mapa.

    Para processar dados aninhados de uma carga aninhada, a respectiva fonte de dados deve ser definida com a opção Dados em coluna única.

    Função exigida: cmdb_inst_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Revise os valores nas colunas de dados dos dados de amostra e identifique as colunas que não se alinham com os requisitos das classes e atributos de destino pretendidos. Você pode transformar dados, por exemplo, convertendo o formato de dados, substituindo valores e concatenando colunas de dados. Você pode aplicar as transformações uma em cima da outra, criando uma cadeia de transformações de dados. Você também pode definir que uma coluna de dados seja ignorada no processo de mapeamento e integração.
    Nota:
    Para definir um atributo do CMDB como vazio, use a cadeia de caracteres '<EMPTYֹ_STRING> '.

    As colunas de dados aninhados aparecem ao lado do restante dos dados, com uma notação de objetos aninhados no cabeçalho da coluna de dados. A contagem de itens de dados aninhados por objeto aparece com um link que permite detalhar níveis mais profundos dos dados aninhados. Para mostrar a estrutura de dados dos dados aninhados em um painel separado, habilite a opção Mostrar estrutura de dados.

    O painel Estrutura de Dados tem duas opções para exibir dados aninhados:

    • Árvore: dados aninhados agrupados por objetos, em que cada nó de objeto corresponde a uma entrada de registro nos dados de origem. Expanda os nós de objeto para mostrar todos os dados aninhados para o registro.
    • Coleção: dados aninhados agrupados pelo objeto de nível superior (por padrão) e por itens de dados aninhados, como software. Expanda um nó, como software, para mostrar quais softwares estão instalados em cada computador.
    Você pode navegar pelos níveis de dados aninhados no painel Estrutura de dados, pelo caminho das trilhas ou por meio de links numéricos que aparecem nos próprios dados de origem. Suas seleções e os dados que aparecem são mantidos sincronizados entre todas as exibições dos dados aninhados, independentemente da navegação.

    Para obter uma demonstração sobre como trabalhar com dados de carga aninhados, assista ao vídeo Demonstração de recursos de carga útil aninhada do Integration Hub - ETL no canal do YouTube da ServiceNow.

    Procedimento

    1. Navegar até Tudo > Configuração > IntegrationHub ETLe clique no Nome de uma integração.
      A página inicial do IntegrationHub ETL lista todas as integrações que existem no sistema, incluindo integrações que foram baixadas de ServiceNow Store.
    2. Na página do Assistente do mapa de transformação de ETL, na seção Preparar dados de origem para mapeamento da configuração orientada, selecione Visualizar e preparar dados.
    3. Opcional: Selecione Mostrar estrutura de dados para abrir o painel Estrutura de dados, que mostra a estrutura de dados aninhados. No painel Estrutura de Dados, você pode fazer uma busca detalhada nos níveis de dados aninhados.
    4. Opcional: Selecione o menu de ação de uma coluna e escolha a operação de classificação.
    5. Selecione o menu de ação de uma coluna e escolha Agrupar por a fim de agrupar os dados pela respectiva coluna. Selecione Desagrupar para desfazer a operação de agrupamento.
    6. Opcional: Clique em Nova transformação e selecione Usar coluna de origem . Ou selecione o menu de ação de uma coluna e escolha Nova Transformação a fim de transformar a coluna selecionada.

      Você não pode criar novas transformações para objetos aninhados nesta exibição de nível superior dos dados. Uma coluna de objeto aninhado contém links de número que indicam o número de itens aninhados para o registro. Para criar uma nova transformação para objetos aninhados, clique no link numérico para ver os dados aninhados reais. Como alternativa, navegue no painel Estrutura de Dados até o objeto aninhado para o qual você deseja criar uma transformação.

      Uma transformação de dados aninhados pode fazer referência a objetos primários dos dados aninhados que estão sendo transformados. Usando a carga de amostra para dados aninhados como exemplo, a transformação de um objeto de interface pode fazer referência ao objeto do computador primário, mas não pode fazer referência a um objeto de software.

      1. Na barra lateral Nova Transformação à direita, selecione um Tipo de Transformação e modifique a Descrição de Transformação, se apropriado.
        Para obter mais detalhes sobre os tipos de transformação, confira Tipos de transformação no IntegrationHub ETL.
      2. Opcional: Selecione Ocultar coluna inicial usada para esta transformação a fim de ocultar da exibição atual todas as colunas que foram usadas para esta transformação.
        Esta configuração é temporária para a sessão atual e se você atualizar a página, a coluna oculta reaparecerá. Para mostrar uma coluna oculta, você também pode clicar no ícone de engrenagem na faixa superior. Em seguida, mova a coluna oculta da lista Disponível para Selecionadas e clique em OK.
      3. Selecione ou verifique a Coluna de entrada cujos valores estão sendo transformados.
      4. Opcional: Modifique o Nome da coluna de saída para qualquer uma das colunas que serão adicionadas com os valores transformados.
      5. Clique em Aplicar.
        Uma nova coluna com os valores transformados é exibida, em ordem alfabética com base no nome da coluna de saída. Se você usou o nome da coluna de saída sugerido, a nova coluna aparecerá à direita da coluna de entrada.
      6. Revise os dados transformados e ajuste as transformações, se necessário.
    7. Opcional: Para aplicar a transformação "Definir coluna de valor fixo":
      1. Clique em Nova transformação e selecione Definir coluna de valor fixo.
      2. Na barra lateral Definir coluna de valor fixo, insira um Nome e uma Descrição para a nova coluna. Em seguida, defina Atribuir valor de coluna ao valor fixo da nova coluna.
      3. Clique em Aplicar.
    8. Opcional: Selecione o menu de ação de uma coluna e escolha Ignorar no mapeamento para excluir a coluna do mapeamento e da integração na sessão atual.

      Em uma sessão subsequente, a configuração Ignorar no mapeamento não se aplica e a coluna será incluída no mapeamento.

      Você pode clicar em Incluir no mapeamento para desfazer a configuração Ignorar no mapeamento para a coluna em questão.

    9. Opcional: Selecione o menu de ação de uma coluna e escolha Excluir a coluna atual e as descendentes dela. Esta ação de exclusão remove a coluna junto com todas as colunas que foram adicionadas usando esta coluna como porta de entrada.
    10. Opcional: Clique em Nova transformação e selecione Pesquisa de tabela para especificar uma tabela para pesquisar e extrair valores adicionais. Preencha os campos na barra lateral Pesquisa de tabela, à direita.
      Os valores da tabela de pesquisa especificada são correspondidos com os dados mapeados. Para os registros correspondentes, os valores especificados da tabela de pesquisa são adicionados como uma coluna aos dados que estão sendo preparados para mapeamento.
      Tabela 1. Pesquisa de tabela
      Campo Descrição
      Tabela de pesquisa Tabela a ser usada para correspondência com os dados que estão sendo mapeados. Quando os registros da tabela de pesquisa e os dados mapeados satisfazem a condição de pesquisa, os valores especificados da tabela de pesquisa são extraídos do respectivo registro e adicionados aos dados mapeados.
      Condição de pesquisa

      Conjunto de pares de condições de coluna. Cada par especifica uma coluna na tabela de pesquisa e uma coluna nos dados mapeados, que são verificados quanto à correspondência.

      • Se forem valores da coluna da tabela de destino: a coluna da tabela de destino deve corresponder a uma coluna nos dados mapeados.
      • Corresponder valores da tabela de dados de origem: a coluna nos dados mapeados deve corresponder a uma coluna na tabela de pesquisa.

      Você pode adicionar vários pares de colunas para fazer a correspondência.

      Condição de pesquisa

      Valores a serem extraídos da tabela de pesquisa quando houver uma correspondência com os dados mapeados.

      Em seguida, valores de saída das seguintes colunas: colunas da tabela de pesquisa das quais os valores serão extraídos, quando os valores da tabela de pesquisa e os dados mapeados atenderem à condição de pesquisa.

      Você pode especificar várias colunas da tabela de pesquisa para extrair valores. Para cada coluna especificada, um campo Nome da coluna de saída correspondente aparece automaticamente. Especifique um rótulo para a coluna que será adicionada com os valores extraídos.

      Nome da coluna de saída

      Rótulo da coluna que será adicionada aos dados mapeados, com os valores extraídos da tabela de pesquisa.

      Um campo Nome da coluna de saída é adicionado automaticamente a cada coluna que você especificar em Então, valores de saída das colunas a seguir.

    11. Analise os dados e certifique-se de que o conjunto de dados pretendido a ser integrado seja transformado, formatado corretamente e preparado para importação.
    12. Clique em Marcar como concluído.

    Resultado

    Os dados são preparados quando o conjunto de colunas de dados de origem e as colunas transformadas que você deseja integrar atendem a qualquer formatação e outros requisitos de valor das classes e atributos do CMDB de destino. Essas colunas estão prontas para serem mapeadas e integradas às classes e atributos do CMDB.

    Sobre o mapeamento de colunas de dados para classes e atributos do CMDB

    Existem vários requisitos e diretrizes para mapear dados de origem para classes e atributos do CMDB de destino. Além disso, há uma opção de desativar os mapeamentos de classe enquanto preserva as configurações para uma reativação fácil. Revise esses conceitos para garantir o processamento apropriado pelo Mecanismo de Identificação e Reconciliação (IRE).

    Mapeamentos necessários

    Você deve mapear dados para todos os atributos obrigatórios da classe de destino, além de mapear os dados para atributos que não estão configurados como obrigatórios. Além disso, os dois campos a seguir aparecem por padrão e você não pode excluí-los:
    Chave nativa de origem
    O IRE usa para identificar exclusivamente um registro e para criar relacionamentos e referências. Além disso, melhora o desempenho das operações de inserção e atualização. Ao processar uma carga, o IRE via gerar um erro se este campo estiver vazio.
    Carimbo de data/hora de recency de origem

    O IRE usa para identificar registros que são mais antigos que o registro atual e, portanto, podem ser ignorados, para ajudar a resolver valores de atributo conflitantes. Se um valor é fornecido, ele é usado somente se posterior ao valor armazenado no momento no CMDB. Se um valor não é fornecido, o IRE atualiza o atributo com o carimbo de data/hora atual.

    As propriedades do sistema a seguir permitem modificar como o IRE usa o valor source_recency_timestamp em uma carga para atualizar o atributo last_scan na tabela Origem [sys_object_source]:
    Para obter mais informações sobre como o IRE usa source_native_key e source_recency_timestamp para identificação de IC, consulte Mecanismo de identificação e reconciliação (IRE).

    Classe condicional

    Uma classe condicional permite mapear diferentes conjuntos de registros de dados para diferentes classes de destino, de acordo com valores de coluna específicos ou o status de um plug-in específico.

    Por exemplo, se um nome de exibição contiver "Windows", então "Windows Server" será selecionado como a classe de destino. Mas se o nome de exibição contiver "Linux", então "Linux Server" será selecionado como a classe de destino. Para registros que não atendem a nenhuma dessas condições (o nome de exibição não contém "Windows" nem "Linux"), "Server" é selecionado como a classe de destino.

    Classe associada

    Uma classe associada permite que você selecione a classe do CMDB a ser associada a uma tabela de destino não pertencente ao CMDB. É necessário definir uma classe associada para o processamento de IRE se a tabela não pertencente ao CMDB não estiver configurada para o processamento de IRE. Para uma tabela compatível não pertencente ao CMDB e configurada para processamento de IRE, a definição de uma classe associada é opcional. Confira Suporte do IRE para tabelas não pertencentes ao CMDB para obter mais informações.

    A instância de software é uma classe não pertencente ao CMDB, mas não tem regras de IRE associadas a ela. Então, as coisas que falamos sobre isso aqui antes de Utah ainda são válidas. Mas, para classes não pertencente ao CMDB com regras de IRE, não é obrigatório ter uma associação. Por exemplo, "Se a classe de destino para mapeamento for uma classe não pertencente ao CMDB com uma referência a uma classe do CMDB, você deve selecionar a classe do CMDB com a qual associar a classe de destino não pertencente ao CMDB", a classe não pertencente ao CMDB com regras IRE, em vez de "você é obrigado a” deveria ser “você pode”. O mesmo com Exemplo não é válido para classes não pertencentes ao CMDB com regras IRE.

    Se a classe de destino para mapeamento for uma classe não pertencente ao CMDB com uma referência a uma classe do CMDB, você deve selecionar a classe do CMDB com a qual associar a classe de destino não pertencente ao CMDB. Uma classe não pertencente ao CMDB se refere a uma classe, como Número de série [cmdb_serial_number], que não estende a classe Item de configuração [cmdb_ci]. A classe Entrada relacionada [cmdb_related_entry] pode conter várias associações de classe do CMDB para a mesma classe não pertencente ao CMDB. Portanto, selecione a associação apropriada para permitir que os processos de IRE atualizem a classe de destino não pertencente ao CMDB.

    Por exemplo, a classe de entrada relacionada [cmdb_related_entry] tem um registro que associa a classe não pertencente ao CMDB Instância de software [cmdb_software_instance] com a classe do CMDB Pacote de software [cmdb_ci_spkg]. Se você selecionar a Instância de Software como uma classe de destino, deverá associar a classe de Instância de Software à classe Pacote de Software [cmdb_ci_spkg].

    Desativando mapeamentos de classe

    Ao editar um mapa de transformação de ETL, fornecido por um Conector do Service Graph, por exemplo, você pode excluir um mapeamento de classe a fim de impedir que a classe seja preenchida quando a integração for executada. No entanto, se posteriormente você decidir preencher essa classe, deverá lê-la e reconfigurar todos os mapeamentos de classe. Em vez disso, você pode desativar um mapeamento de classe para ignorar temporariamente a classe durante a execução de integração, preservando toda a configuração de mapeamento dela. A classe que você opta por desativar fica esmaecida na interface do usuário, mas você pode continuar e editar os mapeamentos de classe dela. Posteriormente, você pode reativar um mapeamento de classe para habilitar o preenchimento da classe, sem precisar reconfigurar os mapeamentos de classe.

    Algumas classes que você opta por desativar acionam uma desativação automática de classes adicionais que você não optou por desativar diretamente. Quais classes são desativadas automaticamente, depende da classe que você escolheu desativar. Por exemplo, se a classe tem relacionamentos dependentes ou classes associadas. São classes desativadas automaticamente:
    • Aparecem em cinza claro na interface do usuário e não podem ser reativadas.
    • São reativadas automaticamente quando você reativa:
      • A classe que você desativou inicialmente e que desencadeou a desativação automática
      • Qualquer classe da qual a classe desativada dependa

    Todas as classes para as quais você desativa diretamente os mapeamentos e os mapeamentos de classe resultantes que são desativados automaticamente não são preenchidos quando a integração é executada. Além disso, todos os relacionamentos e tabelas de pesquisa associados a essas classes não são preenchidos quando a integração é executada.

    Mapeamento de classe e outros cenários de desativação:
    • Desative uma classe da qual nenhuma classe depende e que não tenha classes associadas:

      Aciona a desativação automática de quaisquer regras de pesquisa e relacionamentos associados à classe desativada.

    • Desative uma regra de pesquisa, como número de série, em um mapeamento de classe:

      Não desencadeia nenhuma desativação automática.

    • Desative uma classe do CMDB que está associada a uma classe não pertencente ao CMDB:
      • Desencadeia uma desativação automática da classe associada não pertencente ao CMDB.
      • A desativação da classe não pertencente ao CMDB não afeta a classe associada do CMDB.
    • Desativar uma classe com relacionamentos dependentes (aplica-se somente se o relacionamento dependente existir no IntegrationHub ETL):
      • Desencadeia a desativação automática de quaisquer classes que tenham um só relacionamento dependente da classe desativada.
      • Se uma classe tiver vários relacionamentos dependentes, ela será desativada automaticamente somente quando você desativar todas as classes dependentes.

        Por exemplo, um cenário em que a classe Sistema de Arquivos tem relacionamentos dependentes com as classes Computador e Servidor. Se você desativar a classe Computador, a classe Sistema de Arquivos não será desativada automaticamente. Somente se você desativar também a classe Servidor, a classe Sistema de Arquivos será desativada automaticamente.

    • Desative uma classe condicional ou um mapeamento de classe em uma classe condicional:
      • Desativar ou ativar uma classe condicional aciona uma desativação ou ativação automática de todos os mapeamentos da classe condicional.
      • Desativar um mapeamento de classe em uma classe condicional: evita que a classe desativada seja preenchida durante as execuções de integração. No entanto, as próprias condições associadas "If", "Else if" ou "Else" permanecem em vigor dentro da condição da classe condicional. Por exemplo, se você desativar o seguinte mapeamento de classe:

        [If] [operating_system] [contains] [Linux] Then [Class] [is] [Linux Server].

        Em seguida, a classe Servidor Linux não é preenchida, mas a condição [If] [operating_system] [contains] [Linux] é atendida

    Mapear colunas de dados para classes e atributos do CMDB

    Escolha classes e atributos de destino no CMDB para as quais mapear as colunas de dados de origem. Você pode mapear uma coluna de dados para uma classe de destino específica ou adicionar condições para que a escolha da classe de destino dependa de valores de dados específicos.

    Antes de Iniciar

    Função exigida: cmdb_inst_admin

    Por Que e Quando Desempenhar Esta Tarefa

    As colunas de dados que você mapeia podem ser colunas de dados de origem que não foram transformadas ou colunas de dados transformadas. Por exemplo, para integrar uma coluna de dados nas classes Pacote de Software e Computador, selecione essas classes como classes de destino e mapeie as colunas de dados em atributos específicos dessas classes.

    Quando você configura o mapeamento para uma classe, relacionamento ou regra de pesquisa, esses itens são sempre definidos inicialmente como ativados. Para obter detalhes sobre os resultados da desativação de mapeamentos, confira Como desativar mapeamentos de classe.

    Nota:
    Alterar uma classe afeta todos os mapeamentos que já foram configurados para a classe, às vezes excluindo esses mapeamentos. Detalhes sobre os mapeamentos afetados e o impacto aparecem na caixa de diálogo Mapeamentos afetados antes de prosseguir com a mudança de classe. No entanto, esses detalhes aparecem somente quando a mudança é de uma classe do CMDB para outra classe do CMDB ou de uma classe não pertencente ao CMDB para outra classe não pertencente ao CMDB.

    Procedimento

    1. Navegar até Tudo > Configuração > IntegrationHub ETLe clique no Nome de uma integração.
      A página inicial do IntegrationHub ETL lista todas as integrações que existem no sistema, incluindo integrações que foram baixadas de ServiceNow Store.
    2. Na página do Assistente do mapa de transformação de ETL, na seção Mapear dados para CMDB e Adicionar relacionamentos da configuração orientada, selecione Selecionar classes do CMDB para mapear dados de origem.
      Atributos que são configurados conforme necessário na plataforma são anotados e você deve mapear uma coluna de dados para cada um desses atributos.
    3. Clique em Adicionar Classe para adicionar uma classe de destino à qual mapear, ou clique em Editar Classe para editar uma classe.
      1. Na caixa de diálogo Adicionar classe, selecione uma classe do CMDB.
      2. Clique em Salvar.
      3. Opcional: Defina o botão de alternância Ativar/Desativar Mapeamento da classe como ativado ou desativado. Se a caixa de diálogo Mapeamentos da classe afetada for exibida, revise a lista de classes afetadas e clique em Prosseguir.
        Quando você adiciona uma classe não pertencente ao CMDB, ela é desativada inicialmente e o botão de alternância Ativar/Desativar Mapeamento é desabilitado, até que você adicione uma classe associada que esteja ativa.
    4. Clique em Adicionar classe condicional e, na caixa de diálogo Adicionar classe condicional, especifique as condições que devem ser atendidas para que os dados sejam mapeados para diferentes classes de destino.
      1. A coleta é definida automaticamente como a ramificação de dados na hierarquia que está associada ao atributo de nível mais baixo. Você pode modificar o valor da ramificação de dados da qual deseja mapear os dados, que deve estar em um nível superior na mesma ramificação de dados da hierarquia.
      2. Na lista suspensa If, selecione as condições de atributo que os valores de dados devem atender ou insira plug-ins na caixa de pesquisa e especifique uma condição de plug-in. Em seguida, você pode especificar que o restante dos registros, que não corresponderam a nenhuma condição, sejam mapeados para uma classe de destino diferente. Os registros de dados serão mapeados para diferentes classes de destino de acordo com as condições atendidas.

        Ao processar dados aninhados, um prefixo denota o primeiro nível na hierarquia aninhada para itens de atributo.

        Nota:
        Quando você seleciona uma classe não pertencente ao CMDB, ela é desativada inicialmente e o botão de alternância Ativar/Desativar Mapeamento é desabilitado, até que você adicione uma classe associada que esteja ativa.
      3. Clique em Salvar.
      4. Opcional: Defina o botão de alternância Ativar/Desativar Mapeamento da classe como ativado ou desativado. Se a caixa de diálogo Mapeamentos da classe afetada for exibida, revise a lista de classes afetadas e clique em Prosseguir.
      5. Opcional: Clique em Editar classe para editar as configurações de uma classe condicional. Na caixa de diálogo Editar classe condicional, defina o botão de alternância Ativar/Desativar Mapeamento do mapeamento de classe como ativado ou desativado. Clique em Salvar, e se a caixa de diálogo Mapeamentos de classes afetadas for exibida, revise a lista de classes afetadas e clique em Prosseguir.
        • Uma classe desativada não é preenchida durante as execuções de integração. No entanto, isso não afeta a condição associada. As próprias condições associadas "If", "Else if" ou "Else" permanecem em vigor dentro da condição da classe condicional e os ICs correspondentes são filtrados conforme necessário.
        • O botão de alternância da classe condicional reflete o resumo dos estados de todos os mapeamentos da classe condicional. Se pelo menos um dos mapeamentos da classe condicional estiver ativado, o botão de alternância da classe condicional aparecerá como ativado. Caso contrário, o comutador de alternância da classe condicional aparecerá como desativado.
    5. Para uma classe não pertencente ao CMDB, clique em Adicionar Classe Associada para associar a classe não pertencente ao CMDB a uma classe do CMDB e habilitar o botão de alternância Ativar / Desativar Mapeamento. Ou clique em Editar classe associada para editar uma classe já associada.
      1. Na caixa de diálogo Adicionar classe associada, selecione uma classe do CMDB. A lista inclui todas as entradas da classe Entrada relacionada [cmdb_related_entry] para a tabela não pertencente ao CMDB especificada (classes desativadas não são incluídas).
      2. Clique em Adicionar.
      3. Opcional: Defina o botão de alternância Ativar/Desativar Mapeamento da classe associada como ativado ou desativado.
        Nota:
        Se uma classe associada não tiver sido adicionada ou estiver desativada, o botão de alternância Ativar/Desativar Mapeamento será desabilitado.
    6. Clique em Configurar mapeamento para configurar o mapeamento para uma classe recém-adicionada ou clique em Editar mapeamento para editar um mapeamento existente.
      1. Para mapear, arraste as colunas de dados da barra lateral de Dados à direita para o atributo de destino do CMDB, do lado esquerdo da página de mapeamento. Ou clique no ícone Selecionar uma coluna no IntegrationHub ETL. para pesquisar e selecionar colunas de dados para o mapeamento.
        Ao mapear dados aninhados:
        • As colunas de dados da barra lateral de dados aparecem em um formato de árvore que representa a estrutura dos dados aninhados. Cada atributo está associado a dados de amostra para o atributo.
        • As colunas transformadas são marcadas por um ponto sombreado em ciano.
        • Todos os mapeamentos para uma classe do CMDB específica devem ser da mesma ramificação de origem nos dados aninhados. Somente a ramificação da qual você selecionou a primeira coluna a ser mapeada é válida para selecionar colunas em mapeamentos subsequentes.

          Esta restrição se aplica de maneira diferente ao mapear para atributos em tabelas de pesquisa. Todos os mapeamentos para atributos em uma tabela de pesquisa também devem ser da mesma ramificação de origem. No entanto, essa ramificação de origem pode ser diferente da ramificação de origem usada com tabelas que não são de pesquisa.

          Nota:
          Você pode contornar essa restrição usando a transformação Copiar na etapa de preparação de dados, para copiar atributos de um nível primário para um nível secundário. Prepare os dados para que todos os atributos que você deseja mapear estejam no mesmo nível.
        • Quando você arrasta uma coluna para mapear da barra lateral de Dados, os campos de atributos de destino do CMDB que são válidos para o mapeamento são realçados por um quadro verde. Se você tentar descartar uma coluna em um atributo de destino inválido, o campo respectivo será realçado por uma moldura vermelha e um erro será exibido.
      2. Clique em Adicionar atributo. Em seguida, na caixa de diálogo Adicionar Atributo, na lista Atributo, selecione um ou mais itens como atributos de destino em que os dados serão mapeados. Você também pode rolar a tela para baixo até a seção Configurações de IRE da lista e selecionar uma das propriedades robustas do transformador do conjunto de importações . Clique em Salvar.
        Para obter informações sobre a ordem de precedência entre as propriedades robustas do transformador do conjunto de importações definidas no nível de item individual e no nível de carga útil do IRE, consulte propriedades robustas do transformador do conjunto de importações.
      3. Mapeie todas as regras de pesquisa, como a regra "Pesquisa por número de série 1".

        As regras de pesquisa ficam em um estado desativado até que você as mapeie. Clique no ícone de filtro da regra de pesquisa para editar ou adicionar filtros de pesquisa. Na caixa de diálogo do filtro de pesquisa, especifique as condições de atributo ou plug-in que devem ser atendidas para que os dados sejam mapeados para várias classes de destino. Em seguida, clique em Salvar.

        Depois de mapear um campo de uma regra de pesquisa, você pode definir o botão de alternância de ativação/desativação da regra de pesquisa para ativado ou desativado.

      4. Opcional: Clique em Exibir detalhes da classe para ver a classe atual em Gerenciador de classe de IC.
      5. Opcional: Clique na guia Transformar dados para navegar até a página de preparação de dados onde você pode revisar e transformar ainda mais os dados que deseja mapear.
      6. Retorne à página Selecionar classes do CMDB para mapear dados de origem.
    7. Clique em Marcar como concluído.

    Adicionar relacionamento

    Adicione relacionamentos que existem entre as classes do CMDB de destino, para uma integração.

    Antes de Iniciar

    • Uma classe que você deseja adicionar ao relacionamento deve estar em um estado ativado.
    • Um relacionamento de base ou um relacionamento condicional, que você deseja editar, devem estar em um estado ativado.
    • Em um relacionamento condicional que você deseja editar, pelo menos uma condição do relacionamento precisa estar em um estado ativado. Caso contrário, o botão Editar Relacionamento ficará esmaecido.

    Função exigida: cmdb_inst_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Ao criar relacionamentos com dados aninhados, você não pode criar um relacionamento entre objetos irmãos dos dados aninhados. Usando a carga de amostra para dados aninhados como exemplo, não é possível criar um relacionamento entre interfaces e software.

    Visibilidade do ITOM, se disponível, usa padrões de descoberta aprimorados para identificar e adicionar relacionamentos de IC à tabela Relacionamentos sugeridos no sistema de base. Quando aplicável, use a tabela Relacionamentos sugeridos para selecionar relacionamentos que estejam em conformidade com os padrões Common Service Data Model (CSDM).

    Procedimento

    1. Navegar até Tudo > Configuração > IntegrationHub ETLe clique no Nome de uma integração.
      A página inicial do IntegrationHub ETL lista todas as integrações que existem no sistema, incluindo integrações que foram baixadas de ServiceNow Store.
    2. Na página do Assistente do mapa de transformação de ETL, na seção Mapear dados para CMDB e Adicionar relacionamentos da configuração orientada, selecione Adicionar relacionamentos.
    3. Para adicionar relacionamentos, selecione Adicionar relacionamento ou Adicionar relacionamento condicional se quiser especificar condições de atributo que devem ser atendidas antes de adicionar um relacionamento. Em seguida, conclua as ações a seguir, conforme necessário.
      OpçãoDescrição
      Adicionar relacionamento
      1. Selecione os valores Primário, Secundário e Tipo de Relacionamento.
      2. Clique em Adicionar.
      Adicionar relacionamento condicional
      1. Na lista Escolher campo, selecione as condições de atributo que os valores de dados devem atender.
      2. Selecione os valores Primário, Secundário e Tipo de Relacionamento.
      3. Clique em Salvar.

      Ao processar dados aninhados, um prefixo denota o primeiro nível na hierarquia aninhada para itens de atributo.

      O menu da lista Tipo de relacionamento muda com base na classe primária e secundária selecionadas:
      • Se houver um relacionamento dependente, a lista será desabilitada e o tipo de relacionamento será preenchido automaticamente.
      • Se houver mais de um relacionamento dependente, a lista exibirá as opções de relacionamento de contenção e hospedagem e o tipo de relacionamento de contenção será preenchido automaticamente.
      • Se não houver nenhum relacionamento dependente, a lista exibirá os relacionamentos sugeridos com o primeiro relacionamento sugerido selecionado automaticamente, seguido pelos tipos de relacionamento do sistema de base.
      • Se não houver nenhum relacionamento sugerido, a lista exibirá os relacionamentos não sugeridos, seguidos pelos tipos de relacionamento do sistema de base.
    4. Clique em Salvar para salvar as alterações atuais ou em Marcar como concluído.

      Um carimbo de data/hora aparece no cabeçalho quando você clica em Salvar, e permanece durante a sessão do IntegrationHub ETL para o mapa de transformação de ETL. Quando você entra novamente na sessão ou alterna entre mapas de ETL, o carimbo de data/hora desaparece.

    Visualizar resultados do mapeamento

    Visualize os resultados da integração de dados de exemplo.

    Antes de Iniciar

    Função exigida: cmdb_inst_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Execute um teste de integração e exiba um resumo dos resultados para os dados de amostra (por padrão, até 100 registros). O resumo inclui números totais de relacionamentos que foram criados, classes mapeadas, cargas parciais e incompletas que o IRE não pôde processar. Você também pode exibir mensagens detalhadas do Mecanismo de transformação robusta (RTE) e do Mecanismo de reconciliação de identificação (IRE).
    Nota:
    A maioria das mensagens de log do IntegrationHub ETL (de RTE e IRE) são informativas. No entanto, mesmo se as propriedades do sistema com.glide.import_set.importlog_level e glide.importlog.log_to_table estiverem definidas para não adicionar mensagens de log INFO, o IntegrationHub ETL renderizará as mensagens do log de INFO. Para obter mais detalhes sobre essas propriedades, consulte Propriedades de import sets.

    Depois de exibir os detalhes na página de resumo, você pode retornar a qualquer etapa para fazer ajustes e executar novamente a integração.

    Procedimento

    1. Navegar até Tudo > Configuração > IntegrationHub ETLe clique no Nome de uma integração.
      A página inicial do IntegrationHub ETL lista todas as integrações que existem no sistema, incluindo integrações que foram baixadas de ServiceNow Store.
    2. Na página do Assistente de mapa de transformação de ETL, na seção Visualizar resultados de integração de amostra e Programar importação da configuração orientada, selecione Testar e reverter os resultados da integração.
    3. Na página Resultados de integração de teste e reversão, clique em Executar integração.
    4. Exiba a página de resumo e clique nas várias guias para ver os resultados da execução de integração para as classes do CMDB afetadas. Você pode clicar no ícone de visualização para abrir formulários de IC e exibir as informações.
      Nota:
      A ordem das colunas de atributo segue a lista de colunas padrão da classe na plataforma. Primeiro, as colunas padrão da classe aparecem da esquerda para a direita, seguidas pelo restante das colunas de atributo organizadas em ordem alfabética. Por exemplo, para ver a lista de colunas padrão da classe Computadores, navegue até Tudo > Configuração > Computadores.
    5. Opcional: Selecione qualquer guia de classe e clique em Editar mapeamento para retornar à página Selecionar classes do CMDB para mapear dados de origem, onde você pode revisar e alterar as configurações de mapeamento.
      Nota:
      Clicar em Editar Mapeamento reverte todas as mudanças que foram feitas no CMDB como resultado desta execução de integração.
    6. Opcional: Clique na guia Relacionamentos e revise todos os relacionamentos que foram criados. Clique em Editar Relacionamentos para retornar à página Adicionar Relacionamentos, onde você pode revisar e alterar qualquer configuração de relacionamento.
      Nota:
      Clicar em Editar Mapeamentos reverte todas as mudanças que foram feitas no CMDB como resultado desta execução de integração.
    7. Clique nas guias Log de erros, Log de atividades ou Log de aviso para ver os respectivos detalhes registrados pelo IRE e RTE durante a integração.

      Os registros de log do IRE são agrupados por categorias e organizados pela respectiva classe. Para mensagens de log IRE, a coluna Mensagem contém somente as próprias mensagens que foram extraídas da mensagem de log bruta. A coluna Mensagem de log contém a mensagem de log completa, que inclui classe e categoria, além da própria mensagem em si. Os logs de RTE aparecem na categoria Outros.

      Use o botão de alternância Detalhamento para mudar o modo de exibição das colunas Mensagem e Mensagem de log:
      • Detalhamento ativado: mostra o texto completo expandido das mensagens de log.
      • Detalhamento desativado: mostra uma versão resumida das mensagens de log. O texto completo expandido das mensagens de log aparece quando você aponta para uma mensagem.
    8. Clique nas guias Cargas incompletas e Cargas parciais para obter detalhes sobre cargas de IRE para a execução de integração.
    9. Selecione Marcar como concluído. A caixa de diálogo Opções de reversão é exibida e você pode escolher qualquer uma das opções a seguir.
      • Reter dados: todas as mudanças do CMDB resultantes desta integração são retidas.
      • Executar reversão: todas as mudanças do CMDB resultantes desta integração são revertidas e o CMDB é restaurado ao seu estado de antes da execução da integração.

    Fornecer programação da integração

    Configure uma programação para importar dados ao CMDB usando este mapa de transformação de ETL.

    Antes de Iniciar

    Função exigida: cmdb_inst_admin

    Procedimento

    1. Navegar até Tudo > Configuração > IntegrationHub ETLe clique no Nome de uma integração.
      A página inicial do IntegrationHub ETL lista todas as integrações que existem no sistema, incluindo integrações que foram baixadas de ServiceNow Store.
    2. Na página do Assistente do mapa de transformação de ETL, na seção Visualizar resultados de integração de amostra e Programar importação da configuração orientada, selecione Definir programação de importação.
    3. Na página Fornecer Programação, clique em Definir Programações.
    4. Na exibição de lista de Importações de dados programadas (que é aberta em uma nova guia), clique em Novo.
    5. Preencha o formulário de Importação programada de dados e clique em Enviar.
      Consulte Programar uma importação de dados para obter detalhes sobre os campos de formulário.
    6. Clique em Marcar como concluído.

    Tipos de transformação no IntegrationHub ETL

    Use várias transformações no IntegrationHub ETL para converter e preparar dados de origem para mapeamento para o CMDB.

    As transformações da a aplicação da Store Integration Commons for CMDB também estão disponíveis no IntegrationHub ETL.

    Concatenação

    Combina os valores dos campos de entrada em uma só cadeia de caracteres, juntando-os no campo opcional joining_string.

    Detalhes
    Tabela sys_rte_eb_concat_operation
    Campos de entrada source_sys_rte_eb_fields
    Campo de saída target_sys_rte_eb_field
    Campos adicionais joining_string (opcional)
    Exemplo
    Entrada “input_1”, “input_2”, “input_3”
    Campos adicionais joining_string = ”, ”
    Resultado “input_1, input_2, input_3”

    Converter para booliano

    Converte o valor de entrada para um booliano. Os valores "true" e "1" são convertidos para "true" (sem distinção entre maiúsculas e minúsculas) e qualquer outro valor é convertido para "false".

    Detalhes
    Tabela sys_rte_eb_to_boolean_operation
    Campos de entrada source_sys_rte_eb_field
    Campo de saída target_sys_rte_eb_field
    Exemplos:
    • Todas as entradas a seguir retornam "true":
      • verdadeiro
      • 1
    • Todas as entradas a seguir retornam "false":
      • “Input_1”
      • “”
      • 0
      • 11

    Converter em Data

    Tenta converter o valor de entrada em um valor GlideDateTime aplicando o date_format ao valor de entrada. Tenta converter diretamente usando GlideDateTime se date_format estiver incorreto.

    Detalhes
    Tabela sys_rte_eb_to_date_operation
    Campos de entrada source_sys_rte_eb_field
    Campo de saída target_sys_rte_eb_field

    Retorna um valor vazio se não for possível analisar.

    Campos adicionais date_format (Formato de data simples do Java)
    Exemplo
    Entrada "2018/09/20 11:21:00 a.m. EST”
    Campos adicionais date_format = “aaaa-MM-dd hh:mm:ss a z”
    Resultado “2018-09-20 16:21:00”
    Exemplo
    Entrada "2018/09/20 01:21:00 PM EST”
    Campos adicionais date_format = “aaaa-MM-dd hh:mm:ss a z”
    Resultado “2018-09-20 18:21:00”
    Exemplo
    Entrada "09/20/18”
    Campos adicionais date_format = “aaaa-MM-dd hh:mm:ss a z”
    Resultado “0018-09-20 00:00:00”

    Converter em Numérico

    Converte o valor de entrada em um número.

    Detalhes
    Tabela sys_rte_eb_to_numeric_operation
    Campos de entrada source_sys_rte_eb_field
    Campo de saída target_sys_rte_eb_field

    Se o valor de entrada não for numérico, a saída estará vazia.

    Exemplo
    Entrada 1.23
    Resultado 1.23
    Exemplo
    Entrada 1.00
    Resultado 1
    Exemplo
    Entrada input_1
    Resultado nulo
    Exemplo
    Entrada dois
    Resultado nulo

    Cópia

    Copia o valor do campo de origem para todos os campos de destino.

    Detalhes
    Tabela sys_rte_eb_copy_operation
    Campos de entrada source_sys_rte_eb_field
    Campo de saída target_sys_rte_eb_fields
    Campos adicionais overwrite_existing_value (opcional, booliano): se true, os valores dos campos de destino serão substituídos. Caso contrário, qualquer valor não vazio não será substituído.

    Extrair numérico inicial

    Define o campo de destino como o primeiro valor numérico encontrado no campo de origem.

    Detalhes
    Tabela sys_rte_eb_extract_numeric_operation
    Campos de entrada source_sys_rte_eb_field
    Campo de saída target_sys_rte_eb_field
    Campos adicionais
    • decimal_places (opcional, número): força a saída a ter um número especificado de casas decimais.
    • remainder_target_field (opcional, referência a um campo): definido como o restante aparado do campo de origem, após remover o primeiro valor numérico.
    Exemplo
    Entrada “100 mb”
    Resultado "100”
    Exemplo
    Entrada “100.123 mb”
    Resultado “100.123"
    Exemplo
    Entrada “100.123 mb”
    Campos adicionais decimal_places = 2
    Resultado “100.12”
    Exemplo
    Entrada “100 mb”
    Campos adicionais decimal_places = 2
    Resultado “100.00”
    Exemplo
    Entrada “100 mb”
    Campos adicionais remainder_target_field = <field>
    Resultado “100” e <field> = “mb”

    Pesquisa do glide

    Executa uma pesquisa no banco de dados em target_table.

    Detalhes
    Tabela sys_rte_eb_glide_lookup_operation
    Campos de entrada source_sys_rte_eb_fields
    Campo de saída target_sys_rte_eb_fields
    Campos adicionais
    • target_table
    • glide_matching_fields (cadeia de caracteres): lista separada por vírgulas de nomes de coluna na tabela de destino. Para cada campo de entrada em source_sys_rte_eb_fields, deve haver um número igual de valores em glide_matching_fields
    • glide_target_fields (cadeia de caracteres): lista separada por vírgulas de nomes de coluna na tabela de destino. Para cada campo de destino em target_sys_rte_eb_fields, deve haver um número igual de valores em glide_target_fields.
    Exemplo
    Entrada
    • Campo de entrada 1:100 South Charles Street, Baltimore
    • Campo de entrada 2: MD
    Campos adicionais
    • Tabela de destino: local (cmn_location)
    • Campos correspondentes ao Glide: street, state
    • Campos de destino do Glide: sys_id
    Resultado Campo de saída 1: 25ab9c4d0a0a0bb300f7dabdc0ca7c1c

    Mínimo/Máximo

    Define o campo de destino como o máximo ou mínimo dos valores de todos os campos de entrada.

    Detalhes
    Tabela sys_rte_eb_min_max_operation
    Campos de entrada source_sys_rte_eb_fields
    Campo de saída target_sys_rte_eb_field
    Campos adicionais
    • data_type (lista de seleção <STRING,NUMERIC,DATE>)
    • min_max (lista de seleção <MIN,MAX> )
    Exemplo
    Entrada “2”, “-1”, “0”
    Campos adicionais
    • data_type = NUMERIC
    • min_max = MAX
    Resultado “2”
    Exemplo
    Entrada “a”, “b”
    Campos adicionais
    • data_type = STRING
    • min_max = MAX
    Resultado “b”
    Exemplo
    Entrada “2”, “-1”, “0”
    Campos adicionais
    • data_type = NUMERIC
    • min_max = MIN
    Resultado “-1”
    Exemplo
    Entrada “a”, “b”
    Campos adicionais
    • data_type = STRING
    • min_max = MIN
    Resultado “a”

    Script de Entrada Múltipla

    Executa um script com várias entradas, definindo a saída target_field == para esse script.

    Cada campo de origem está disponível dentro da variável "lote" como campos do JavaScript. O nome do campo JavaScript é o atributo do campo da entidade (observando sys_rte_eb_field.field, não sys_rte_eb_field.name).

    Detalhes
    Tabela sys_rte_eb_multi_in_script_operation
    Campos de entrada source_sys_rte_eb_fields
    Campo de saída target_sys_rte_eb_field
    Campos adicionais
    • script (script)
    • use_unique_input_sets (booliano): quando true, somente valores de entrada exclusivos são incluídos no lote de dados para processamento de IRE. Caso contrário, todos os valores de campo do objeto de entrada serão incluídos.
    Exemplo para usar use_unique_input_sets, com uma função de script que usa record_type e operating_system como entrada e retorna record_with_os:
    Tabela 2. Dados de entrada
    Registro record_type operating_system record_with_os
    1 computador Windows XP
    2 computador Linux
    3 computador Windows XP
    Se use_unique_inputs_sets estiver definido como true, o script processará apenas dois valores (computador + Windows XP e computador + Linux). Se use_unique_inputs_sets estiver definido como false, cada um dos três valores será processado individualmente (computador + Windows XP, computador + Linux e computador + Windows XP).
    Script de exemplo:
                (function(batch, output) { 
                    for (var i = 0; i < batch.length; i++) { 
                            // batch[i] is the unique set of inputs/individual record 
                            // batch[i].<field> gives access to the field value 
                            var in0 = gs.nil(batch[i].record_type) ? '' : batch[i].record_type;
                            var in1 = gs.nil(batch[i].operating_system) ? '' : batch[i].operating_system;
                            // output[i] is the output for the specific combination of inputs/individual record 
                            output[i] = in0 + "_" + in1; 
                        } 
                    } 
                })(batch, output);
    Script de exemplo:
                /* Example Script
                 // In this example the script input fields are 'input_field_1', 'input_field_2' - replace these with the fields used as script inputs // There is a static field 'input' that has all the input field values concatenated with a '|' (function(batch, output) {
                     for (var i = 0; i < batch.length; i++) {
               
                         //step1: access the input variables
                         var a = batch[i].input_field_1; //Value of the first source field.
                         var b = batch[i].input_field_2; //Value of the second source field.
                 
                         //step2: Your script/code goes here.
                         var c = a + b;
               
                         //step3: set the output for each elements
                         output[i] = b;
                     }
               
                 })(batch, output);
                */

    Substituir regex

    Substitui cada substring da cadeia de caracteres de entrada que corresponde ao match_regex especificado, com o valor da cadeia de caracteres replacement_regex especificado.

    Detalhes
    Tabela sys_rte_eb_regex_replace_operation
    Campos de entrada source_sys_rte_eb_field
    Campo de saída target_sys_rte_eb_field
    Campos adicionais
    • match_regex (string, expressão regular)
    • replacement_regex (string)
    Exemplo
    Entrada “String&With(Special)$Characters”
    Campos adicionais
    • match_regex = “[^0-9a-zA-Z]+”
    • replacement_regex = “ ”
    Resultado “Cadeia de caracteres com caracteres especiais”

    Substituir

    Substitui cada substring da cadeia de caracteres de entrada que corresponda a match_string especificado, com o valor da cadeia de caracteres replacement_string especificado.

    Detalhes
    Tabela sys_rte_eb_replace_operation
    Campos de entrada source_sys_rte_eb_field
    Campo de saída target_sys_rte_eb_field
    Campos adicionais
    • match_string (string)
    • replacement_string (string)
    Exemplo
    Entrada “Cadeia de caractere original”
    Campos adicionais
    • match_string = “Original”
    • replacement_string = “Replacement”
    Resultado “Cadeia de caracteres de substiruição”

    Arredondar Numérico

    Arredonda o valor do número para o número inteiro mais próximo. Itens não numéricos são sendo truncados.

    Detalhes
    Tabela sys_rte_eb_round_numeric_operation
    Campos de entrada source_sys_rte_eb_field
    Campo de saída target_sys_rte_eb_field
    Exemplo
    Entrada “1.5”
    Resultado "2"
    Exemplo
    Entrada “1.4”
    Resultado "1"
    Exemplo
    Entrada "Sou uma cadeia de caracteres"
    Resultado ""

    Script

    Execute um script com entrada, definindo target_field == saíde desse script.

    Esta transformação foi substituída pela transformação Script de várias entrada e está incluída para compatibilidade raeversa com as configurações existentes.

    Detalhes
    Tabela sys_rte_eb_script_operation
    Campos de entrada source_sys_rte_eb_field
    Campo de saída target_sys_rte_eb_field
    Campos adicionais
    • script (script)
    • use_unique_input_sets (booliano): quando true, somente valores de entrada exclusivos são incluídos no lote de dados para processamento de IRE. Caso contrário, todos os valores de campo do objeto de entrada serão incluídos. Para obter um exemplo e mais detalhes, consulte a transformação Script de várias entrada.
    O campo de origem está incluído na variável "lote" como a "entrada" do campo JavaScript.
              (function(batch, output) { 
                    for (var i = 0; i < batch.length; i++) { 
                            // batch[i] is the unique set of inputs/individual record 
                            // batch[i].input gives access to the field value 
                            var in0 = gs.nil(batch[i].input) ? '' : batch[i].input; 
                            // output[i] is the output for the specific combination of inputs/individual record 
                            output[i] = in0 + " modified by script”; 
                        } 
                    } 
                })(batch, output); 
    Exemplo:
    /* Example Script
     (function(batch, output) {
         for (var i = 0; i < batch.length; i++) {
             //step1: access the input variables
             var a = batch[i].input; //Value of the source field.
     
             //step2: Your script/code goes here.
             var b = a + 1;
             //step3: set the output for each elements
             output[i] = b;
         }
     })(batch, output);
    */ 

    Conjunto

    Define o valor do campo de destino para a cadeia de caracteres especificada em set_value.

    Detalhes
    Tabela sys_rte_eb_set_operation
    Campos de entrada source_sys_rte_eb_field
    Campo de saída target_sys_rte_eb_field
    Campos adicionais
    • set_value (string)
    • overwrite_existing_value (opcional, booliano): quando true, o valor atual do campo de destino é substituído. Caso contrário, um valor não vazio não será substituído.

    Divisão

    Divide o valor do campo de origem em splitting_string e atribui cada item resultante da divisão a target_sys_rte_eb_fields, em ordem.

    Detalhes
    Tabela sys_rte_eb_split_operation
    Campos de entrada source_sys_rte_eb_field
    Campo de saída target_sys_rte_eb_fields
    Campos adicionais splitting_string (string)
    Exemplo
    Entrada “value1||value2||value3”, com target_sys_rte_eb_fields {target1,target2,target3}
    Campos adicionais splitting_string = ”||”
    Resultado target1 : value1, target2 : value2, target3 : value3
    Exemplo
    Entrada “value1||value2||value3”, com target_sys_rte_eb_fields {target1}
    Campos adicionais splitting_string = ”||”
    Resultado target1 : value1
    Exemplo
    Entrada “value1”, com target_sys_rte_eb_fields {target1,target2,target3}
    Campos adicionais splitting_string = ”||”
    Resultado target1 : value1, target2 : <null>, target3 : <null>

    Corte

    Corta os espaços em branco à esquerda e à direita do valor source_sys_rte_eb_field e atribui o resultado a target_sys_rte_eb_field. Esta transformação é equivalente ao String.trim() do Java.

    Detalhes
    Tabela sys_rte_eb_trim_operation
    Campos de entrada source_sys_rte_eb_field
    Campo de saída target_sys_rte_eb_field
    Exemplo
    Entrada “ value 1 ”
    Resultado “value 1”

    Maiúsculo

    Coloca o valor source_sys_rte_eb_field em maiúsculas e atribui o resultado a target_sys_rte_eb_field.

    Detalhes
    Tabela sys_rte_eb_upper_case_operation
    Campos de entrada source_sys_rte_eb_field
    Campo de saída target_sys_rte_eb_field
    Exemplo
    Entrada “value1”
    Resultado “VALUE1”

    Corte em Maiúsculas

    Combina as transformações de maiúsculas e de corte.

    Detalhes
    Tabela sys_rte_eb_upper_case_trim_operation
    Campos de entrada source_sys_rte_eb_field
    Campo de saída target_sys_rte_eb_field
    Exemplo
    Entrada “ value1 ”
    Resultado “VALUE1”