Criar Ação de IU

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 6 min. de leitura

    • Você pode criar uma nova ação de IU ou editar uma existente.

    Antes de Iniciar

    Função necessária: ui_action_admin ou administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Você pode adicionar ações de IU a tabelas e exibições de banco de dados que estão no mesmo escopo da ação de IU e tabelas que permitem que ações de IU de outro escopo de aplicação sejam executadas nelas.

    Procedimento

    1. Navegar até Tudo > Definição do Sistema > Ações de IU.
    2. Clique em Novo ou abra um registro existente.
    3. Preencha os campos para definir a ação de IU.
      Pode ser necessário configurar o formulário para ver todos os campos.
      Tabela 1. Campos de ação de IU
      Campo Descrição
      Nome O texto que aparece no botão, link ou item de menu de contexto.
      Tabela A tabela na qual a ação de IU está disponível. Por padrão, a ação de IU também aparece em tabelas que estendem a tabela selecionada (por exemplo, Ações de tarefa aparecem na tabela Incidente).

      Selecione Global para disponibilizar a ação em todas as tabelas.
      Ordem A ordem em que a ação de IU é exibida. A ordem se aplica a botões da esquerda para a direita e a ações de menu de cima para baixo.
      Nome da ação Um nome exclusivo a ser usado ao fazer referência à ação de IU em scripts.
      Ativo Uma opção para habilitar a ação de IU quando selecionada. Para desabilitar uma ação de IU, desmarque a caixa de seleção.
      Mostrar inserção Uma opção para mostrar um botão em novos registros que não foram inseridos.
      Mostrar atualização Uma opção para mostrar um botão em registros existentes.
      Cliente Uma opção para a ação de IU executar seu script no navegador do usuário, não no servidor. Quando habilitado, o Onclick O campo aparece acima do campo Condição.
      Botão de formulário Uma opção para colocar um botão em um formulário.
      Menu de contexto do formulário Uma opção para colocar um item em um menu de contexto de formulário (clique com o botão direito do mouse no cabeçalho do formulário).
      Link de formulário Uma opção para colocar um link na seção Links relacionados de um 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.
      Botão da faixa de lista Uma opção para colocar um botão na faixa de uma lista.
      Nota:
      Os botões de faixa de lista não se destinam a oferecer suporte a condições específicas do registro, portanto, somente a primeira linha é considerada quando a condição é avaliada para determinar se o botão será exibido para a lista. Não use condições específicas do registro (por exemplo, current.getValue('state') nas ações de IU do botão de faixa de lista.
      Botão inferior de lista Uma opção para colocar um botão na parte inferior de uma lista.
      Nota:
      Os botões inferiores da lista são exibidos independentemente da condição e são avaliados por registro na execução.
      Menu de contexto de lista Uma opção para colocar um item em um menu de contexto de campo de lista (clique com o botão direito do mouse em uma célula em uma lista).
      Opção de lista Uma opção para colocar um item na lista de seleção de ação na parte inferior de uma lista.
      Nota:
      Os botões inferiores da lista, como ações de seleção de lista, são exibidos independentemente da condição e são avaliados por registro na execução.
      Link de lista Uma opção para colocar um link na seção Links relacionados na parte inferior de uma 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.
      Substituições Uma ação de IU que esta ação de IU substitui.
      Mensagens Cadeias de caracteres de texto que a ação de IU pode usar como chave para pesquisar uma alternativa de mensagem localizada na tabela Mensagem [sys_ui_message]. Cada chave de mensagem está em uma linha separada no campo Mensagens.

      A instância procura uma cadeia de caracteres de mensagem localizada sempre que a ação de IU faz uma chamada getMessage(msg) em que a cadeia de caracteres msg corresponde a uma chave no campo Mensagens.
      Comentários Conteúdo descritivo sobre esta ação de IU.
      Dica O texto que aparece quando um usuário aponta para o controle de ação de IU.
      Onclick O nome da função JavaScript a ser executada quando a ação de IU for executada. A função é definida em Script campo.
      Condição Uma declaração condicional JavaScript que restringe quando uma ação de IU é exibida. As condições sempre são executadas no servidor.
      Nota:
      • O objeto atual não está disponível para condições em um menu de contexto de lista. . Menu de contexto da lista a opção está selecionada, qualquer uso de currentnessas ações é ignorado.
      • Você pode fazer referência ao registro primário para as condições de ação de IU em um botão de lista relacionada. Por exemplo, para desabilitar o. Novo e. Editar Na lista relacionada de ICs afetados para mudanças encerradas, copie as ações globais de IU m2m para a tabela task_ci e adicione uma condição de parent.active.
      • Se você deixar um dos campos em branco que especificar na declaração de condição, o padrão dessa condição será verdadeiro .
      Script O script a ser executado quando a ação de IU for executada. Os nomes das funções devem ser exclusivos.
      Espaço
      Botão de formulário do espaço Uma opção para fazer a ação de IU aparecer na lista de ações de IU em um espaço.
      Menu do espaço do formulário Uma opção para fazer a ação de IU aparecer como um item de lista no menu associado a ações de IU em um espaço.
      Formato do espaço configurável Uma opção para usar a ação de IU em um Espaço configurável. Se desmarcada, a ação de IU se aplicará aos espaços legados.
      Client script do espaço Um script a ser executado quando a ação de IU é executada em espaços de trabalho.
      Requer função
      Função As funções necessárias para que a ação de IU seja aplicada. Os usuários devem ter pelo menos uma das funções para a ação de IU ser aplicada.
      Listas relacionadas na exibição do formulário
      Visibilidade da Ação de IU As exibições do formulário às quais a ação de IU se aplica. Use esta opção para restringir a ação de IU às exibições de formulário que você especificar. Uma ação de IU está disponível para a exibição especificada de acordo com as seguintes regras:
      1. Se não houver regras de visibilidade, a ação aparecerá em todas as exibições.
      2. Qualquer regra de exclusão em uma determinada exibição significa que a ação não aparece nessa exibição.
      3. Se houver pelo menos uma regra de inclusão, a ação aparecerá somente nas exibições que estão incluídas especificamente.
      Versões Todas as versões da ação de IU. Use esta lista para comparar versões ou reverter para uma versão anterior.
    4. Clique em Enviar ou Atualizar.
      Nota:
      Se a ação de IU estiver habilitada para ser executada no lado do cliente, envolva-a em uma função. Caso contrário, o conteúdo do Script o campo é executado quando a página é carregada.

    Exemplo

    Como parte de um script de ação de IU, você pode redirecionar um usuário para um URL. Por exemplo, você pode adicionar links a um formulário ou abrir um novo registro depois que ele é criado a partir de uma ação de IU. Para redirecionar um usuário para um URL de uma ação de IU, use esta sintaxe no Script campo para definir o link de redirecionamento:
    action.setRedirectURL ( 'http://www.mysite.com/mypage.htm' );
    Para direcionar um usuário para um registro, use esta sintaxe, em que new_recordé o nome da variável para GlideRecord :
    action.setRedirectURL (new_record );