Criação e exibição de uma chamada simples

Este tutorial ilustra como criar e exibir uma chamada por 10 segundos, sempre que um determinado elemento de interface gráfica aparecer durante a automação. Usaremos o aplicativo de tempo com Vento como um exemplo, em que uma chamada será exibida ao lado de seu logotipo. O conteúdo dentro da chamada usa um In argumento adicionado ao dicionário de Argumentos da atividade Show Callout .

Pré-requisitos

Esse exemplo foi criado usando os seguintes pacotes de atividades e versões:

• UiPath.Callout.Activities 25.2.0
• UiPath.System.Activities 25.2.0
• UiPath.UIAutomation.Activities 25.2.1-preview

Etapas

1. Crie o arquivo do texto explicativo:
   1. Abra seu projeto do Studio e, no menu suspenso Novo , selecione Formulário para criar um novo formulário.

      O arquivo de formulário é usado aqui como um texto explicativo.

   2. Nomeie o texto explicativo como Basic callout.
   3. No painel Componentes , expanda a seção Básico e arraste um componente de Rótulo/Cabeçalho para dentro do arquivo de texto explicativo.
   4. Salve o componente e o arquivo da chamada.
2. Abra o fluxo de trabalho Principal em seu projeto.
   1. Adicione uma atividade Use Application/Browser e insira https://www.windy.com/ no campo URL do Navegador .
   2. Adicione uma atividade Run Local Triggers . Isso habilita todos os fluxos de trabalho de gatilho e permite que eles sejam executados quando o evento de disparo ocorrer.
3. Crie um novo fluxo de trabalho chamado Show Basic Callout e adicione uma atividade Application Event Trigger .
   1. Selecione Indicar destino na tela e indique o logotipo do Vento para a automação iniciar o monitoramento.

      Para este exemplo, indicamos o logotipo Vento, que queremos monitorar.

   2. Na lista suspensa Tipo de evento , selecione Apareceu.
   3. Adicione uma atividade Show Callout .
      Esta atividade permite que você selecione um arquivo uiform , que você pode exibir para um determinado elemento de interface gráfica, assim como passar dados para o arquivo uiform , usando um dicionário de argumentos .
      1. Na lista suspensa Selecionar formulário , selecione o arquivo de texto explicativo que você criou anteriormente.
         Para esse exemplo, selecionamos Basic callout.
      2. Para o campo Elemento de Interface Gráfica , insira o elemento de interface gráfica indicado para a atividade Application Event Trigger , que é o logotipo Vento, ao qual queremos vincular a chamada.
         Para acessar esse elemento de destino, use a expressão TriggerEventArgs.TargetElement . TriggerEventArgs é um argumento aqui, que é gerado automaticamente ao adicionar uma atividade de gatilho em seu fluxo de trabalho. Neste caso, a atividade Application Event Trigger gera o argumento.
      3. Abra o dicionário de Argumentos e, no campo Valor da chave gerada, insira o texto que deseja exibir.
         Para esse exemplo, mostramos o seguinte texto: "Welcome to Windy.com!<br>(this callout will close in 10 seconds)".
   4. Adicione uma atividade Delay e defina-a para 10 segundos.
   5. Adicione uma atividade Fechar formulário para fechar o texto explicativo após 10 segundos. Na lista suspensa Selecionar formulário , selecione o arquivo de texto explicativo que você criou anteriormente (ex: Basic callout).
   6. Adicione uma atividade Stop Local Triggers para interromper a execução de todos os fluxos de trabalho de gatilho.

      Essa atividade é especialmente importante se seu projeto consistir apenas em fluxos de trabalho de gatilho. Sem incorporar essa atividade, os gatilhos serão executados persistentemente em um loop contínuo sem parar.

Resultado

A automação abre o site do Vento e aciona o fluxo de trabalho Mostrar texto explicativo básico assim que o logotipo aparece. Esse fluxo de trabalho exibe o callout por 10 segundos e depois o fecha. A seguinte imagem animada demonstra esse cenário em runtime:

Figura 1. Imagem animada mostrando o texto explicativo ao lado do logotipo da Vinda

Exemplo de fluxo de trabalho

Para verificar como as etapas neste tutorial são implementadas, baixe o seguinte projeto de exemplo: Display Callout for Window.