Noções básicas de automação

Observação:

The information on this page applies to projects with the Windows and Windows - Legacy compatibilities. For information specific to designing cross-platform projects, see Cross-platform Projects in the Studio guide.

Sobre as atividades

As atividades são os blocos de construção básicos de um projeto de automação, cada um representando uma ou mais tarefas manuais que o StudioX pode automatizar. Uma sequência de atividades relacionadas, interconectadas a partir de um projeto de automação. Quando você considera automatizar um processo repetitivo, você deve primeiro dividir o processo em cada um dos passos manuais individuais que você faria, e depois identificar as atividades no StudioX que automatizam cada um deles.

Por exemplo, vamos dizer que você deseja automatizar o seguinte fluxo de trabalho:

1. Abra uma planilha.
2. Abra um aplicativo profissional
3. Copie os dados de uma célula na planilha.
4. Cole os dados copiados em um campo de um aplicativo profissional.
5. Clique em um botão no aplicativo para enviar os dados.

Quando você cria um projeto no StudioX para automatizar esse processo, você usa as seguintes atividades:

1. Use Excel File para informar a planilha que você deseja usar.
2. Use Application/Browser para informar qual aplicativo você deseja usar.
3. Type Into para selecionar o campo de entrada no aplicativo profissional em que serão copiados os dados, além da célula cujos dados você quer copiar.
4. Click para indicar em qual botão clicar para enviar os dados ao aplicativo profissional.

Nem sempre há uma relação direta entre um passo manual e uma atividade do StudioX. Como você pode ver no exemplo acima, a atividade Type Into abrange dois passos manuais, pois você a usa tanto para indicar a origem quanto o destino do texto copiado.

O Painel de Atividades

The Activities panel shows available activities that can be added to the current project. In Windows and cross-platform projects, you can see both installed and installable activities, while in Windows - Legacy projects only installed activities are visible. Installed refers to activities packages that are already part of a project, while installable refers to packages that are available to install from the Official and Orchestrator Tenant feeds. To add an activity to your automation, double-click it or drag and drop it to the desired place in the Designer panel. Adding an installable activity installs its corresponding activities package in the project.

Passar o mouse sobre uma atividade no painel exibe o pacote ao qual ela pertence e sua descrição. Para adicionar uma atividade à lista de favoritos, clique com o botão direito do mouse e selecione Adicionar aos favoritos.

Personalização do Painel de Atividades

Click the Group by button at the top of the panel to group available activities by the category they belong to or by the package they belong to. You can also clear the two options to see an ungrouped list of activities arranged alphabetically.

Click the Filter by button to filter activities based on the options below.

Para projetos do Windows e multiplataforma

• Filtrar por disponibilidade:
  • Instalado - Exibir as atividades que fazem parte dos pacotes instalados em seu projeto (este filtro não pode ser desativado)
  • Available - Show discovered activities that you can add to you project
  • Windows - Show activities that are only available in Windows projects (this filter is only available in cross-platform projects)
• Filtrar por tipo:
  • Atividades - Exibe atividades
  • Gatilhos - Exibe gatilhos
• Filter by category:
  • Developer - Show activities designed for the Studio profile.

Para projetos do Windows - Legado

• Filtrar por tipo:
  • Atividades - Exibe atividades
  • Gatilhos - Exibe gatilhos
• Filtrar por categoria:
  • Developer - Show activities designed for the Studio profile. These activities may not function as expected in the StudioX profile.

For example, if you are trying to view all Excel activities, you can select Group by Packages and deselect Group by Category.

Atividades de Contêiner

As Atividades Contêiner definem um âmbito ou conjunto de condições a serem atendidas para a execução de atividades adicionadas dentro de cada uma delas. Uma atividade de contêiner pode ser descrita como uma atividade pai que contém uma ou mais atividades filho. Exemplos de atividades de contêiner incluem:

• Resource activities - Add an application resource to the automation and make that resource available to the activities added inside them.
• For Each activities - Define a collection of items and repeat the activities added inside them once for each of those items.
• Repeat number of times - Similar to a For Each, but it repeats the activities added inside it for a specified number of times.
• If, Switch, and Check App State - Evaluate a condition and determine the flow of the automation by executing specific activities added inside them based on the result of the evaluation.
• Wait for Download - Detects a file download initiated by the activities added inside it and makes the file available in the automation.

Atividades de recursos

As atividades são agrupadas em categorias com base no aplicativo às quais elas são aplicadas. Antes de poder automatizar as tarefas que você executa em um aplicativo, você deve primeiro adicionar o recurso de aplicativo necessário à automação. As seguintes atividades adicionam recursos às suas automações:

