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

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. 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 a tomada de decisões mais informada.

    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 de ferramenta de planejamento usando transformadores de registro. Crie transformadores de registro para cada ação de ferramenta e adicione regras de transformador de registro para mapear campos em sua ferramenta para campos no modelo de dados DevOps. Por exemplo, considere um cenário em que Azure DevOps O ID do item de trabalho é definido como "adoid" durante o processo de importação. Se você quiser alinhá-lo com o ID do item de trabalho da ServiceNow, você poderá conseguir isso criando um transformador de registro para a ação de importação. Neste transformador, você deve estabelecer regras para mapear o campo "adoid" para o campo de ID do item de trabalho da ServiceNow correspondente. Depois que o mapeamento de campo é criado, sempre que um evento de entrada é 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 de ferramenta de 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 para a qual você deseja adicionar campos personalizados e selecione Edite mapeamentos de campo . Registro de integração da ferramenta
      Nota:
      Verifique se o escopo da aplicação está selecionado como Integrações DevOps.
    4. Na página Editar mapeamentos de campo, selecione Crie um transformador de registro Na seção Transformação de capacidade de planejamento.
      Nota:
      Você deve criar um transformador de registro para cada ação de 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 transformadores . 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 em Nome e selecione o tipo de sequência em Tipo campo. 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 e selecione 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.
      Ordem Ordem na qual a regra deve ser executada na sequência.
      Descrição Texto explicando 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 de leitura da carga de entrada.
      Descrição Texto explicando o transformador de registro.
      Caminho do Registro Caminho para gravar 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é Edite 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 Pedido campo.
      3. Selecione um símbolo se quiser mapear o transformador de registro para diferentes entidades.
        Nota:
        Aqui, o campo Símbolo é 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.