Adicionar campos personalizados para uma integração da ferramenta de planejamento

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 3 min. de leitura

    • Adicione campos personalizados à integração da ferramenta de planejamento para melhorar a configurabilidade e acessar informações específicas de negócios, o que facilita uma tomada de decisão mais fundamentada.

    Antes de Iniciar

    Função necessária: sn_devops.admin

    Por Que e Quando Desempenhar Esta Tarefa

    Você pode adicionar campos personalizados a uma integração da ferramenta de planejamento usando transformadores de registro. Crie transformadores de registro para cada ação da ferramenta e adicione regras de transformador de registro para mapear campos em sua ferramenta para campos no modelo de dados do DevOps. Por exemplo, considere um cenário em que a ID do item de trabalho Azure DevOps é definida como "adoid" durante o processo de importação. Se você quiser alinhá-lo com a ID do item de trabalho da ServiceNow, poderá fazer isso criando um transformador de registro para a ação de importação. Nesse transformador, você deve estabelecer regras para mapear o campo "adoid" para o campo de ID de item de trabalho da ServiceNow correspondente. Depois que o mapeamento de campo for criado, sempre que um evento de entrada for recebido do Azure DevOps para trazer itens de trabalho, os dados serão processados por meio do transformador configurado na carga transformada.
    Nota:
    Este recurso está disponível somente para as integrações da ferramenta do tipo de plano do sistema de base, exceto para ServiceNow Desenvolvimento ágil 2.0.

    Procedimento

    1. Navegar até Espaços > Espaço de mudança de DevOps > Administração.
    2. Selecione Integrações > Integrações de ferramentas na guia Listas.
    3. Selecione a integração da ferramenta de planejamento à qual você deseja adicionar campos personalizados e escolha Editar mapeamentos de campo. Registro de integração da ferramenta
      Nota:
      Verifique se o escopo da aplicação está selecionado como Integrações de DevOps.
    4. Na página Editar mapeamentos de campo, selecione o botão Criar um transformador de registro na seção Transformação da capacidade de planejamento.
      Nota:
      Você deve criar um transformador de registro para cada ação da ferramenta. Neste procedimento, um transformador de registro é criado para a ação Importar.
      1. Na página Criar novo transformador de registro, selecione Criar sequência de transformador. Página Criar novo transformador de registro
      2. Na página Criar nova sequência de regra do transformador de registro, insira o nome da sequência de regra no campo Nome e selecione o tipo de sequência no campo Tipo. Criar nova página de sequência de regra do transformador de registro
      3. Selecione Save (Salvar).
    5. Navegue até a página de registro do transformador, selecione a guia Regras do Transformador de Registro e selecione Novo. Guia Regras do transformador de registro no registro do transformador de registro
    6. Na página Criar nova regra do transformador de registro, preencha os campos a seguir. Criar nova página de regra do transformador de registro
      Tabela 1. Criar nova regra do transformador de registro
      Campo Descrição
      Nome Nome da regra na sequência.
      Símbolo Nome do campo na carga transformada para onde o valor do campo personalizado é extraído.
      Caminho Caminho da carga de onde o valor do campo personalizado é recuperado.
      Pedido Ordem na qual a regra deve ser executada na sequência.
      Descrição Texto que explica a regra.
      Nota:
      Várias regras também podem ser adicionadas a uma coluna personalizada da carga JSON e mais campos podem ser mapeados. Todas as transformações adicionadas são consideradas na carga transformada.
    7. Selecione Save (Salvar).
    8. Navegue até a seção Detalhes do registro do transformador e preencha os campos a seguir.
      Tabela 2. Transformador de Registro
      Campo Descrição
      Nome Nome do transformador de registro.
      Caminho Base Caminho a ser lido para a carga de entrada.
      Descrição Texto que explica o transformador de registro.
      Caminho do Registro Caminho a ser gravado para a carga transformada.
      Sequência de Regras do Transformador de Registro Sequência de regra que você deseja associar a este transformador de registro.
      Ativo Opção para ativar o transformador de registro.
    9. Selecione Save (Salvar).
    10. Navegue até a página Editar mapeamentos de campo e selecione Adicionar mapeamento. Editar página de mapeamentos de campo
      1. Selecione o transformador de registro para a ação da ferramenta.
      2. Defina a sequência na qual o mapeamento do registro é processado no campo Ordem.
      3. Selecione um símbolo se quiser mapear o transformador de registro para diferentes entidades.
        Nota:
        O campo Símbolo aqui é diferente do campo Símbolo no formulário Criar nova regra do transformador de registro na etapa 6.
      4. Selecione Save (Salvar).
      Nota:
      Você pode adicionar vários mapeamentos de campo para uma ação de acordo com seu requisito.