studio
2023.4
false
- Notas de Versão
- Introdução
- Configuração e Instalação
- Projetos de automação
- Sobre a publicação de projetos de automação
- Projetando automações
- Gerenciamento de pacotes de atividades
- Como definir as configurações do projeto de atividades
- Como assinar pacotes
- Governança
- Como importar entidades
- Experiência de Criação Moderna
- Vincular um projeto a uma ideia no Automation Hub
- Usando o Gerenciador de dados
- Dependências
- Tipos de fluxos de trabalho
- Comparação de arquivos
- Melhores Práticas de Automação
- Integração de controle de origem
- Depuração
- Analisador de Fluxo de Trabalho
- Sobre o Analisador de Fluxo de Trabalho
- STN MG-001 - Convenção de nomenclatura de variáveis
- STN MG-002 - Convenção de nomenclatura de argumentos
- STN MG-004 - Duplicação de Nome de Exibição
- STN MG-005 - Variável substitui variável
- STN MG-006 - Variável substitui argumento
- STN MG-008 - Comprimento de variável excedido
- STN MG-009 - Variáveis Catablema de prefixo
- STN MG-011 - Argumentos Catablema de prefixo
- STN MG-012 - Valores padrão de argumentos
- STN MG-016 - Comprimento do argumento excedido
- SR-DB-002 - Contagem alta de argumentos
- SR-DB-003 - Esvaziar bloco catechu
- SR-DB-007 - Múltiplas camadas Com fluxograma
- SR-DB-020 - Propriedades de saída indefinidas
- SR-DB-023 - Fluxo de trabalho vazio
- SR-DB-024 - Verificação da atividade Persistente
- SR-DB-025 - Pré-requisito de serialidade de variáveis
- SR-DB-026 - Uso da atividade Dela
- SR-DB-027 - Melhores práticas de persistência
- SR-DB-028 - Pré-requisito de serialidade de argumentos
- SR-US-005 - Argumentos de atividades embutidos em código
- SR-US-009 - Variáveis não utilizadas
- SR-US-010 - Dependências não utilizadas
- SR-US-014 - Restrições de pacotes
- SR-US-020 - Mensagens de logue mínimas
- SR-US-024 - Não utilizado e postergado
- SR-US-025 - Uso incorreto do valor salvo
- SR-US-026 - Restrições da atividade
- SR-US-027 - Pacotes necessários
- ST-USG-28 — restringir modelos de invocação de arquivos
- ST-USG-032 — rótulos obrigatórios
- ST-USG-034 — URL do Automation Hub
- Variáveis
- Argumentos
- Namespaces Importados
- Automação assistida baseada em gatilho
- Gravação
- Elementos de Interface Gráfica
- Fluxo de controle
- Seletores
- Repo. de Objetos
- Extração de Dados
- Automação de imagem e texto
- Automação de Tecnologias Citrix
- Automação RDP
- Automação da Salesforce
- Automação SAP
- Automação do Varear Horizonte
- Geração de logs
- A ferramenta ScreenScrapeJavaSupport
- O protocolo Servodrive
- Test Suite — Studio
- Extensões
- Solução de problemas
- Sobre a solução de problemas
- Suporte e limitações do Microsoft Apo-V
- Solução de problemas do Internet Explorer x64
- Problemas do Microsoft Office
- Como identificar elementos de EU em PDF com opções de acessibilidade
- Reparando o suporte da Active Accessibility
- Automação de aplicativos em execução com um usuário diferente do Windows
- Validation of large Windows-legacy projects takes longer than expected
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.
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.
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.
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.
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:
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 Interrompe todos os gatilhos locais que escutam eventos na máquina do usuário. 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.
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
- Atributos - Obtenha os atributos do elemento de destino monitorado
- DisplayDpiScaleFactor - Determinar o tamanho do elemento de destino em pixels
- ImageBase64 - Converta a imagem do elemento de destino em uma imagem Base64
- Seletor - Recupera informações sobre o seletor usado no elemento de destino
- Tipo do Gatilho
- 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
- 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.
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.