• Use Excel File - Use a specified Excel file. The data in the Excel file is available to all the activities added inside this activity. When you configure child activities, you can select individual cells, ranges, or sheets in the file directly from StudioX.
• Use Desktop Outlook App, Use Outlook 365, and Use Gmail add a desktop Outlook, Outlook 365, and Gmail account to the automation. The emails in the account are available to all the activities added inside this activity. When you configure child activities, you can select individual folders, messages, or message fields directly from StudioX.
• Use Word File - Use a specified Word document. Add the activities to perform on the file inside this activity.
• Use Application/Browser - Use a specified desktop application or web browser page. Add the activities to perform in the application or web browser inside this activity.
• Use PowerPoint Presentation - Use a specified PowerPoint file. Add the activities to perform on the file inside this activity.
• Use OneDrive & SharePoint - Select an account to use for OneDrive and SharePoint automation. Add the related activities inside this activity.

Você pode adicionar quantos recursos sua automação necessitar. Para atividades que usam mais de um aplicativo, adicione os recursos dentro de outros recursos. Por exemplo:

• Para adicionar atividades que usam tanto dados de um arquivo do Excel quanto e-mails de uma conta do Outlook, adicione uma atividade Use Excel File dentro de uma atividade Use Desktop Outlook App e adicione as atividades comuns dentro da atividade Use Excel File.
• Para adicionar atividades que usam tanto os dados de uma página da web quanto um documento do Word, adicione uma atividade Use Application/Browser dentro de uma atividade Use Word File e depois adicione as atividades comuns dentro da atividade Use Application/Browser.

Como adicionar recursos globais à automação

Quando você adiciona um recurso à automação usando uma atividade de recurso, o recurso fica disponível apenas para as atividades adicionadas dentro da atividade de recurso. Para disponibilizar um recurso para todas as atividades em um projeto, você pode adicionar o recurso globalmente ao conectar o projeto ao recurso. Os recursos globais são gerenciados a partir do painel Gerenciador de Dados, e não adicionados como atividades ao projeto. Isso significa que a conexão do projeto a um recurso também ajuda a economizar espaço no painel Designer.

For information on how to connect a project to an Excel workbook, see Connecting a Project to an Excel File.

Como iterar por itens

Iterating refers to repeating one or more activities in your automation project for each individual item in a collection of items. To iterate through items, add one of the available For Each activities in which you define the collection, and then add the activities to repeat inside the For Each. When you configure the activities to repeat, indicate that an activity should use data from each item in the iteration by selecting the current item option from the Plus menu.

O StudioX vem com as seguintes atividades For Each:

• For Each Excel Row - Repeat one or more activities for each row in an Excel table, range, or sheet.

  A opção atual para o item é CurrentRow. Para algumas atividades, você também deve selecionar qual coluna a ser usada na linha atual.

• For Each Excel Sheet - Repeat one or more activities for each sheet in an Excel file.

  A opção atual para o item é CurrentSheet.

• For Each Email - Repeat one or more activities for each message in an Outlook folder, Gmail label, or in a selection of messages.

  A opção atual para o item é CurrentMail. Para algumas atividades, você também deve selecionar qual campo a ser usado no e-mail atual: Assunto, Corpo, Corpo como HTML, Cco, Cc, Para, De ou Prioridade.

• For Each File in Folder - Repeat one or more activities for each file in a folder on your computer.

  A opção atual para o item é CurrentFile. Você também deve selecionar qual propriedade do arquivo a ser utilizada para o arquivo atual: Tamanho, Nome, Nome completo (inclui caminho completo), Pasta, Última data de modificação, Última data de acesso, Data de criação, Somente Leitura ou Tamanho em kB.

• For Each Folder in Folder - Repeat one or more activities for each folder inside a specified folder on your computer.

  A opção atual para o item é CurrentFolder. Para algumas atividades, é preciso também selecionar qual propriedade de pasta usar na pasta atual: Name, Full Path, ou Last modified date.

Para facilitar a identificação ao configurar atividades dentro de atividades do tipo For Each, você pode renomear a opção de item atual usando um nome que descreve os itens pelos quais você está iterando.

Como configurar os dados usados por atividades

Activities can receive data as input and, upon execution, they can generate output data. You configure the data for each activity using the Plus menu available on the right side of data fields.

Depending on its purpose, an activity can have no data fields, one, or multiple data fields. The following information describes the options you can find in the Plus menu. Because the menu displays options that are relevant in the context of each field, activity, and parent activity, only a subset of the options is available for each field.

