---
sourceDocument: Interface do usuário da Now Platform Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/platform-user-interface

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Interface do usuário da Now Platform Yokohama

ft:clusterId :

    - platux

bundleId :

    - platux

workflow :

    - Platform


---

# Configure ações personalizadas nos campos de registro em espaço legado

# Configure ações personalizadas nos campos de registro em espaço legado {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 min. de leitura

Configure usando um valor em um campo de referência para executar uma ação. Por exemplo, adicione um ícone em um campo com um número de telefone para discar esse número de telefone. Ou adicione um ícone em um campo de referência que abre um registro de usuário em uma guia.

## Antes de Iniciar

Função necessária: administrador

Um decorador de campo é um ícone adicionado a um campo de referência no painel de formulário em que um agente pode clicar para executar alguma ação. O espaço oferece suporte a até três decoradores por campo.

O objetivo na configuração de decoradores de campo de ação do espaço é permitir que os agentes façam coisas em uma página que, de outra forma, exigiriam a abertura de páginas adicionais. Por exemplo, em vez de abrir outra página para exibir o registro do usuário nomeado em um incidente, o agente simplesmente clica no decorador do campo Ação do espaço no Solicitante campo para abrir o registro do usuário em uma guia.  

<br />

A ação de campo, Abrir registro, deve existir como uma definição de ação de espaço antes de você criar uma nova atribuição de ação. O ícone, icon-user, deve ser um ícone disponível em sua instância.

## Procedimento

1. Navegar até TudoExperiência de espaçoAções e ComponentesDecoradores de Campo.  
   Uma lista de decoradores de campo existentes é exibida.
