Adicionar um mapeamento de campo personalizado na tabela de preparação para Service Graph

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 4 min. de leitura

    • Adicione um campo personalizado à tabela de preparação e mapeie o campo personalizado da tabela de preparação para o campo de IC por meio do Excel SGC.

    Antes de Iniciar

    Para configurar o layout do formulário, consulte Configuração do layout do formulário.

    Para criar um campo personalizado na tabela de preparação, consulte Adição e personalização de um campo em uma tabela.

    Funções necessárias:
    • admin - Pode fazer mudanças na inclusão de script, adicionar mapeamentos de classe ou campo e fazer mudanças no ETL.
    • cmdb_inst_admin — Só pode adicionar novos mapeamentos de classe ou campo e fazer mudanças no ETL.

    Procedimento

    1. Depois que uma coluna personalizada for criada na tabela de preparação, navegue até Todos > Administrador do espaço industrial > Gerente de OT > Importar dispositivos de OT - Tabela de preparação.
    2. Baixe o modelo do Excel.
      Para obter mais informações, consulte Baixar modelo do Excel.

      Se os registros estiverem presentes na tabela de preparação, você poderá editar o valor da coluna nos registros existentes.

    3. Prepare o modelo do Excel.
      Para obter mais informações, consulte Preparação da ferramenta de revisão de entrada da planilha de OT pré-importação para importação do Conector do Service Graph.
    4. Importe o modelo do Excel.
      Para obter mais informações, consulte Importação de modelo do Excel.
    5. Navegar até Todos > Administrador do espaço industrial > Gerente de OT > Importar dispositivos de OT - Inclusões de script e selecione a inclusão de script SGOTAssetImportExcelConstants.
    6. No script, atualize o novo nome da coluna da tabela de preparação e o novo nome da coluna do ETL dentro do objeto SGOTAssetImportExcelConstants.importSetColumnsVsStagingColumnsMap no formato "<ETL Column Name> ”: “<Column Name from staging table> ”.

      Neste exemplo, o “u_my_custom_field” antes dos dois pontos ( : ) indica o nome da coluna do ETL (mostrado como uma coluna na etapa de visualização do ETL) e o “u_my_custom_field” após os dois pontos indica o nome da coluna na tabela de preparação.

      Certifique-se de que haja uma vírgula (,) adicionada no final da linha acima da nova linha. Neste exemplo, uma vírgula é adicionada após a linha "custom_fields": "custom_fields".

      Nome da coluna do ETL atualizado para SGOTAssetImportExcelConstants.
    7. Selecione Atualizar para salvar suas mudanças.
    8. Navegar até Todos > Configuração > IntegrationHub ETL.
    9. Selecione a aplicação do CMDB: SG-OT Excel Import ETL.
    10. Se a página Dados de mapeamento inválidos detectados for exibida, selecione Fechar.
    11. No Assistente do mapa de transformação de ETL, na seção Especificar detalhes básicos da configuração assistida, selecione Importar dados de origem e fornecer detalhes básicos.
      Selecione a etapa 1: forneça informações básicas para o mapa de transformação de ETL.
    12. No campo Conjunto de importação de amostra, selecione Extrair automaticamente um novo conjunto de importação.
      No campo Conjunto de importação de amostra, selecione Extrair automaticamente um novo conjunto de importação.
    13. Selecione Salvar.
      A faixa de informações básicas salvas com sucesso é exibida.
    14. Selecione Marcar como concluído.
    15. Na página do Assistente do mapa de transformação de ETL, na seção Preparar dados de origem para mapeamento, selecione Visualizar e preparar dados.
      Visualizar e preparar dados.
      Se a coluna não estiver visível, repita as etapas 11 a 14.
    16. Selecione Marcar como concluído.
    17. Na página do Assistente de mapa de transformação de ETL, na seção Mapear dados para CMDB e Adicionar relacionamentos, selecione Classes de CMDB para mapear dados de origem.
    18. Mapeie a coluna para a classe e o atributo de destino.

      Por exemplo, o campo "comentários" está presente na classe Hardware cmdb_ci_hardware. Depois que este campo é mapeado, o campo "comentário" nas classes secundárias de hardware também é atualizado, desde que o valor da coluna "comentários" na tabela de preparação dessa linha não esteja vazio. Se você estiver adicionando um mapeamento para um novo campo que não está presente ou para um campo que não é específico para a classe Hardware cmdb_ci_hardware, mas sim um campo na classe Tecnologia operacional (cmdb_ci_ot), você deve adicionar o mapeamento de campo no esboço de Tecnologia operacional (OT) 1.

      1. Adicione um mapeamento de campo à classe Hardware 1.
      2. Para a classe Hardware 1, selecione Editar mapeamento.
        Selecionar classes do CMDB para mapear dados de origem
    19. Na caixa de diálogo Adicionar atributo que aparece, na lista Atributo, selecione Comentários.
      Mapear classe de hardware 1 - Caixa de diálogo Adicionar atributo.
    20. Selecione Salvar.
      Um novo campo chamado "Comentários" é exibido. Pode ser necessário rolar para ver o campo.
      Novo campo de comentários adicionado.
    21. No painel Dados, arraste a cápsula de dados para o campo Coluna de origem de comentários.
      Mapear para hardware.
      Você também pode selecionar o ícone da coluna de origem (ícone da coluna de origem ) para selecionar o campo de mapeamento de dados para ele.
      A coluna de origem inclui a cápsula de dados.
      Campo de coluna de origem preenchido com uma cápsula de dados.
    22. Navegue de volta para a seção Classes do CMDB para mapear dados de origem da seção Mapear dados para o CMDB e adicionar relacionamentos na página do Assistente do mapa de transformação do ETL.
      Navegue de volta para a página Classes do CMDB para mapear dados de origem.
    23. Selecione Marcar como concluído.
    24. Siga estas etapas para verificar os novos mapeamentos de campo.
      1. Navegue até a página inicial do Assistente do mapa de transformação de ETL.
      2. Na seção Visualizar amostra de resultados de integração e Programar importação da configuração assistida, selecione Testar e reverter resultados de integração.
        Assistente de mapa de transformação de ETL — Resultados de integração de teste e reversão.
      3. Selecione Executar integração.
      4. Depois que a execução for concluída com sucesso, confirme se o campo Comentários do IC para o qual você forneceu um valor de comentários está atualizado na tabela de preparação.
      5. Selecione Marcar como concluído.
        Depois que os Resultados de integração de teste e reversão forem executados com sucesso, confirme se a planilha do Excel está atualizada.
      6. Selecione Executar reversão.
        Selecione Executar reversão.
      7. Se o ETL não estiver ativado, selecione Ativar.
      O novo mapeamento de campo de coluna foi adicionado e verificado com sucesso.