Opções para os campos de entrada

Os campos de entrada definem os dados recebidos por uma atividade usando as seguintes opções:

• Dados de recursos adicionados ao projeto:

  • Excel - Data from the Project Notebook or from an Excel file added to the automation. Select named cells, named ranges, tables, or sheets directly from the Plus menu, or select Indicate in Excel to open the workbook in Excel and indicate in it. Selecting Custom Input lets you manually enter sheet names, table names, cell addresses, or range addresses. If the activity is inside an For Each Excel Row activity, you can select the current row in the iteration.
  • Outlook / Gmail / Outlook 365 - Dados de uma conta de e-mail definida para uma atividade pai de recursos de e-mail. Você pode usar a mensagem selecionada no aplicativo do Outlook para desktop quando o projeto for executado ou, se a atividade estiver dentro de uma atividade For Each Email, o e-mail atual na iteração.
  • PowerPoint - Dados de uma apresentação do PowerPoint definida para uma atividade pai Use PowerPoint Presentation. Você pode selecionar slides, espaços reservados, slides mestre ou layouts.
  • Arquivo - Se a atividade estiver dentro de uma atividade For Each File in Folder, você pode usar as propriedades do arquivo atual na iteração.

• Text - Enter text using the built-in text builder. You can click Plus inside the Text Builder to add Excel data, mail data, or values you saved for later use to the text.

• Texto - Valor vazio - Essa opção oferece a capacidade de ter um texto vazio como um valor para casos em que você deseja acrescentar texto adicional ou atualizá-lo mais tarde.

• Número - Insira um valor numérico ou uma fórmula. As fórmulas oferecem suporte aos seguintes operadores e símbolos: + (adição), - (subtração), * (multiplicação), / (divisão), ^ (exponente, por exemplo 2^3 para 2 elevado ao cubo), ( ) (para definir a ordem das operações).

  You can click Plus inside the Numeric Calculation window to add numeric values from the project. For example, select a cell in an Excel file, or a numeric value that you saved for later use.

• Condition Builder - Add conditional statements that are used to determine what activities to execute based on whether or not the conditions are met. For example, the If activity contains a condition field, and it executes a series of activities if the condition is met and, optionally, another set of activities if the condition is not met. You create a conditional statement by selecting two values and comparing them using one of the available operators: greater than, greater than or equal, less than, less than or equal, equal to, not equal to, is empty, is not empty, is true, is false, starts with, ends with, contains, is numeric, is not numeric. You can add multiple statements and select if all of the statements or any of the statements must be true for the condition to be met.

• True / False - Adds a conditional statement. Select either True or False for fields that support conditional statements in activities such as the If activity.

• Use Variable - Use the output of another activity that you stored as a variable in the project for the current field. In certain cases, StudioX adapts the variable type so it matches the type the field requires. For example, you can use Text variables in fields that require a Number since the value is automatically converted from Text to Number. When a variable type is converted to another type, StudioX adds the new type at the end of the variable's name. In Windows and cross-platform projects, the variable selection window displays all the variables and arguments in the project, as well as properties specific to each data type. You can navigate to the desired property or use the search bar to find it. An icon next to each property indicates the type (for example, Tt for strings or 123 for numerical types). Variables that are automatically generated by StudioX for activity outputs are displayed under the activity where they were generated.

  

• Selecionar Data/Hora - Selecione uma data no calendário ou um horário (hora, minuto). Essa opção está disponível para campos de data e

• Escolher duração - Selecione uma duração (horas, minutos e segundos). Essa opção está disponível para campos de duração.

• Runtime options - Contains the Ask when run and Paste from clipboard options. Ask when run prompts for a value during project execution, This option is available for fields that accept text, numeric, date/time, or Boolean (True/False) values. Paste from clipboard uses an output value that you copied to the clipboard in another activity as input for the current field. This option is available for fields that accept text values or Excel ranges.

• Variáveis — selecione uma variável criada para uso em seletores de atividades de aplicativos ou web.

• Abrir no editor avançado - Insira expressões VB.

• Limpar valor - Limpe a seleção atual no campo.

Opções para os campos de saída

Os campos de saída definem o que fazer com os dados gerados por uma atividade usando as seguintes opções:

