Criar Ação de IU

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 da aplicação sejam executadas nelas.

Procedimento

1. Navegar até Todos > Definição do Sistema > Ações de IU.
2. Clique em Novo ou abra um registro existente.
3. Defina a ação de IU preenchendo os campos.
   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	Define o texto que aparece no botão, link ou item do menu de contexto.
   Tabela	Define 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, as ações de tarefa aparecem na tabela Incidente). Selecione Global para disponibilizar a ação em todas as tabelas.
   Ordem	Define a ordem na qual a ação de IU aparece. A ordem se aplica aos botões da esquerda para a direita e às ações do menu de cima para baixo.
   Nome da ação	Define um nome a ser usado ao fazer referência à ação de IU em scripts.
   Ativo	Habilita a ação de IU quando selecionada. Para desabilitar uma ação de IU, desmarque a caixa de seleção.
   Mostrar inserção	Mostra um botão em novos registros que não foram inseridos.
   Mostrar atualização	Mostra um botão em registros existentes.
   Cliente	A ação de IU executa seu script no navegador do usuário, não no servidor. Quando habilitado, o campo Ao clicar aparece acima do campo Condição.
   Botão de formulário	Coloca um botão em um formulário.
   Menu de contexto do formulário	Coloca 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	Coloca um link na seção Links relacionados de um formulário.
   Botão da faixa de lista	Coloca um botão na faixa de uma lista. Nota: Os botões da faixa de lista não se destinam a oferecer suporte a condições específicas de 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 de registro (por exemplo, current.getValue('state') === 'closed') em Ações de IU do botão da faixa de lista.
   Botão inferior de lista	Coloca 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	Coloca um item em um menu de contexto de campo de lista (clique com o botão direito do mouse em uma célula de uma lista).
   Opção de lista	Coloca um item na lista de seleção de ação na parte inferior de uma lista. Nota: Botões inferiores de 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	Coloca um link na seção Links relacionados na parte inferior de uma lista.
   Substituições	Especifica uma ação de IU que esta ação de IU substitui.
   Comentários	Fornece conteúdo descritivo sobre esta ação de IU.
   Dica	Define 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 no campo Script.
   Condição	Define as condições que restringem quando uma ação de IU aparece. Consulte Usando o construtor de condição para personalizar ações de IU para Espaço do agente para obter exemplos.
   Script	Define o script a ser executado quando a ação de IU é executada.
   Listas relacionadas na exibição de formulário:
   Visibilidade da Ação de IU	Especifica outras 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ê especificou.
   Versões	Mostra todas as versões da ação de IU. Use esta lista para comparar versões ou para 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, encapsule-a em uma função. Caso contrário, o conteúdo do campo Script será executado quando a página for 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 campo Script 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 o GlideRecord:

action.setRedirectURL (new_record );

Usando o construtor de condição para personalizar ações de IU para Espaço do agente

Configure ações de IU adicionando condições a um formulário de Ação de IU.

Uso do construtor de condição de ação de IU

A condição a seguir está configurada para o botão Fechar incidente :

Para que esta ação apareça em um formulário, estas condições devem ser avaliadas como verdadeiras:

• current.incident_state deve ser igual a 6: o incidente já deve estar em um estado Resolvido.
• gs.hasRole("itil_admin"): O usuário atual deve ter a função itil_admin.

OU esta condição deve ser avaliada como verdadeira:

gs.getUserID() == current.caller_id: O usuário atual é o usuário que solicitou a mudança.

Nota:

• O objeto atual não está disponível para condições em um menu de contexto de lista. A opção de menu de contexto da lista é selecionada. Qualquer uso de current nessas 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 os botões Novo e Editar na lista relacionada ICs afetados para mudanças encerradas, copie as ações de IU m2m globais para a tabela task_ci e adicione uma condição de parent.active.
• Se você deixar um dos campos em branco especificados na declaração de condição, essa condição será padronizada como verdadeira.

Restrição de ações de IU com base em exibições de formulário

Você pode restringir as ações de IU para que apareçam somente em exibições de formulário especificadas.

Use a lista relacionada Visibilidade da ação de IU no formulário Ação de IU para restringir uma ação de IU por exibição. 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 em exibições que estão especificamente incluídas.

Exemplo: mostrar uma ação em todos os lugares, exceto na exibição Gestão de custos

Adicione uma regra de exclusão para a exibição Gestão de custos.

Figura 1. Exemplo de exibição de ação de IU de exclusão

Exemplo: mostrar uma ação nas exibições Rotina e ITIL, mas em nenhum outro lugar

Adicione regras de inclusão para as exibições Rotina e ITIL.

Figura 2. Exemplos de exibições de ação de IU de inclusão