Configurar ações personalizadas em campos de registro no espaço legado

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 Formulário no qual um agente pode clicar para executar alguma ação. O espaço aceita até três decoradores por campo.

O objetivo na configuração de decoradores de campo 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 apenas clica no decorador de campo Ação do espaço no campo Solicitante para abrir o registro do usuário em uma guia.

A ação de campo, Abrir registro, deve existir como uma definição de ação do 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é Tudo > Experiência de espaço > Ações e Componentes > Decoradores de Campo.
   Uma lista de decoradores de campo existentes é exibida.
2. Clique em Nova.
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.

   Tabela 1. Formulário Atribuição de ação

   Campo	Descrição
   Rótulo da ação	Nome do decorador de campo, por exemplo, Abrir uma 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ço > Ações e Componentes > Decoradores de Campo, por exemplo, open_a_url.
   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. O componente de IU é um elemento de IU que você pode colocar em várias áreas em Espaço. A ação do cliente expede uma ação especificada em Especificar ação do cliente. O script do servidor executa ações no servidor, alterando registros do banco de dados, como adicionar, remover ou modificá-los.
   Especificar ação do cliente	Clique no ícone de lupa ( ) e selecione a ação a ser executada. Para abrir uma URL, selecione Abrir URL. Este campo só aparece quando Implementado como é Ação do cliente. Você não pode adicionar ações personalizadas a esta lista.
   Especificar componente de IU	Clique no ícone de lupa ( ) e selecione o componente a ser adicionado. Este campo só aparece quando Implementado como é Componente de IU.
   Decorador aplica-se a	Tipo de campo significa que o decorador aparece para todos os campos desse 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 de decorador de campo a todos os campos de URL.
   Tipo de campo	Selecione o tipo de campo onde 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, só aparece quando o Decorador se aplica aé Tipo de campo.
   Nome do campo	Selecione o campo onde 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 aocampo 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 um agente 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 nos campos especificados 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 poderá ser exibido.
   Exibição	Um conjunto de configurações visuais. Este valor normalmente é Espaço.
   Ativo	Alterne para fazer com que este decorador de campo apareça (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 é transformar esses números em centenas, por exemplo, 100, 200, 300 e 400, para que você possa colocar novos ícones entre os existentes no futuro.

4. Clique com o botão direito do mouse na faixa superior e selecione Salvar.
   Links relacionados são exibidos.
5. Opcional: Na guia Exclusão de ação, clique em Novo para impedir que tabelas secundárias herdem este componente no painel Lado contextual ou esta tabela herde componentes de uma tabela primária.
   Os componentes no painel Lado 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 impedir que isso aconteça.
   1. No formulário, preencha os campos.

      Tabela 2. Formulário de exclusão de ação

      Campo	Descrição
      Atribuição de ação	Clique no í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. Cada vez que Espaço abre um registro desta tabela, o ícone deste componente aparece no painel lateral contextual.
      Excluir esta tabela	Alternar para impedir que esta tabela herde este componente de suas tabelas primárias.
      Excluir todas as tabelas secundárias	Alternar para impedir que tabelas secundárias de Tabela herdem este decorador de campo.

   2. Clique em Enviar.
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 clicar no ícone do decorador de campo. Esta é a tarefa que você executa na exibição avançada.
7. Na guia Atributos de ação, em Mapa de carga, selecione o atributo de ação que você deseja definir.
   Neste exemplo, selecione url.
8. No campo de valor, insira o URL a ser aberto.
9. Opcional: Na guia Condições, em Condição de script, insira um script que possa ocultar o decorador de campo.
10. Opcional: Na guia Condições, em Condições do cliente, especifique as condições no cliente que ocultam 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, é "a contagem é maior que zero", onde a contagem é o número de registros selecionados.

11. Opcional: Na guia Condições, em Condições de registro, especifique um campo e um valor de modo que, se um registro aberto tiver um campo com esse valor, o ícone do decorador de campo não seja exibido.
12. Opcional: Na guia Condições, em Funções necessárias, especifique as funções que um agente deve ter para ver o decorador de campo.
13. Opcional: Na guia Configurações de confirmações, marque a caixa de seleção Confirmação necessária se quiser exibir um pop-up que solicita 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 abriria o URL especificado no Mapa de Carga.