• Excel - Save output to the Project Notebook or an Excel file defined for a parent Use Excel File activity. Select named cells, named ranges, tables, or sheets directly from the Plus menu, or select Indicate in Excel to open the workbook in Excel and indicate in it. Selecting Custom Input lets you manually enter sheet names, table names, cell addresses, or range addresses. If the activity is inside an For Each Excel Row activity, you can select the current row in the iteration.
• Criar variável - Salve a saída para uso posterior em sua automação como uma variável. Insira o nome pelo qual se referir à variável no projeto, selecione um escopo e tipo de dados entre as seguintes opções: Texto, Número, Verdadeiro ou Falso, Número com decimais, Data e Duração. A variável criada pode ser selecionada como entrada em outra atividade.
• Runtime options - Contains the Copy to clipboard option, which saves the output to the clipboard. You can then paste the value in an input field in another activity. This option is available for fields that output text, Boolean values (True/False), numbers, or Excel ranges (for example, the Destination field in the Copy Range activity). Boolean and number values are converted to text when copied to the clipboard.
• Use Variable - Use the output of another activity that you stored as a variable in the project for the current field. In certain cases, StudioX adapts the variable type so it matches the type the field requires. For example, you can use Text variables in fields that require a Number since the value is automatically converted from Text to Number. When a variable type is converted to another type, StudioX adds the new type at the end of the variable's name. In Windows and cross-platform projects, the variable selection window displays all the variables and arguments in the project, as well as properties specific to each data type. You can navigate to the desired property or use the search bar to find it. An icon next to each property indicates the type (for example, Tt for strings or 123 for numerical types). Variables that are automatically generated by StudioX for activity outputs are displayed under the activity where they were generated.
• Renomear Variável - Renomear uma variável criada para uso posterior.
• Variáveis — selecione uma variável criada para uso em seletores de atividades de aplicativos ou web.
• Abrir no editor avançado - Insira expressões VB.
• Limpar valor - Limpe a seleção atual no campo.

Como usar a saída de uma atividade como entrada para outra atividade

Passar dados de uma atividade para outra pode ser muito útil, e até mesmo essencial ao tentar obter determinados fluxos de trabalho. O StudioX permite que você salve a saída gerada por uma atividade em variáveis e use-a como entrada em outras atividades mais tarde no projeto:

1. To save data and use it in other activities, select the Create Variable option in the Plus menu of a field that configures the output data of an activity, and enter a name for the variable (saved value). You will use this name later to identify and select the variable as input in another activity, so make sure to use a unique name that describes the variable.
   Observação:

   Determinadas atividades podem exigir que você selecione o tipo dos dados junto com o nome da variável. Selecione entre as seguintes opções: Texto, Número, Verdadeiro ou Falso, Número com decimais, Data e Duração. Selecione Opções avançadas se o tipo de dados que você precisa armazenar não for encontrado na lista.

2. To use the variable as input for another activity later in the project, select it from the Use Variable option in the Plus menu of a field that configures the input data of an activity.

Há várias situações em que essa funcionalidade pode ser útil. Aqui estão alguns exemplos:

• Uma atividade Read Text File lê e gera o conteúdo de um arquivo de texto que pode ser usado como entrada para uma atividade Append Text quando se deseja adicionar o texto a um arquivo do Word.
• Uma atividade File Exists verifica se um arquivo existe e gera o resultado (True ou False), que pode ser usado na condição de uma atividade If para determinar ações específicas a serem executadas quando o arquivo já existir.

O Painel de Propriedades

O painel Propriedades é contextual e te permite ver e editar propriedades avançadas de uma atividade selecionada. Ao selecionar várias atividades, apenas as suas propriedades comuns podem ser modificadas a partir do painel Propriedades.

O painel Propriedades está oculto por padrão. Na maioria das situações, você pode configurar as atividades usando as opções disponíveis no painel do Designer. Em projetos com compatibilidade multiplataforma, todas as propriedades das atividades estão disponíveis no cartão das atividades no painel do Designer. Isso também se aplica a algumas atividades em projetos que usam a compatibilidade do Windows.

Como gerenciar variáveis

Variables are used to store data of different types and pass it between activities in a project. All variables used in your project can be found and managed in the Data Manager panel. To edit or rename a variable, open the Data Manager panel, right-click on a variable and select Edit Variable.

Read more about variables in the Managing Your Project Data page.

Observação:

A partir do StudioX v2022.4, Valores salvos foram substituídos por Variáveis. A funcionalidade principal é a mesma, contudo, as variáveis permitem que o tipo de dados seja definido quando uma variável é criada e depois ela pode ser alterada por determinadas atividades ou manualmente pelo usuário. Os projetos criados em uma versão mais antiga do StudioX ainda usarão o sistema Valores Salvos quando abertos no StudioX v2022.4.

Como gerenciar argumentos

