Guia do usuário do Studio

Última atualização 17 de dez de 2024

Visão geral

As automações Attended baseadas em gatilho podem envolver o seguinte:

Formulários – criados usando o Construtor de formulários e manipulados com o pacote Form.Activities.
Chamadas – criadas usando o Construtor de formulários e exibidas com o pacote Callout.Activities.
Gatilhos – usando os pacotes System.Activities e UIAutomation.Activities.
Variáveis globais – criadas a partir do Data Manager.

Formulários e chamadas representam um recurso central da automação Attended. Executá-los usando gatilhos permite que você crie cenários complexos. Esses cenários envolvem vários eventos acontecendo ao mesmo tempo. Além disso, a possibilidade de disparar ações com base nos valores das variáveis globais ajuda a cobrir ainda mais cenários Attended.

O diagrama abaixo mostra um processo criado usando formulários, gatilhos de evento de formulário e gatilhos de evento de aplicativo. Você também pode criar processos semelhantes com base em gatilhos e chamadas de eventos do usuário.

Pré-requisitos

Para projetar e executar automações Attended baseadas em gatilho:

Instale os seguintes pacotes de atividades:
- Form.Activities versão 23.4
- System.Activities 23.4
- UIAutomation.Activities 23.4
- Callout.Activities 23.4
Se você encontrar o seguinte erro ao tentar criar um arquivo de formulário: Não foi possível localizar uma instalação Webview2 Runtime compatível para hospedar WebViews, instale o Microsoft Edge WebView2.

Formulários

A finalidade dos formulários na automação Attended é coletar e processar a entrada do usuário ou do aplicativo. Com os recursos de formulário atuais, você pode:

Criar formulários fora das atividades, usando um formulário (arquivo uiform) dentro do seu projeto. Posteriormente, você pode compilá-los ou editá-los independentemente de qualquer atividade que use os formulários. Isso permite separar o processo de criação de formulários e depois usá-los na mesma automação.
Criar formulários usando arquivos HTML personalizados. Você pode trabalhar com formulários HTML da mesma forma que faz com arquivos uiform.
Exibir vários formulários ao mesmo tempo, usando a atividade Show Form. Adicionar várias atividades Show Form e fornecer um nome exclusivo no campo Nome da Instância para cada uma delas. A propriedade Nome da Instância está disponível para a maioria das atividades no pacote Form.Activities e pode ser usada para:
- Mostrar ou executar ações em várias instâncias do mesmo formulário, fornecendo nomes de instância exclusivos para cada formulário exibido.
- Mostrar ou executar ações em todas as instâncias, deixando o campo Nome da Instância vazio.
Definir um gatilho para iniciar com base em eventos de formulário. Esses eventos podem representar um formulário que fecha ou um determinado componente do formulário que muda. Você pode conseguir isso usando a atividade Form Event Trigger.
Escolher exibir apenas um formulário ou exibi-lo enquanto o restante do fluxo de trabalho estiver em execução. Você pode fazer isso habilitando ou desabilitando a propriedade Continuar execução do fluxo de trabalho.
Editar e buscar valores de formulário no runtime, usando as atividades Set Form Values e Get Form Values.
Alterar as propriedades do formulário no runtime, usando a atividade Change Form Properties
Injetar JavaScript personalizado no formulário, usando a atividade Run Form Script.

Textos Explicativos

A função das chamadas na automação Attended é direcionar o usuário para um elemento de interface gráfica específico dentro de um aplicativo, site, produto ou até mesmo um formulário. Você também pode usar chamadas para criar validações personalizadas para aplicativos, pré-preencher campos e disparar várias automações com base na entrada do usuário.

Com recursos de chamada, você pode:

Criar uma chamada usando um arquivo de formulário (uiform) e projetá-lo usando o Construtor de formulário.
Indicar o elemento de interface gráfica ao lado de onde deseja que o texto exlicativo seja exibido usando a atividade Show Callout.
Passar valores para os elementos dentro de uma chamada.

Observação: uma chamada é um formulário vinculado a um elemento de interface gráfica e exibido ao lado dele, usando a atividade Show Callout.

Embora exista um pacote Callout.Activities dedicado a chamadas, também é possível lidar com chamadas usando o pacote Form.Activities, uma vez que chamadas são arquivos uiform como formulários normais. Isso significa que você pode trabalhar com chamadas da mesma maneira que você trabalharia com um formulário normal se estiver usando o pacote Form.Activities.

Gatilhos

A finalidade dos gatilhos na automação Attended é:

Para iniciar fluxos de trabalho com base em eventos de aplicativo ou usuário. Além disso, você pode especificar como executar ações quando um gatilho é disparado, por meio do modo de agendamento:

Sequencial — as ações são executadas uma após a outra.
Simultânea a execução de ações pode se sobrepor.
UmaVez - executa uma Actions e sai do monitoramento.
Colapso sequencial - Ignora todos os eventos futuros, exceto o mais recente, até que o evento atual termine a execução.
Queda sequencial - Interrompe a execução do evento anterior e inicia o próximo evento.

Para disparar fluxos de trabalho com base em eventos de aplicativo ou usuário, use as seguintes atividades:

