Criando seu Primeiro Projeto de Automação

This tutorial teaches you how to create a basic task automation project in StudioX and run it on your machine. The automation processes an Excel file which contains a column with names and generates a unicorn name for each of the names using the unicorn name generator at https://www.rpasamples.com/unicornname. Each unicorn name is then extracted from the web page and added to another column in the spreadsheet next to its corresponding name.

Antes de você começar:

• Baixe o arquivo com o projeto de automação neste tutorial usando o botão na parte inferior desta página. Extraia o arquivo e copie o arquivo ExcelFile.xlsx para Área de trabalho.
• This example uses Google Chrome, which requires the UiPath^® extension for Chrome to be installed. To install it, go to Home (StudioX Backstage View) > Tools, and then, under UiPath Extensions, click Chrome. If you want to use Edge or Firefox instead, install the extension for that browser. No extension is required if you want to use Internet Explorer.

1. Criar um novo Projeto

   1. Na Exibição Backstage do StudioX, selecione a guia Iniciar e, em seguida, Novo > Tarefa em branco.

      

      If you don't want to start from a blank project, select one of the available project templates instead. For more information, see Project Templates.

   2. Providencie a seguinte informação:

      • Name - Enter a name for the automation project. We recommend using a name that describes the automation you are going to create, as this will make it easier for you to identify this project among others later. For this example, we'll use First automation project.

      • Descrição - Opcionalmente, insira uma descrição breve para fornecer mais detalhes sobre o processo.

        

   3. (Opcional) Selecione Mostrar opções avançadas para definir as configurações do projeto. Se você não selecionar esta opção, o projeto será criado com as configurações padrão.

      • Location - Browse to a location on your hard drive where to create the process. The default location is %USERPROFILE%\Documents\UiPath.
      • Compatibility - Select the project compatibility: Windows or Cross-platform. For more information about compatibilities, see About Automation Projects.
      • Arquivo do notebook - Indique um arquivo do Excel para usar como o Notebook do projeto, um scratchpad para dados do Excel para usar no projeto. Por padrão, um arquivo chamado Project_Notebook.xlsx será criado na pasta do projeto. Você pode editar o nome do arquivo, navegar até uma pasta diferente onde criá-lo ou selecionar um arquivo do Excel existente.
      • Save for later as - Enter a name by which to refer to the Excel file in the project when an activity interacts with it. The default name is Notes.
      • Senha de acesso - Se aplicável, insira a senha necessária para abrir o arquivo.
      • Senha de edição - Se aplicável, insira a senha necessária para editar o arquivo.
      • Opções de arquivo
        • Save changes - Select this option if you want the workbook to be saved at the end of the automation. Otherwise, the file is returned to the initial state after execution. This option is not selected by default.
        • Somente leitura - Selecione esta opção se você quiser que o processo abra o arquivo no modo Somente leitura. Isso possibilita operações de extração de dados em um arquivo bloqueado para edições ou que exija senha para ser editado. Esta opção não está selecionada por padrão.

   4. Clique em Criar para criar o projeto.

      The project is created and a blank workflow is displayed in the Designer panel. You can now start building your automation by adding activities. You can add activities from the Activities panel on the left by double-clicking them or dragging and dropping them in the Designer panel, or by clicking Add activity at the center of the Designer panel.

2. Adiciona a página da web e o arquivo do Excel à automação

   1. In Chrome, navigate to https://www.rpasamples.com/unicornname.

   2. In StudioX, in the Activities panel, expand the App & Web Automation category, and then double-click the Use Application/Browser activity. The activity is added to the Designer panel.

   3. In the Use Application/Browser activity, click Indicate Application to automate, and then move the mouse pointer to the page with the unicorn name generator in Chrome. When the window is highlighted, click anywhere inside it.

      A página da web é adicionada à automação, o nome da atividade Use Application/Browser é atualizado com o navegador, a URL (a URL também é adicionada ao campo URL do Navegador) e com uma captura de tela da página da Web.

   4. In the Activities panel, select the Excel category, and then drag a Use Excel File activity and drop it inside the Use Application/Browser activity.

   5. Na atividade Use Excel File:

      • Click Browse for file to the right of the Excel file field, and then browse to the Desktop and select ExcelFile.xlsx.

      • In the field Reference as, leave the default value Excel.

        Você indicou que deseja trabalhar com o arquivo ExcelFile.xlsx que será conhecido no seu projeto como Excel.

        

