Configurar decoradores de campo no Espaço configurável

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 6 min. de leitura

    • Adicione um decorador de campo, ou ícone, que execute uma ação quando selecionado ao lado de um campo. Por exemplo, 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

    Por Que e Quando Desempenhar Esta Tarefa

    Um decorador de campo é um ícone adicionado a um campo no componente Formulário. Um agente pode selecionar o ícone para executar uma ação. Espaço oferece suporte a até três decoradores por campo.

    O objetivo da configuração de decoradores de campo é permitir que os agentes façam coisas em uma página que, de outra forma, precisariam abrir 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 pode selecionar o decorador de campo Ação do espaço no campo Solicitante para abrir o registro do usuário em uma guia.


    Selecione o decorador de campo para abrir o registro do usuário.

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

    Procedimento

    1. Navegar até Todos > Experiência de espaço > Ações e Componentes > Decoradores de Campo.
    2. Selecione Novo.
    3. No formulário, preencha os campos.

      O formulário a seguir adiciona um ícone de decorador de campo aos campos de URL. Quando um agente seleciona o í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.
      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.
      Nota:
      O nome da ação é exclusivo para implementar e identificar substituições. Se houver vários decoradores com o mesmo nome de ação (mesmo vazios), o sistema presumirá que eles são duplicatas e exibirá somente o primeiro, com base na ordem.
      Implementados como
      • A ação docliente UXF é a carga a ser expedida para o evento interno quando a ação é acionada (por exemplo, abrir um modal ou navegar até uma guia).
      • Script de cliente para escrever e executar scripts de cliente usando as APIs g_form e g_list.
      • Script do servidor a ser executado quando a ação for acionada.
      Nota:
      Ocomponente de IU e a ação do cliente são seleções válidas somente para legado Espaço e não funcionam com espaços configuráveis.
      Especificar ação do cliente Selecione o ícone de lupa(ícone de lupa) e selecione a ação a ser tomada. Para abrir um URL, selecione Abrir URL. Este campo só é exibido quando Implementado comoAção do cliente UXF. Você não pode adicionar ações personalizadas a esta lista.
      Decorador aplica-se a Tipo de campo significa que o decorador aparece em todos os campos desse tipo (por exemplo, todos os campos de referência). Campo específico significa que o decorador aparece somente ao lado do campo específico selecionado (por exemplo, Atribuído a).
      Tipo de campo Selecione o tipo de campo em que você deseja que o decorador de campo apareça, por exemplo, Referência. O tipo de campo é exibido somente quando o Decorador se aplica a é Tipo de campo.
      Nome do campo Selecione o campo em que você deseja que o decorador de campo apareça. As opções de campos dependem do valor de Tabela. Por exemplo, selecione Atribuído a. Este campo só é exibido quando o Decorador se aplica aocampo específico.
      Nota:
      Somente um subconjunto de tipos de campo oferece suporte a decoradores de campo. Embora você possa selecionar qualquer campo em uma tabela, o tipo deve ser compatível.
      Ícone Ícone selecionável que aparece no campo especificado por Tipo de campo ou Nome do campo que inicia a ação.
      Dica da ferramenta Texto exibido quando um agente passa o mouse sobre o ícone.
      Descrição Descrição desta ação.
      Aplicação Aplicação à qual este componente se aplica. Global significa que o componente se aplica a todas as aplicações.
      Tabela Tabela à qual este componente está vinculado. Quando um registro desta tabela é aberto, o decorador de campo aparece no especificado 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 Exibição de formulário onde o decorador deve aparecer. Se deixado em branco, o decorador aparecerá em todas as exibições de formulário.
      Experiência restrita Selecione se você deseja que o decorador apareça somente em experiências de espaço específicas. Se você selecionar essa opção, deverá escolher para quais experiências o decorador deve aparecer. Você pode fazer isso selecionando as Configurações de ação correspondentes na lista relacionada Configurações de açã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 é tornar esses números 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.
    5. Opcional: Na guia da lista relacionada Exclusão de ação, selecione Novo para excluir tabelas e tabelas secundárias de herdar este decorador.
      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 Selecione o ícone de lupa Ícone de lupa e selecione uma atribuição de ação, que especifica a atribuição de ação.
        Tabela A tabela associada a este decorador.
        Excluir esta tabela Alterne para impedir que esta Tabela herde este componente de suas tabelas primárias.
        Excluir todas as tabelas secundárias Alterne para impedir que tabelas secundárias de Tabela herdem este decorador de campo.
      2. Selecione Enviar.
    6. Em Links relacionados, selecione Exibição avançada.
      Nota:
      Até este ponto, você não especificou o URL que deseja abrir quando um agente seleciona o ícone do decorador de campo. Esta é a tarefa que você executa na Exibição avançada.
    7. Na guia Atributos de ações, no Mapa de carga. Selecione o atributo de ação que você deseja definir.
    8. No campo de valor, insira o URL a ser aberto.
    9. Opcional: Na guia Condições, especifique as condições para o decorador de campo.
      1. Selecione Condições de script para inserir um script que oculta o decorador de campo.
      2. Nota:
        Esta configuração acessa todos os campos e permite avaliar as condições no lado do cliente sem precisar salvar o formulário. As condições do cliente dão acesso somente a um subconjunto de campos.
        Selecione Condições do cliente com script para especificar condições no cliente que mostrarão ou ocultarão o decorador de campo.
      3. Selecione Condições do cliente para especificar condições no cliente que mostrarão ou ocultarão o decorador de campo.
      4. Selecione Condições de registro para especificar um campo e um valor, em um registro aberto, que o decorador de campo não apareça.
      5. Selecione Funções necessárias para especificar as funções necessárias para ver o decorador de campo.
    10. Nota:
      Na guia Configurações de confirmação.
      Selecione Confirmação necessária para exibir um pop-up que solicita ao agente que confirme a ação que o decorador de campo executa.
    11. Selecione Atualizar.