Ações

Introdução

As ações podem ser disparadas por usuários finais para executar um conjunto de etapas. Por exemplo: acessar uma página da Web, navegar até outros painéis, alterar filtros etc. As ações podem ser usadas para fornecer mais interatividade em um aplicativo.

Criando uma ação

Você pode criar, por exemplo, uma ação que permite aos usuários finais ir de um painel para outro. Antes de criar uma ação para navegar para um painel, o ID do destino usado para navegar deve ser conhecido.

Siga estas etapas para localizar o ID do painel de destino.

Etapa	Ação
1	Abra o aplicativo em seu ambiente de desenvolvimento e vá para a guia Painéis.
2	Clique com o botão direito do mouse no painel para o qual você deseja navegar a partir de uma ação e selecione Editar....

A caixa de diálogo Editar painel é exibida, mostrando as propriedades do painel. Veja a ilustração abaixo.

Siga estas etapas para definir uma ação.

Etapa	Ação
1	Vá para a guia Gráfico .
2	Clique com o botão direito do mouse na tabela na qual você deseja criar uma ação e selecione Nova ação....
3	Clique com o botão direito do mouse no painel adicionar ação e clique em Nova etapa - Ir para painel.
4	Insira a expressão: dashboard(target-dashboard-ID) (onde o ID do painel de destino deve ser substituído pelo ID do painel de destino).
5	Clique em expression ao lado de Dica e insira um texto a ser exibido quando usuário passar o mouse sobre a ação. Por exemplo, 'Go to target dashboard'. (ou seja incluindo as aspas). Clique em OK.
6	Insira um nome para a ação e clique em FECHAR.

Ações Subseqüentes

Uma ação pode consistir em várias etapas. Por exemplo, após acessar um painel, uma mensagem pode ser exibida na tela. Esta seria uma ação com duas etapas. Veja a ilustração abaixo.

Uso de uma ação em um painel

Para usar a ação, ela deve ser colocada em um painel onde o usuário final clique nela.

Siga estas etapas para usar uma ação em um painel.

Etapa	Ação
1	Vá para a guia Painéis e selecione o painel no qual você deseja habilitar a ação.
2	Right click on the chart on which you want to place the action and select Edit....
3	Acesse a aba Avançado na caixa de diálogo Editar item do painel .
4	Dependendo de onde você deseja colocar o ícone, clique em none ao lado de Ação em Ação direita ou Ação esquerda e selecione a ação que você deseja colocar no painel.
5	Clique no ícone vazio ao lado de Ícone e selecione o ícone que deseja exibir para a ação na lista suspensa. Veja a ilustração abaixo.
6	Clique em OK.

A ação agora está disponível para o usuário final. Veja a ilustração abaixo.

Quando o usuário final clicar no ícone de ação, o painel de destino será exibido e uma mensagem será exibida.

Links externos

Além da navegação interna no aplicativo, também é possível incorporar ações que se vinculem a componentes externos.

Siga estas etapas para criar uma ação para abrir uma URL.

Etapa	Ação
1	Vá para a guia Dados e clique na tabela Globals .
2	Clique com o botão direito do mouse em Globals na lista de atributos e selecione New action….
3	Digite um nome no campo Nome.
4	Clique em expression ao lado de Dica e insira um texto a ser exibido quando usuário passar o mouse sobre a ação. Por exemplo, 'Open UiPath.com' (ou seja incluindo as aspas) Clique em OK.
5	Clique com o botão direito do mouse no painel adicionar ação e selecione Nova etapa - Abrir URL.
6	Clique na expressão 'https://example.com' e insira uma URL válida, como por exemplo, 'https://uipath.com/' (ou seja incluindo as aspas) Clique em OK e FECHAR.

Use uma ação em um painel HTML

As ações podem ser disparadas de um painel HTML. Usando o atributo HTML data-mv-onclick , uma ação pode ser especificada para ser ativada quando um usuário final clicar no elemento HTML especificado. O atributo HTML data-mv-onclick tem um argumento: o UID de uma ação. Semelhante ao atributo padrão em um seletor, o UID de uma ação pode ser determinado com uid(ID_OF_ACTION).

Siga estas etapas para usar uma ação em um painel HTML.

Etapa	Ação
1	Crie um novo painel com um painel HTML .
2	Vá para a guia HTML e clique em expression ao lado de Expressão no painel Geral .
3	Insira uma expressão para definir o atributo HTML data-mv-onclick . Veja o exemplo abaixo.
4	Clique em OK.

<<<<
<div
    data-mv-onclick=">>>> + uid(Go_to_target_dashboard) + <<<<"
>
    
        Click to go to target dashboard.
    
</div>
>>>>

Isso cria um painel HTML que, quando clicado, dispara a ação Go_to_target_dashboard.