Arguments are used to pass data between activities in a project and can be used to integrate an workflow with other products such as UiPath^® Apps.

Once configured, you can use arguments in an activity similar to how you would use Variables (saved values). To edit or rename an argument, open the Data Manager panel, right click an argument and select Edit. Read more about arguments in the Managing Your Project Data page.

Executando as Suas Automações

Recomendamos que você execute as suas automações com frequência durante o estágio de design. Isso permite que você verifique se o projeto funciona como esperado e permite que você identifique os erros potenciais com antecedência.

Para executar uma automação, clique em Executar na faixa de opções do StudioX ou pressione F5 no seu teclado.

Você pode parar a execução do projeto clicando em Parar na faixa de opções ou pressionando F5 no seu teclado. Após o projeto ser executado, uma mensagem exibida no topo do painel Designer informa se a execução foi bem sucedida ou não.

Para executar apenas partes do seu projeto, clique com o botão direito do mouse em qualquer atividade e selecione:

• Executar até esta Atividade para executar todas as atividades no projeto anteriores à atividade.
• Executar a partir dessa atividade para executar todas as atividades no projeto começando nessa atividade.

Como executar no picture-in-picture

Se você quiser usar seu computador durante a execução do projeto sem interferência do Robô, você pode executar sua automação no modo picture-in-picture. Isso executa o projeto em outra sessão aberta em uma janela separada, permitindo que você tenha controle total do teclado, do mouse e da tela.

Para executar uma automação no picture-in-picture, clique na seta ao lado de Executar na barra de opções do StudioX e selecione Executar em PiP. Ou então, você pode pressionar F6 no seu teclado. O Robô começa a executar as atividades no projeto em uma nova janela.

Observação:

Automações que usam os recursos do Microsoft Office, não executam com sucesso em picture-in-picture se os recursos já estiverem abertos na sessão principal. Antes de executar uma automação em picture-in-picture, feche qualquer arquivo do PowerPoint, Excel ou Word que seja acessado pela automação.

Cenários Comuns

Para ajudar a acelerar o design de automação, o StudioX vem com cenários comuns, peças reutilizáveis de automação que você pode adicionar a qualquer projeto. Um cenário comum representa uma ou mais atividades agrupadas em uma ordem lógica para automatizar uma tarefa ou parte de uma tarefa.

Common scenarios are context-sensitive, which means the available options depend on where exactly you are in your automation. For example, in a Use Desktop Outlook App activity, the available common scenarios are related to Outlook tasks, such as Download email attachments. For a list of available common scenarios, see Common Scenarios Descriptions.

Para usar um cenário comum em um projeto:

1. Click the Add activity icon in the Designer panel where you want to add the scenario. The Add Activity search bar appears with a list of relevant activities and common scenarios at the top.

2. Click the common scenario you want to add. The activities in the scenario are added to the Designer panel.

3. Se necessário, configure as atividades adicionadas.

   

As tabelas a seguir descrevem os cenários comuns disponíveis no StudioX e qualquer configuração que eles possam exigir. Os cenários comuns são listados com base na atividade em que você pode adicioná-los.

Em qualquer lugar na automação

Cenário Comum	O que faz	O que você precisa configurar
Adicionar data aos nomes dos arquivos da pasta	Solicita a pasta que contém os nomes dos arquivos a serem atualizados, adiciona uma atividade Write Cell, que insere a data de hoje em uma célula no Project Notebook, e uma atividade For Each File in Folder, que itera pela pasta selecionada. Dentro de cada arquivo na pasta, outra atividade Write Cell copia o nome do arquivo atual na iteração para o Notebook e uma atividade Move File adiciona a data atual ao nome usando uma fórmula no Notebook.
Excluir pasta e subpastas	Solicita a exclusão da pasta e adiciona uma atividade Delete Folder configurada para exclusão mesmo se a pasta contiver arquivos ou subpastas.

Use Excel File

Se não for adicionado dentro de uma atividade Use Excel File, os seguintes cenários comuns podem ser usados com o Project Notebook.

