Ações

Introdução

As ações podem ser acionadas por usuários finais para executar um conjunto de etapas. Por exemplo: ir para uma página da web, navegar para 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 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 deseja criar uma ação e selecione Nova ação....
3	Clique com o botão direito do mouse no painel de ação adicional e clique em Nova etapa - Ir para o painel.
4	Insira a expressão: dashboard(target-dashboard-ID) (em que target-dashboard-ID deve ser substituído pelo ID do painel de destino).
5	Clique em expression ao lado de Hint e insira um texto a ser exibido quando o usuário passar o mouse sobre a ação. Por exemplo 'Go to target dashboard'. (ou seja incluindo as aspas). Clique em OK.
6	Digite 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	Clique com o botão direito do mouse no gráfico no qual deseja colocar a ação e selecione Editar....
3	Vá para a guia 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 qualquer um Ação à direita ou Ação à esquerda e selecione a ação que 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	Insira 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 de ação adicional e selecione Nova etapa - Abrir URL.
6	Clique na expressão 'https://example.com' e digite um URL válido, 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 acionadas a partir 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 possui 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, aciona a ação Go_to_target_dashboard.