Configurar ações de IU personalizadas no espaço legado

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 5 min. de leitura
  • Configure ações de IU para personalizar espaço legado para 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.

    Botões de ação de IU e itens de lista

    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 realizar ações nos registros. Para obter mais informações, consulte Ocultar a guia Detalhes e Ações de IU.

    Procedimento

    1. Navegar até Todos > Definição do Sistema > Ações de IU e clique em Novo.
    2. No formulário, preencha os campos.
      Nota:
      Outros campos além dos na tabela a seguir aparecem no formulário, mas não funcionam em espaços. Para obter mais informações sobre cada campo no formulário Ações de IU, consulte Ações de IU.
      Nome Nome da ação de IU. Isso aparece na IU do espaço, por exemplo, Atribuir incidente a mim.
      Tabela Tabela à qual a ação de IU se aplica. Toda vez 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 de pedido vão de pequeno a grande.
      Nome da ação Equivalente ao Nome que aparece em logs e colunas da tabela, por exemplo, assign_incident_to_me
      Ativo Alterne para fazer a ação de IU aparecer.
      Mostrar inserção Alternar para inserir a mudança de registro na tabela.
      Mostrar atualização Alternar para mostrar a atualização na tabela.
      Cliente

      Alterne para fazer com que o sistema verifique se há scripts do lado do cliente. O padrão são scripts do lado do servidor. Use a API GlideAgentWorkspace em um script para abrir um registro especificado na guia 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 sobre a ação de IU.
      Onclick Ação realizada com o 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 Alternar para mostrar a Ação de IU como um botão no painel de formulário.
      Menu de contexto do formulário Alternar para mostrar a Ação de IU como uma guia no menu Itens relacionados.
      Link de formulário Alternar para mostrar a Ação de IU como um link no painel de formulário.
      Estilo de formulário
      • Primário: colore a Ação de IU de azul.
      • Destrutivo — Colore a Ação de IU de vermelho.
      • Sem estilo — Não colore a Ação de IU.
      Botão da faixa de lista Alternar para mostrar a Ação de IU como um botão na faixa da lista.
      Botão inferior de lista Alternar para mostrar a Ação de IU como um botão na parte inferior da lista de registros.
      Menu de contexto de lista Alternar para mostrar a Ação de IU como uma entrada no menu de contexto da lista.

      Menu de contexto

      Opção de lista Alternar para mostrar a Ação de IU como uma lista suspensa de opções na exibição de lista.
      Link de lista Alternar para mostrar a Ação de IU como um link na exibição de lista.
      Estilo de lista
      • Primário: colore a Ação de IU de azul.
      • Destrutivo — Colore a Ação de IU de vermelho.
      • Sem estilo — Não colore a Ação de IU.
    3. Opcional: Para criar um script do lado do servidor que implemente a ação de IU, insira o script no campo Script.
      Por exemplo, se você quiser incluir o nome do solicitante e a descrição resumida em um incidente criado a partir de um registro de interação, poderá usar o script a seguir que usa GlideRecord
      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 client scripts do espaço para client scripts.

    4. Opcional: Para criar um script do lado do cliente que implemente a ação de IU, consulte Tipos de client script e APIs compatíveis e Portal de serviços e client scripts.
      Nota:
      No formulário de client script, você deve selecionar a opção Isolar script para que um client script funcione em um espaço legado.
    5. Na guia Espaço, selecione: Botão de formulário do espaço para fazer com que a ação de IU apareça 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 Formulário do espaço para fazer a ação de IU aparecer na lista de ações de IU.
      • Menu Formulário do espaço para fazer com que a ação de IU apareça como um item de lista no menu associado a ações de IU.
      • Oformato 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áriodo espaço ou Menu de formulário do espaço, essa propriedade será selecionada automaticamente.
        • Se um usuário tentar selecionar Formatar para o espaço configurável antes de selecionar o botão de formuláriodo espaço ou o menu de formulário do espaço, será exibida uma mensagem de erro.
        • 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.
    6. Opcional: No campo Client script do espaço, crie um client script específico do espaço.
      O espaço tem limitações de script de cliente semelhantes às 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. Na guia Função necessária da seção do espaço, adicione as funções às quais você deseja limitar o acesso à ação de IU.
    8. Clique em Enviar ou Atualizar.

    O que Fazer Depois