Atividade	Description
Gatilho de evento do formulário	Dispara fluxos de trabalho com base em um evento que ocorre dentro de um formulário.
Application event trigger	Configura um gatilho com base em um evento nativo de qualquer tipo de elemento (janela de nível superior ou qualquer outro elemento de interface gráfica).
Repetir gatilho	Esta atividade permite configurar um TimeSpan como um InArgument. Quando o intervalo de tempo expira, o gatilho é executado e pode ser repetido com base nas configurações.
Keypress Event Trigger	Define um gatilho de evento com a tecla pressionada no elemento de interface gráfica indicado.
Click Event Trigger	Define um gatilho de evento de clique no elemento de interface gráfica indicado.
Hotkey Trigger	Monitora um evento de tecla especificado em todo o sistema.
Mouse Trigger*	Monitora uma combinação de mouse e tecla especificada em um evento em todo o sistema.
Click Image Trigger*	Monitora a Imagem definida pelo elemento de interface gráfica de destino para a entrada do mouse.
System Trigger*	Monitora um evento de tecla e/ou mouse especificado em todo o sistema.
SAP Session Attributes Change Trigger*	Monitora alterações em atributos de sessão SAP especificados.

* - Pode ser usado sozinho e dentro de uma atividade Trigger Scope.

Para automatizar vários cenários Attended que podem acontecer uma vez, em sequência ou ao mesmo tempo. Você pode conseguir isso usando as seguintes atividades:

Atividade	Description
Executar Gatilhos Locais	Inicializa e inicia todos os gatilhos locais que escutam eventos na máquina do usuário.
Parar Gatilhos Locais	Encerra a execução dos gatilhos locais. Quando executada, cancela todas as ações em andamento, incluindo fluxos de trabalho acionados por eventos. Quando a atividade Stop Local Triggers é executada, os fluxos de trabalho acionados por eventos em curso são cancelados, mas as atividades no fluxo de trabalho principal continuam como de costume.
Desabilitar Gatilho Local	Desabilita um ou mais gatilhos locais ativos que foram iniciados anteriormente com a atividade Run Local Triggers.
Habilitar Gatilho Local	Habilita um ou mais gatilhos locais ativos que foram iniciados anteriormente com a atividade Run Local Triggers.

Para iniciar fluxos de trabalho com base no comportamento de variáveis globais, que você cria no Data Manager. Você pode conseguir isso usando as seguintes atividades:

Atividade	Description
Gatilho de variável global alterada	Envia uma notificação a todos os assinantes quando o valor de uma variável global muda.
Notify Global Variable Changed	Gatilho que inicia quando o valor de uma variável global muda.

Executar Gatilhos Locais

A atividade Run Local Triggers permite disparar vários eventos simultaneamente. No back-end, ele gera um fluxo de trabalho somente leitura separado chamado Triggereventargs no Runtime ou durante a depuração. Este fluxo de trabalho contém várias atividades Escopo de gatilho que executam todos os gatilhos em paralelo dentro de seu projeto.

Ao executar o projeto pela primeira vez, cada fluxo de trabalho de gatilho captura o fluxo de trabalho Triggereventargs como um argumento no painel Argumentos . Cada fluxo de trabalho de gatilho tem seu próprio argumento Triggereventargs , que contém informações sobre si mesmo. Conforme você executa o projeto, os argumentos Triggereventargs são atualizados com as informações de execução mais recentes.

O argumento Triggereventargs fornece principalmente as seguintes informações, específicas para cada fluxo de trabalho de gatilho:

Tipo do Gatilho
Nome do gatilho
Elemento de destino que disparou o gatilho
Componentes de formulário (no caso da Atividade Form Trigger)
Nome da instância de Form (no caso de Form Trigger Activity)

Para acessar as informações do argumento Triggereventargs , você pode aplicar vários métodos com base no tipo de gatilho. Para gatilhos de evento do usuário, os seguintes métodos estão disponíveis:

TargetElement - obtenha informações sobre o elemento de destino monitorado
1. Atributos - Obtenha os atributos do elemento de destino monitorado
2. DisplayDpiScaleFactor - Determinar o tamanho do elemento de destino em pixels
3. ImageBase64 - Converta a imagem do elemento de destino em uma imagem Base64
4. Seletor - Recupera informações sobre o seletor usado no elemento de destino
Tipo do Gatilho

Para gatilhos de formulário, você pode usar os seguintes métodos:

IdDeOrigemDoFormulário - Acesse o ID do formulário onde o gatilho foi disparado
Nome da instância - Recupere o nome da instância do formulário no qual o gatilho foi disparado

Comportamento do gatilho

Fluxos de trabalho de gatilho são fluxos de trabalho que começam com um gatilho. Estes podem ser depurados no contexto de todo o projeto ou de forma independente.
Se você acha que um grande número de gatilhos afeta o desempenho, você pode habilitar ou desabilitar gatilhos específicos, usando as atividades Enable Local Trigger e Disable Local.
As atividades Enable Local Trigger e Disable Local Trigger são úteis em cenários em que você tem vários fluxos de trabalho monitorando eventos de usuários, determinados pela fase na automação que o usuário alcançou.
- Por exemplo, você pode usar a atividade Enable Local Trigger para ativar um gatilho após o usuário ter inserido seu nome de usuário em um formulário.
- Por outro lado, a atividade Disable Local Trigger pode ser utilizada para desativar um gatilho que foi programado para ser executado sequencialmente após o usuário ter atingido uma etapa específica durante um tour guiado de um produto, por exemplo.

Variáveis globais

A finalidade das variáveis globais na automação Attended é registrar informações sobre os eventos do usuário ou do aplicativo e, em seguida, armazená-las em uma variável que você pode usar posteriormente como entrada ou gatilho para outras atividades. Isso permite que você compartilhe dados facilmente entre vários fluxos de trabalho. Com recursos de variáveis globais, você pode:

Notificar quando o valor de uma variável global for alterado, usando a atividade Notify Global Variable Changed
Disparar um fluxo de trabalho ou atividade quando o valor de uma variável global for alterado, usando a atividade Global Variable Changed Trigger.

Nesta página