Cenário Comum	O que faz	O que você precisa configurar
Mesclar intervalos	Adiciona uma atividade Append Range, que copia todos os valores em um intervalo e os anexa a outro intervalo, e uma atividade Delete Row, que remove todas as linhas duplicadas do destino depois que os dados são anexados.	Na atividade Append Range, selecione os intervalos de origem e destino. Na atividade Delete Rows, selecione o intervalo de destino.
Repetir ações nas linhas do intervalo do Excel	Adicionar uma atividade For Each Excel Row.	Selecione o intervalo a ser usado. Adicione as atividades a serem repetidas dentro da atividade For Each Excel Row.
Colar gráfico do Excel no PowerPoint Note: This scenario is available only when Use Excel File is placed inside an Use PowerPoint Presentation activity.	Adiciona uma atividade Get Chart que seleciona um gráfico de um arquivo do Excel e o copia para a área de transferência e uma atividade Paste Item into Slide que insere o gráfico Excel salvo em uma apresentação do PowerPoint.	In Get Chart , select the source chart and select Copy to clipboard in the Action field. In Paste Item into Slide , select the Slide number and the Content placeholder in the presentation.

Use PowerPoint Presentation

Cenário Comum	O que faz	O que você precisa configurar
Colar gráfico do Excel no PowerPoint Note: For this scenario to work properly, place a Use Excel File activity inside the Use PowerPoint Presentation activity before adding the scenario.	Adiciona uma atividade Get Chart que seleciona um gráfico de um arquivo do Excel e o copia para a área de transferência e uma atividade Paste Item into Slide que insere o gráfico Excel salvo em uma apresentação do PowerPoint.	In Get Chart , select the source chart and select Copy to clipboard in the Action field. In Paste Item into Slide , select the Slide number and the Content placeholder in the presentation.

Use Application/Browser

Cenário Comum	O que faz	O que você precisa configurar
Preencher formulário do Excel	Adiciona uma atividade For Each Excel Row, que contém três atividades Type Into, configuradas para copiar os dados da primeira, segunda e terceira colunas no intervalo selecionado e colá-los em três campos indicados no aplicativo de destino ou página da web. Por padrão, é usado o intervalo A1:C3 da planilha Scratchpad do Project Notebook.	Make sure the range from the Scratchpad sheet of the Project Notebook contains the data to enter in the form (by default A1:C3 ). You can add another file in a parent Use Excel File activity and/or select another range for For Each Excel Row. Indique o elemento de destino para cada atividade Type Into. Adicione ou remova atividades Type Into dependendo do número de campos no formulário.

Use Desktop Outlook App

Cenário Comum	O que faz	O que você precisa configurar
Repetir ações para e-mails	Adiciona uma atividade For Each Email.	Selecione a pasta ou mensagens a serem usadas. Adicione as atividades a serem repetidas na atividade For Each Email.
Send Email	Adiciona uma atividade Send Email.	Configure a atividade Send Email.
Fazer download de anexos do email	Solicita uma pasta na qual salvar os anexos, adiciona uma atividade Save Email Attachments e, em seguida, uma atividade For Each File in Folder, contendo uma atividade Write Line, configurada para exibir os nomes dos arquivos no painel Saída.
Backup de pasta de e-mail	Solicita uma pasta no computador na qual salvar e-mails e adiciona uma For Each Email com uma atividade Save Email dentro dela.	Selecione a pasta para fazer backup da atividade For Each Email. A Caixa de Entrada será selecionada por padrão.
Criar banco de dados de detalhes dos contatos	Adiciona uma atividade For Each Email configurada para usar os e-mails da caixa de entrada, as atividades Write Cell e Append Range dentro da atividade For Each Email para copiar os remetentes de cada e-mail para uma nova planilha de contatos no Notebook e uma atividade Delete Rows para remover duplicatas.
Copiar detalhes do email para o Excel	Adiciona uma série de atividades Write Cell que incluem os campos de e-mail como cabeçalhos de coluna em uma nova planilha chamada E-mails no Bloco de anotações do projeto. Em seguida, adiciona uma atividade For Each Email, que contém uma série de atividades Write Cell, que copiam os campos de cada e-mail na planilha Scratchpad, e uma atividade Append Range, para copiar todos os campos na planilha Emails.	Na atividade For Each Email, selecione a pasta da qual deseja obter os e-mails. A Caixa de Entrada será selecionada por padrão.
Enviar por email todos os arquivos em uma pasta	Solicita uma pasta para selecionar e adiciona uma atividade Send Email configurada para usar os arquivos na pasta selecionada como anexos. A conta atual do Outlook é adicionada por padrão ao campo De.	Edite os valores padrão adicionados aos campos da atividade para personalizar o e-mail, por exemplo, adicione um ou mais destinatários ou edite o Assunto e o Corpo.

For Each Email