3. Adicione as atividades a executar no navegador e no Excel

   1. Click Add activity inside the Use Excel File activity, and then locate and select the Repeat actions for rows in Excel range common scenario using the search box at the top of the window. You can easily find it if you start typing Repeat actions for rows In Excel.

      A For Each Excel Row activity is added to the Designer panel.

   2. Na atividade For Each Excel Row:

      • Click Plus on the right side of the In range field, and then select Excel > Sheet1 [Sheet]. Your selection is displayed in the In range field as [Excel] Sheet1.

      • Selecione Has headers para indicar que a primeira linha na seleção é uma linha de cabeçalho.

        Com isso você indica que pretende iterar todas as linhas da Planilha1 (Sheet1) do arquivo do Excel.

   3. Click Add activity inside the For Each Excel Row activity, and then locate and select the Type Into activity in the search box at the top of the window. The activity is added to the automation.

   4. Dentro da atividade Type Into:

      • Clique em Indicar destino na tela e mova o cursor para a caixa de texto Qual é seu nome? na página da web do gerador de nome de unicórnio. Quando a caixa de texto estiver realçada, clique nela. A caixa de texto será identificada como o destino, e o rótulo próximo a ela será identificado como uma âncora. Clique em Confirmar na janela Opções de Seleção para salvar a seleção. Uma imagem do destino e a âncora serão exibidos na ação Type Into.

      • Click Plus on the right side of the Type this field, and then select CurrentRow > Name.

        Você indicou que, à medida que estiver iterando pelas linhas no arquivo Excel, você deseja copiar o nome da linha atual na iteração e colá-lo na caixa de texto na página da Web.

   5. Click Add activity inside the For Each Excel Row activity, below the Type Into activity, and then locate and select the Click activity in the search box at the top of the window. The activity is added to the automation.

   6. Na atividade Click:

      • Clique em Indicar destino na tela e mova o cursor para o botão Get Name na página da web do gerador de nome de unicórnio. Quando o botão estiver realçado, clique nele. O botão será identificado como o destino. Clique em Confirmar na janela Opções de Seleção para salvar a seleção. Uma imagem do destino será exibida na atividade Click.

        Você indicou que, à medida que estiver iterando pelas linhas do arquivo do Excel, após o nome na linha atual ser copiado para a caixa de texto na página da web, você deseja clicar no botão Get Name.

   7. Click Add activity inside the For Each Excel Row activity, below the Click activity, and then locate and select the Get Text activity in the search box at the top of the window. The activity is added to the automation.

   8. Na atividade Get Text:

      • Clique em Indicar destino na tela e mova o cursor para o nome gerado (por padrão, o texto do espaço reservado [Unicorn name] na página da web do gerador de nome de unicórnio. Quando o texto estiver realçado, clique nele. O texto será identificado como o destino, mas nenhuma âncora será detectada automaticamente. Como o nome de unicórnio muda toda vez que é gerado, também precisamos adicionar uma âncora para garantir que o destino seja identificado quando o projeto for executado.

        Enquanto ainda estiver no modo de seleção, mova o cursor para o rótulo Your Unicorn Name acima do texto e, quando estiver realçado, clique nele. O rótulo será identificado como uma âncora e a janela Opções de Seleção exibe a mensagem Destino e âncoras OK. Clique em Confirmar na janela Opções de Seleção para salvar a seleção.

        Uma imagem do destino e da âncora é exibida na atividade Get Text.

      • Click Plus on the right side of the Save to field, and then select CurrentRow > Unicorn Name.

        Você indicou que, à medida que estiver iterando pelas linhas no arquivo do Excel, você deseja copiar o nome gerado na página da web para a coluna Unicorn Name na linha atual na iteração.

        

4. Execute a automação

   Clique em Salvar na barra do StudioX para salvar a automação, então clique em Executar para executar a automação.

   O arquivo do Excel será aberto e, para cada linha nele, o nome é copiado para a página da web, um nome de unicórnio será gerado e copiado para a célula correspondente no arquivo do Excel. Após a automação ser concluída, o arquivo do Excel será salvo e fechado.

   Baixe o exemplo

   Congratulations! You have just created your first automation. Next, let's go over a few tutorials to learn more about what StudioX can do.