2. Clique em Novo.
3. No formulário, preencha os campos.  
   A tabela a seguir adiciona um ícone de decorador de campo aos campos de URL. Quando os agentes clicam no ícone, o URL é aberto.
   {#field-action-decorator__table_an4_hkf_mjb__entry__2}

   | Campo | Descrição |
   |-|-|
   | Rótulo da ação | Nome do decorador de campo, por exemplo, Abra um URL . Você pode usar chaves duplas para inserir valores no texto no tempo de execução, por exemplo, \[count\]. Por exemplo, você pode mostrar o número de registros que um agente seleciona usando chaves. |
   | Nome da ação | Nome que aparece para este registro na lista de atribuições de ação: Experiência de espaçoAções e ComponentesDecoradores de Campo, por exemplo, <kbd class="ph userinput">open_a_url </kbd>. |
   | Implementados como | Ação do cliente é a única seleção válida para decoradores de campo. O decorador de campo aparece como um ícone em um campo, formulário, lista ou lista relacionada. Quando clicado, o decorador executa uma ação, como ligar para um número de telefone, abrir um registro, atualizar conteúdo ou abrir um URL. Componente de IU É um elemento de IU que você pode colocar em muitas áreas em Espaço. Ação do cliente expede uma ação especificada em Especifique a ação do cliente . Script do servidor execute ações no servidor alterando registros de banco de dados, como adicionar, remover ou modificá-los. |
   | Especificar ação do cliente | Clique no ícone de lupa ( ![Ícone de lupa]()) e selecione a ação a ser executada. Para abrir um URL, selecione Abrir URL . Este campo só aparece quando implementado como está Ação do cliente . Não é possível adicionar ações personalizadas a esta lista. |
   | Especificar componente de IU | Clique no ícone de lupa ( ![Ícone de lupa]()) e selecione o componente a ser adicionado. Este campo só aparece quando implementado como está Componente de IU . |
   | Decorador aplica-se a | Tipo de campo significa que o decorador aparece para todos os campos deste tipo. Campo específico significa que o decorador aparece somente quando o campo especificado é aberto. Muitos campos específicos são do mesmo tipo de campo. Por exemplo, selecione Tipo de campo Para aplicar este ícone do decorador de campo a todos os campos de URL. |
   | Tipo de campo | Selecione o tipo de campo onde você deseja que o decorador de campo apareça, por exemplo, Referência . Muitos campos são do tipo Referência . Como outro exemplo, para discar um número de telefone, selecione Número de telefone . Este campo, Tipo de campo aparece somente quando O decorador se aplica a. é Tipo de campo . |
   | Nome do campo | Selecione o campo onde você deseja que o decorador de campo apareça. As opções de campos dependem do valor de Tabela . Por exemplo, selecione Data . Este campo só aparece quando O decorador se aplica a. é Campo específico . |
   | Ícone | Ícone clicável que aparece no campo especificado por Tipo de campo ou Nome do campo que inicia a ação. |
   | Dica da ferramenta | Texto que é exibido quando o agente e passa o mouse sobre o ícone. |
   | Descrição | Descrição resumida deste componente. |
   | Aplicação | Aplicação à qual este componente se aplica. Global significa que o componente se aplica a todas as aplicações. |
   | Espaço | Espaço ao qual este componente pertence, por exemplo, Espaço do agente, ITSM, CSM, e assim por diante. |
   | Tabela | Tabela à qual este componente está vinculado. Quando um registro desta tabela é aberto, o decorador de campo aparece no(s) campo(s) especificado(s) por Tipo de campo ou Nome do campo . O padrão é Global. Você pode deixar o valor padrão para que o ícone do decorador de campo apareça para qualquer registro aberto que tenha o campo especificado por Tipo de campo . Se você especificar uma tabela, somente quando os registros dessa tabela estiverem abertos o ícone do decorador de campo será exibido. |
   | Exibição | Um conjunto de configurações visuais. Normalmente, este valor é Espaço. |
   | Ativo | Alterne para fazer este decorador de campo aparecer (selecionado) ou não. |
   | Ordem | Um número inteiro que rege o posicionamento deste ícone na lista de decoradores de campo em um campo. Quanto menor o número, mais à esquerda na lista. A prática típica é fazer esses números centenas, por exemplo, 100, 200, 300, e 400, para que você possa colocar novos ícones entre os existentes no futuro. |
   [Tabela 1. Formulário Atribuição de ação]

   {#field-action-decorator__table_an4_hkf_mjb}
4. Clique com o botão direito do mouse na faixa superior e selecione Salvar .  
   Os links relacionados são exibidos.
5. **Opcional:** Em Exclusão de ação clique em Novo Para excluir tabelas secundárias de herdar este componente no painel lateral contextual ou esta tabela que herda componentes de uma tabela primária.  
   Os componentes no painel lateral contextual aparecem de acordo com os registros abertos no Espaço do agente. As tabelas secundárias herdam esses componentes por padrão. Você pode evitar que isso aconteça.
   1. No formulário, preencha os campos.  
      {#field-action-decorator__table_jv3_z2j_qjb__entry__2}

      | Campo | Descrição |
      |-|-|
      | Atribuição de ação | Clique no ícone de lupa ( ![Ícone de lupa]()) e selecione uma atribuição de ação, que especifica a atribuição de ação. |
      | Tabela | Tabela associada a este componente. Sempre EspaçoAbre um registro desta tabela, o ícone deste componente aparece no painel lateral contextual. |
      | Excluir esta tabela | Para evitar isso Tabela de herdar este componente de suas tabelas primárias. |
      | Excluir todas as tabelas secundárias | Alterne para impedir tabelas secundárias de Tabela de herdar este decorador de campo. |
      [Tabela 2. Formulário de exclusão de ação]

      {#field-action-decorator__table_jv3_z2j_qjb}
   2. Clique em Enviar.
   {#field-action-decorator__substeps_iv3_z2j_qjb}
6. Em Links relacionados , clique em Exibição avançada .  
   Até este ponto, você não especificou o URL que deseja abrir quando um agente clica no ícone do decorador de campo. Esta é a tarefa que você executa em Exibição avançada .
7. Em Atributos de ação guia, em Mapa de carga , selecione o atributo de ação que você deseja definir.  
   Neste exemplo, selecione url .
8. No campo Valor, insira o URL a ser aberto.
9. **Opcional:** Em Condições guia, em Condição do script , insira um script que possa ocultar o decorador de campo.
10. **Opcional:** Em Condições guia, em Condições do cliente , especifique as condições no cliente que ocultariam o decorador de campo.  
    As condições do cliente são reavaliadas sempre que um agente faz uma mudança em uma lista de registros. Por exemplo, você pode ocultar o botão de uma ação de lista até que um agente selecione um ou mais registros em uma lista. A condição do cliente, então, é "contagem é maior que zero", em que contagem é o número de registros selecionados.
11. **Opcional:** Em Condições guia, em Condições de registro , especifique um campo e um valor para que, se um registro aberto tiver um campo com esse valor, o ícone do decorador de campo não apareça.
12. **Opcional:** Em Condições guia, em Funções necessárias , especifique as funções que um agente deve ter para ver o decorador de campo.
13. **Opcional:** Em Configurações de confirmações , selecione Confirmação necessária se você quiser exibir uma janela pop-up solicitando que o agente confirme a ação a ser realizada pelo decorador de campo.
14. Clique em Atualizar.

## Resultado

O ícone do decorador de campo aparece em todos os campos de registro do tipo Referência para todas as tabelas especificadas em Tabela . Clicar em um ícone abrirá o URL especificado em Mapa de carga .  

<br />