Cenário Comum	O que faz	O que você precisa configurar
Reply to email	Adiciona uma atividade Reply to Email, para responder ao e-mail atual na iteração, uma atividade Mark Email as Read/Unread e uma atividade Move Email, para mover o e-mail para outra pasta.	Em Reply to Email, edite o corpo do e-mail. Na atividade Move Email, selecione uma pasta para onde mover o e-mail.
Forward email	Adiciona uma atividade Forward Email, para encaminhar o e-mail atual na iteração, uma atividade Mark Email as Read/Unread e uma atividade Move Email, para mover o e-mail para outra pasta.	Configure a atividade Forward Email. Na atividade Move Email, selecione uma pasta para onde mover o e-mail.
Move email	Adiciona uma atividade Move Email, para mover o e-mail atual na iteração para outra pasta.	Na atividade Move Email, selecione uma pasta para onde mover o e-mail.
Salvar e processar anexos de e-mail	Solicita uma pasta na qual salvar os anexos, adiciona uma atividade Save Email Attachments e uma atividade For Each File in Folder, na qual são adicionadas atividades a serem repetidas para cada anexo.	Adicione atividades a serem repetidas para cada anexo dentro da atividade Each File in Folder.

For Each File In Folder

Cenário Comum	O que faz	O que você precisa configurar
Tente abrir o arquivo como Excel	Adiciona uma atividade If que verifica se o arquivo atual na iteração tem a .xlsx extensão. A ramificação Then contém uma atividade Use Excel File que adiciona o arquivo atual ao projeto se a condição for atendida.
Adicionar data ao arquivo e mover para a subpasta	Adiciona uma atividade Create Folder, que cria uma subpasta nomeada Processed na pasta atual, uma atividade Write Cell, para copiar o nome do arquivo atual na iteração no Project Notebook, e uma atividade Move File, que move o arquivo atual para a subpasta e adiciona a data atual ao nome usando uma fórmula no Project Notebook.
Agrupar arquivos por tipo	Adiciona uma atividade Write Cell, para copiar o nome do arquivo atual na iteração para o Project Notebook, uma atividade Create Folder, que cria uma subpasta na pasta atual nomeada com a extensão do arquivo atual, utilizando a fórmula no Project Notebook, e uma atividade Move File, que move o arquivo atual para a subpasta.
Agrupar arquivos por tamanho	Adds an If activity that checks if the current file in the iteration is smaller than 100KB. The Then branch contains a Create Folder activity that creates a new folder with the title set to 100 K and a Move File activity that moves the current file in the iteration to the newly created folder. The Else branch contains an If activity that checks if the current file is smaller than 1000KB. Both the Then and Else branches contain a Create Folder and Move File activity.
Agrupar arquivos por data de criação	Adiciona uma atividade Write Cell, para copiar uma data de criação do arquivo atual na iteração para o Project Notebook, uma atividade Create Folder, que cria uma subpasta na pasta atual, nomeada com a data de criação do arquivo atual usando uma fórmula no Project Notebook, e uma atividade Move Folder, que move o arquivo atual para a subpasta.
Copiar informações do arquivo para o Excel	Adiciona uma série de atividades Write Cell que copiam o nome, caminho completo, tamanho e data de criação do arquivo atual na iteração para a planilha Scratchpad e uma atividade Append Range para copiar todos os campos para a planilha Arquivos.

Dicas e truques

Geral

• Você pode abrir arquivos do Excel, Word e PowerPoint adicionados à sua automação diretamente do painel Gerenciador de Dados. Clique com o botão direito do mouse em qualquer recurso do Excel ou Word e selecione Abrir. Você também pode selecionar Abrir local de Arquivo para abrir a pasta contendo o arquivo.

  

• If you're not sure which activity can help you automate a specific action, search through activities using either the search bar at the top of the Activities panel, or the one displayed at the top of the screen after you click Add activity in the Designer panel. Searching returns results from activity names as well as descriptions, so it can be a good way to find activities you may not have discovered yet.

  

• Quando você precisar de ajuda com uma atividade que você adicionou ao seu projeto, clique nela com o botão direito do mouse e selecione Ajuda ou selecione a atividade e então pressione F1 no seu teclado para abrir a página documentação com informações sobre como configurá-la.

• If you want to save a few clicks when designing your automations, you can double-click most activity fields to open the option in the Plus menu most commonly used to configure that field. For example, double-clicking a field that accepts text input opens the Text Builder, doing the same for the Condition field in the If activity opens the Condition Builder.

• When you select Text from the Plus menu to add text to an activity field, you can compose text that combines multiple types of data using the Text Builder. In addition to typing text, you can select other types of data from the Plus menu in the upper-right corner the Text Builder. For example, you can add the contents of a cell in an Excel file, a field in an Outlook email, or one of the properties of a file on your computer that you saved for later in a previous activity.

