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

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 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 Configure o layout do formulário .

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

    Funções necessárias:
    • administrador - Pode fazer mudanças na inclusão de script e adicionar mapeamentos de classe ou campo e fazer mudanças no ETL.
    • cmdb_inst_admin - Pode adicionar somente 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é Tudo > 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 Baixe o modelo do Excel .

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

    3. Prepare o modelo do Excel.
    4. Importe o modelo do Excel.
      Para obter mais informações, consulte Importar modelo do Excel .
    5. Navegar até Tudo > Administrador do espaço industrial > Gerente de OT > Importar dispositivos de OT - Inclusões de script e selecione SGOTAssetImportExcelConstants inclusão de script.
    6. No script, atualize o novo nome da coluna da tabela de preparação e o novo nome da coluna ETL dentro do SGOTAssetImportExcelConstants.importSetColumnsVsStagingColumnsMap Objeto no formato "Nome da coluna ETL": "Nome da coluna da tabela de preparação".

      Neste exemplo, "u_my_custom_field" antes dos dois pontos ( : ) indica o nome da coluna de ETL (mostrado como uma coluna na etapa de visualização de ETL), e "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 ao final da linha acima da nova linha. Neste exemplo, uma vírgula é adicionada após a linha "custom_fields": "Custom_fields".

      Nome da coluna ETL atualizado com SGOTAssetImportExcelConstants.
    7. Selecione Atualizar para salvar suas mudanças.
    8. Navegar até Tudo > Configuração > IntegrationHub ETL.
    9. Selecione Aplicação do CMDB: Importação do SG-OT Excel ETL.
    10. Se a página Dados de mapeamento inválidos detectados for exibida, selecione Fechar .
    11. No Assistente de mapa de transformação ETL, na seção Especificar detalhes básicos da configuração assistida, selecione Importe dados de origem e forneça detalhes básicos .
      Selecione a etapa 1: Forneça informações básicas para o mapa de transformação ETL.
    12. Em Conjunto de importação de amostra campo, selecione Extrair automaticamente um novo conjunto de importação .
      Campo Conjunto de importação de amostra, selecione Extrair automaticamente um novo conjunto de importação.
    13. Selecione Salvar.
      A faixa Informações básicas salvas com sucesso é exibida.
    14. Selecione Marcar como concluído.
    15. Na página Assistente de 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 de 11 a 14.
    16. Selecione Marcar como concluído.
    17. Na página Assistente de mapa de transformação de ETL, na seção Mapear dados para CMDB e Adicionar relacionamentos, selecione Classes do 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 no hardware cmdb_ci_hardware classe. Depois que este campo for mapeado, o campo "comentário" nas classes secundárias de hardware também será 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 o hardware cmdb_ci_hardware , mas em vez disso é um campo na Tecnologia Operacional (cmdb_ci_ot) Você adicionaria o mapeamento de campo no stub de Tecnologia operacional (OT) 1.

      1. Adicione um mapeamento de campo à classe Hardware 1.
      2. Para a classe Hardware 1, selecione Editar mapeamento .
        Selecione Classes do CMDB para mapear os dados de origem
    19. Na caixa de diálogo Adicionar atributo exibida, na Atributo , selecione Comentários .
      Classe de hardware de mapa 1 - Adicionar atributo - caixa de diálogo.
    20. Selecione Salvar.
      Um novo campo chamado "Comentários" é exibido. Talvez seja necessário rolar para ver o campo.
      Novo campo de comentários adicionado.
    21. No painel Dados, arraste a cápsula de dados para os Comentários Coluna de origem campo.
      Mapeie 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 Origem inclui a cápsula de dados.
      Campo de coluna de origem preenchido com uma cápsula de dados.
    22. Navegue de volta para Classes do CMDB para mapear dados de origem Da seção Mapear dados para o CMDB e Adicionar relacionamentos na página Assistente de mapa de transformação de 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 de mapa de transformação de ETL.
      2. Na seção Visualizar amostra de resultados de integração e importação de programação da configuração assistida, selecione Resultados de integração de teste e reversão .
        Assistente de mapa de transformação de ETL - Testar e reverter resultados de integração.
      3. Selecione Executar integração .
      4. Após a execução ser 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.
        Após a execução bem-sucedida dos resultados da integração de Teste e reversão, confirme se a planilha do Excel foi atualizada.
      6. Selecione Execute a reversão .
        Selecione Realizar 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.