---
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 de IU personalizadas em espaço legado

# Configure ações de IU personalizadas 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) 5 min. de leitura

Configure ações de IU para personalizar espaço legadopara sua organização. As ações de IU incluem botões personalizados, itens de menu e limitação de acesso a formulários com base na função de um usuário.

## Antes de Iniciar

Função necessária: Workspace_admin

## Por Que e Quando Desempenhar Esta Tarefa

As ações de IU aparecem como botões de formulário ou itens de lista no menu de ação de IU.

Cada espaço vem pré-configurado com ações de IU. No entanto, você pode adicionar ou remover ações de IU pré-configuradas.

Você pode ocultar ações de IU para pessoas que não precisam executar ações nos registros. Para obter mais informações, consulte [Oculte a guia Detalhes e as ações de IU](https://servicenow-prod.fluidtopics.net/nwhBHzhJtaezngSC7sPHQw "Oculte o. Detalhes No menu Itens relacionados e ações de IU para pessoas que não precisam ver esse nível de detalhe.").

## Procedimento

1. Navegar até TudoDefinição do SistemaAções de IU e clique em Novo .
2. No formulário, preencha os campos.  
   Nota:  
   Outros campos além dos da tabela a seguir aparecem no formulário, mas não funcionam em espaços de trabalho. Para obter mais informações sobre cada campo no formulário Ações de IU, consulte [Ações de IU](https://www.servicenow.com/docs/access?context=c_UIActions&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).

   |-|-|
   | Nome | Nome da ação de IU. Isso aparece na IU do espaço, por exemplo, <kbd class="ph userinput">Atribuir incidente a mim </kbd>. |
   | Tabela | Tabela à qual a ação de IU se aplica. Sempre que um agente exibe um registro desta tabela, esta ação de IU é exibida. |
   | Ordem | Posicionamento na lista horizontal de ações de IU. Da esquerda para a direita, os números dos pedidos vão de pequeno a grande. |
   | Nome da ação | Equivalente de Nome que aparece em logs e colunas da tabela, por exemplo, <kbd class="ph userinput">assign_incident_to_me </kbd> |
   | Ativo | Alterne para fazer a ação de IU aparecer. |
   | Mostrar inserção | Alterne para inserir a mudança de registro no Tabela . |
   | Mostrar atualização | Alterne para mostrar a atualização no Tabela . |
   | Cliente | Alterne para fazer o sistema verificar se há scripts do lado do cliente. O padrão são scripts do lado do servidor. Use o. [GlideAgentWorkspace](https://www.servicenow.com/docs/access?context=GlideAgentWorkspaceAPI&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)API em um script para abrir um registro especificado Espaço. |
   | Substituições | Ações de IU que substituem esta ação de IU. |
   | Comentários | Descrição desta ação de IU. |
   | Dica | Descreve a ação de IU quando o mouse passa o mouse sobre a ação de IU. |
   | Onclick | Ação realizada com um clique do mouse na Ação de IU, por exemplo, confirmAndDeleteFromForm(). |
   | Condição | Condições que devem ser atendidas para que a Ação de IU apareça, por exemplo, `Current.isValidRecord() && current.canDelete() `. |
   | Script | Script do lado do servidor que implementa a ação de IU. |
   | Aplicação | Aplicação à qual este componente se aplica. Global significa que o componente se aplica a todas as aplicações. |
   | Botão de formulário | Alterne para mostrar a Ação de IU como um botão no painel de formulário. |
   | Menu de contexto do formulário | Alterne para mostrar a Ação de IU como uma guia no menu de itens relacionados. |
   | Link de formulário | Alterne para mostrar a Ação de IU como um link no painel de formulário. |
   | Estilo de formulário | * Primário - Colora a ação de IU em azul. * Destrutivo - Colora a ação de IU em vermelho. * Sem estilo: Não colora a ação de IU. {#configure-agent-workspace-ui-actions__ul_ppm_l1r_zjb} |
   | Botão da faixa de lista | Alterne para mostrar a Ação de IU como um botão na faixa de lista. |
   | Botão inferior de lista | Alterne para mostrar a Ação de IU como um botão na parte inferior da lista de registros. |
   | Menu de contexto de lista | Alterne para mostrar a Ação de IU como uma entrada no menu de contexto da lista. |
   | Opção de lista | Alterne para mostrar a Ação de IU como uma lista suspensa de opções na exibição de lista. |
   | Link de lista | Alterne para mostrar a Ação de IU como um link na exibição de lista. |
   | Estilo de lista | * Primário - Colora a ação de IU em azul. * Destrutivo - Colora a ação de IU em vermelho. * Sem estilo: Não colora a ação de IU. {#configure-agent-workspace-ui-actions__ul_gfw_3vp_zjb} |
   [ ]

   {#configure-agent-workspace-ui-actions__table_kzl_dwc_2jb}
3. **Opcional:** Para criar um script do lado do servidor que implementa a ação de IU, insira o script no Script campo.  
   Por exemplo, se você quiser incluir o nome do chamador e a descrição resumida em um incidente criado a partir de um registro de interação, você pode usar o script a seguir que usa [GlideRecord](https://www.servicenow.com/docs/access?context=c_GlideRecordClientSideAPI&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)

       if(current.update()){
       	var inc = new GlideRecord("incident");
       	inc.newRecord();
       	inc.caller_id = current.opened_for;
       	inc.short_description = current.short_description;
       	action.openGlideRecord(inc);
       }

   O sistema ignora todos os scripts de cliente incluídos neste campo. Você só pode usar o campo de script do cliente do espaço para scripts do cliente.
4. **Opcional:** Para criar um script do lado do cliente que implementa a ação de IU, consulte [APIs e tipos de script de cliente compatíveis](https://servicenow-prod.fluidtopics.net/H2tl26JJMPKIUSZPI~cZ8w "Alguns scripts de cliente não são compatíveis com Portal de serviços. Os outros devem ter um tipo de IU definido como Todos ou Portal de serviços/celular . Se estiver usando um client script no Portal de serviços, Somente APIs do lado do cliente compatíveis com um ambiente móvel podem ser usadas.")e. [Scripts do cliente e do portal de serviços](https://servicenow-prod.fluidtopics.net/hMuc1rgqgxIbDlSJ_HSxGg "Você pode usar scripts de cliente e scripts de cliente de catálogo no Portal de serviçosSe o Tipo de IU estiver definido como Portal de serviços/celular ou Todos . Scripts de cliente e scripts de cliente de catálogo são usados com o widget de formulário e o widget de item do catálogo SC, em vez de um controlador de cliente de widget.").  
   Nota:  
   No formulário de client script, você deve selecionar Isolar script opção de um script de cliente para trabalhar em um espaço legado.
5. Em Espaço selecione: Botão de formulário do espaço Para fazer a ação de IU aparecer na linha de ações de IU, ou Menu de formulário do espaço para que ele apareça como um item de lista na lista de menus.  
   * Botão de formulário do espaço Para fazer a ação de IU aparecer na lista de ações de IU.
   * Menu de formulário do espaço Para fazer a ação de IU aparecer como um item de lista no menu associado às ações de IU.
   * Formato do Espaço configurável Permite que a ação de IU apareça em espaços configuráveis.  
     Nota:  
     Para novas ações de IU, se um usuário selecionar Botão de formulário do espaço ou Menu de formulário do espaço , esta propriedade é selecionada automaticamente.
     * Se um usuário tentar selecionar Formato do Espaço configurável antes de selecionar Botão de formulário do espaço ou Menu de formulário do espaço , uma mensagem de erro é exibida.
     * Se um usuário quiser que a ação apareça somente na AWS legada (não configurável), ele deverá desmarcar esta caixa de seleção.
     * Se um usuário quiser que uma ação de IU existente apareça em espaços configuráveis, ele precisará marcar esta caixa de seleção e salvar o registro.
     {#configure-agent-workspace-ui-actions__ul_aw4_lvc_btb}
   {#configure-agent-workspace-ui-actions__ul_pd3_czc_2jb}
6. **Opcional:** Em Script do cliente do espaço crie um script de cliente específico do espaço.  
   O espaço tem limitações de script de cliente semelhantes a Portal de serviços. Por exemplo, para abrir um formulário clicando nele, você pode adicionar o seguinte client script:

       function onClick(g_form) {

       }

7. Em Requer função Da seção do espaço, adicione todas as funções às quais você deseja limitar o acesso à ação de IU.
8. Clique em Enviar ou Atualizar.
{#configure-agent-workspace-ui-actions__steps_qj1_hjr_jdb}

## O que Fazer Depois

Clique em um componente para configurá-lo.

|-|-|-|
| * [Guias](https://servicenow-prod.fluidtopics.net/sduyjOJ53KRRfb6WSGI_Ag "Permita que os agentes criem os registros de que precisam para que possam fazer seu trabalho no Espaço.") * [Notificações](https://servicenow-prod.fluidtopics.net/rYcBFR7UlnkSx6DZ4~eAUQ "Envie notificações para um agente ou um pequeno grupo de agentes quando houver atualizações em registros importantes.") * [Cabeçalho do Formulário](https://servicenow-prod.fluidtopics.net/QfmoEHNbQC7hZ_DEY0N2oQ "Configure o campo primário e os valores secundários nos cabeçalhos do formulário para que os agentes possam se orientar rapidamente para um problema.") * [Ações de IU](https://servicenow-prod.fluidtopics.net/IhhVp9MuX~ihypohkL4YPg "Configure ações de IU para personalizar espaço legadopara sua organização. As ações de IU incluem botões personalizados, itens de menu e limitação de acesso a formulários com base na função de um usuário.") {#configure-agent-workspace-ui-actions__ul_stg_plv_pjb} | * [Faixa de opções](https://servicenow-prod.fluidtopics.net/3mhQkVNlbJxwJiU_~WFBEQ "Configure fitas em espaço legadoPara ajudar os agentes a verificar rapidamente informações relevantes sobre um registro, como o cronograma do registro, um resumo do cliente e ANS de registro.") * [Itens Relacionados](https://servicenow-prod.fluidtopics.net/SCwN8~dLbJ9Bq4Ln1cRTZg "Configure os itens relacionados ao registro aberto para que os agentes possam entender melhor o registro e seu impacto.") * [Painel de formulário](https://servicenow-prod.fluidtopics.net/ZN3tDVpVBDc3oX4ASJJ_Jw "Selecione os campos que aparecem no painel de formulário para ajudar os agentes a realizar seu trabalho.") * [Ações e Componentes](https://servicenow-prod.fluidtopics.net/eRJVPVOtolnWHkbzSoj9_g "Envolva-se com formulários, campos, listas e páginas de lista relacionadas do espaço adicionando ações personalizadas.") {#configure-agent-workspace-ui-actions__ul_lyk_qlv_pjb} | * [Fluxo de atividades](https://servicenow-prod.fluidtopics.net/uZEk1~o5bhhCPoa9FVKZZw "Configure as opções de como os agentes podem interagir com Fluxo de atividadespara facilitar o trabalho.") * [Painel Lateral Contextual](https://servicenow-prod.fluidtopics.net/iBEYQWit5~t3jDq2l2g8jQ "O painel lateral contextual fornece aos agentes ferramentas para pesquisar e resolver problemas. Os diferentes componentes fornecem aos agentes diferentes tipos de ajuda.") {#configure-agent-workspace-ui-actions__ul_hgc_rlv_pjb} |
[ ]

{#configure-agent-workspace-ui-actions__table_dxj_nlv_pjb}

* **[Renderize um componente em um modal](https://servicenow-prod.fluidtopics.net/YpWKjOlBAfqXnPFKaEH7qA)**   
  Use uma Ação de IU para iniciar um componente personalizado em um modal para que um agente não precise navegar para uma tela diferente para realizar uma tarefa.
* **[Fechar guia e salvar e fechar ações de IU da guia](https://servicenow-prod.fluidtopics.net/yAg1O6~J9gBixUKFxL_tuA)**   
  Use o. CloseRecord() método para fechar uma guia ou salvar e fechar uma guia.
* **[Ações de IU do grupo em espaço legado](https://servicenow-prod.fluidtopics.net/PB_TlMxCuLRUG~YeeAZdgQ#group-ui-actions-workspace)**   
  Defina um grupo de uma ou mais ações de IU para personalizar as ações no menu do cabeçalho do formulário.