Automação de Interface Gráfica

• When configuring a Use Application/Browser activity to add a desktop application to the automation, if you want the automation to open a specific file, indicate the application, and then add the path to the file in the Application arguments field. For example, if you indicated Acrobat Reader as the application to automate and you want to work with the file form_template.pdf located in the C:\Work folder, enter C:\Work\form_template.pdf in the Application arguments field to open the file in Acrobat when the automation is executed.

  

• When indicating target elements of App/Web activities in web browsers, always add at least one anchor to make sure the element is correctly identified by the Robot. For more information about targets and anchors, see UI Automation.

• Ao configurar uma atividade Use Application/Browser para automatizar as tarefas que você executa em um navegador web, antes de indicar o navegador web, navegue até a página da web na qual a automação executará a primeira ação. Fazer isso adiciona automaticamente a URL da página ao campo URL do Navegador, para que você não precise inseri-la manualmente.

• If you don't want to add too many Type Into activities to fill out a form with many fields, you can simplify your workflow by configuring one Type Into activity to enter text in multiple fields. After indicating the first field on the form and selecting the text to type into it, you can open the Text Builder of the Type this field, add the tab special key from the Plus menu inside the Text Builder, and then select the text for the following field. For example, provided that the tab key moves the cursor to the next field in the target application, configuring the Type this field like in the following image copies the text from three different cells and pastes it in three different fields.

  

• Quando duas atividades de Aplicativo/Web não estão sincronizadas de forma apropriada (por exemplo, a primeira leva um tempo maior para ser executada e a segunda se inicia antes da ação anterior ter sido concluída), configure a propriedade Defasar Menos ou Defasar Mais no painel Propriedades das Atividades para garantir que a primeira seja concluída antes do início da segunda. Essas propriedades adicionam um atraso antes ou após uma atividade ser executada, aumentando o tempo entre as atividades quando necessário.

• When the actions you want to perform in a desktop application or web browser depend on the state of the application, use a Check App State activity to determine which actions to perform based on the state. This activity verifies whether an element appears in or disappears from the user interface of the target application and enables you to add different activities to execute when the element is found and/or when it is not found. For example, you can check if you are already logged in to a web application by verifying if the Log in button is present, and only perform the actions required to log in when the button is found.

Excel

• The Excel files you add to automations are not always available at design time (for example, a file can be created by or downloaded during the automation). In this scenario, you can still take advantage of StudioX's deep integration with Excel to configure the activities that use the file by defining another file with the same format (same sheets, columns, tables, etc.) as a template file. Once defined, you can indicate data in Excel or select data from the template file directly from the Plus menu. For example, if you want to create an automation with a report you'll receive monthly, use an existing report with the same format as the template. To define a template, add the Use Excel File Excel File activity, enter the path to the file to automate, then select the Template file option and indicate the file to use.
• When you want to work with a .xls (Excel 97-2003) workbook, the data in the file cannot be accessed directly from the Plus menu. In this case, you can configure activities that use the file with the Indicate in Excel or Custom input options in the Plus menu. Alternatively, to be able to select data directly from the menu, create a .xlsx copy and add it as a template file.
• When you filter rows in a large sheet and iterate through them using an Excel For Each Row activity, instead of iterating through the original sheet after applying the filter, use a Copy Range activity to copy the filtered rows to a different sheet, and then iterate through the filtered range in the new sheet. This will result in better performance when the project is executed.

Aplicativo Local do Outlook

• You can add bodies formatted as HTML for emails sent using mail activities from the desktop Outlook app by selecting the Use Word Document option for the Body field. This enables you to select a Word document containing formatted text, images, or tables as the body of emails sent with the Send Email , Reply to Email, and Forward Email activities.

  

Executando Projetos

• Se você quiser usar seu computador durante a execução do projeto sem interferência do Robot, você pode executar sua automação no modo picture-in-picture. Esse recurso permite que você execute o projeto em uma outra sessão aberta em uma janela separada, o que permite controle total do teclado, mouse e tela. Para executar uma automação no picture-in-picture, clique na seta ao lado de Executar na faixa de opções do StudioX e selecione Executar em PiP.

  

• Se você ignorou um erro ao executar um projeto antes de ler a mensagem de erro, você pode encontrar essa mensagem de erro no painel Resultado. Para acessar o painel Resultado, clique em Resultado no canto inferior esquerdo da janela StudioX.

  

• Para evitar abrir várias instâncias de um mesmo aplicativo, antes de executar uma automação, feche todos os aplicativos e arquivos que serão utilizados por ela.