---
sourceDocument: Yokohama Gestão de serviços de TI
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/it-service-management

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Yokohama Gestão de serviços de TI

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: Yokohama
* 
* Atualizado 30 de jan. 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 do negócio, 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 da ferramenta e adicione regras de transformadores de registro para mapear campos na ferramenta para campos no modelo de dados DevOps. Por exemplo, considere um cenário em que Azure DevOpsO 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ê pode 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 ServiceNow correspondente. Após a criação do mapeamento de campo, 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 para a carga transformada.  
Nota:  
Este recurso está disponível somente para as integrações de ferramenta de tipo de plano de sistema base, exceto 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 de DevOps.
4. Na página Editar mapeamentos de campo, selecione Crie 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 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 transformador .
   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 no Tipo campo.
   3. Selecione 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 em que 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 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 do qual ler a 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 tornar o transformador de registro ativo. |
   [Tabela 2. Transformador de Registro]

   {#add-custom-field-for-a-planning-tool-integration__table_gsg_133_wdc}
9. Selecione Salvar.
10. Navegue até Edite mapeamentos de campo e selecione Adicione 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 entidades diferentes.  
       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 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=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)