---
sourceDocument: Zurich IT Service Management
sourceDocumentLink: https://www.servicenow.com/docs/r/pt-BR/zurich/it-service-management

 Release :

    - zurich

ft:locale :

    - pt-BR

ft:publication_title :

    - Zurich IT Service Management

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

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

# Adicionar campos personalizados para uma integração da ferramenta de planejamento {#ariaid-title1}

* Versão de lançamento: Zurich
* 
* Atualizado 31 de jul. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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çosEspaço de mudança de DevOpsAdministraçã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 .  
   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 .
   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.
   3. Selecione Save (Salvar).
   {#add-custom-field-for-a-planning-tool-integration__ol_f1j_wn3_wdc}
5. Navegue até a página de registro do transformador e selecione Regras do Transformador de Registro e selecione Novo .
6. Na página Criar nova regra do transformador de registro, preencha os campos a seguir.  
   {#add-custom-field-for-a-planning-tool-integration__table_lhd_sjn_vdc__entry__2}

   | 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. |
   [Tabela 1. Criar nova regra do transformador de registro]

   {#add-custom-field-for-a-planning-tool-integration__table_lhd_sjn_vdc}  
   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.  
   {#add-custom-field-for-a-planning-tool-integration__table_gsg_133_wdc__entry__2}

   | 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. |
   [Tabela 2. Transformador de Registro]

   {#add-custom-field-for-a-planning-tool-integration__table_gsg_133_wdc}
9. Selecione Save (Salvar).
10. Navegue até Edite mapeamentos de campo e selecione Adicionar mapeamento .  
    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).

    {#add-custom-field-for-a-planning-tool-integration__ol_og5_jn3_wdc}  
    Nota:  
    Você pode adicionar vários mapeamentos de campo para uma ação de acordo com seu requisito.
**Tópicos relacionados**   

* [Transformer - Scoped, Global](https://www.servicenow.com/docs/access?context=TransformerScriptedAPI&version=zurich&pubname=zurich-api-reference&ft:locale=en-US)