Using The Activity Creator

As atividades são os elementos básicos da automação de processos. Cada uma contém uma ação atômica que, empilhada com outras atividades, compõe um fluxo de trabalho.

O UiPath Studio inclui várias atividades pré -construídas que você pode instalar por meio do Gerenciador de Pacotes.

Além disso, você pode criar suas próprias atividades personalizadas específicas para suas necessidades usando a extensão Activity Creator da UiPath para Visual Studio. As etapas abaixo darão a você a base para criar atividades personalizadas em 5 minutos. Nesta seção, criaremos um pacote de atividades e, na próxima, o preencheremos com atividades funcionais.

O que você precisará

• Visual Studio Community/Professional/Enterprise 2022 com a carga de trabalho de desenvolvimento de área de trabalho .NET instalada
• Feed do UiPath Marketplace (https://gallary.uipath.com/api/v3/index.json) como uma origem de pacote no Visual Studio. Consulte aqui para obter instruções sobre como adicionar fontes de pacote.
• .NET 6
• UiPath Studio

Importante:

Observe que a versão 4.0 do Criador de Atividades funciona apenas com o Visual Studio 2022. Da mesma forma, as atividades produzidas visam projetos .NET 6 do Windows. Para criar atividades compatíveis com versões mais antigas do Visual Studio ou .NET, use a versão 3 da extensão.

Além disso, as atividades criadas por essa extensão dependem de bibliotecas feitas pela UiPath atualmente disponíveis no feed do Marketplace (https://gallary.uipath.com/api/v3/index.json). Esse feed deve estar disponível no Visual Studio durante o desenvolvimento, ou as atividades não serão compiladas com sucesso.

Etapa 1: Adicionar a Extensão Criador de UiPath Activities ao Visual Studio

Abra o Visual Studio e clique em Extensões > Gerenciar Extensões.

No assistente exibido, clique em Online e, em seguida, Pesquisar (Ctrl+E) para UiPath. Baixe a extensão do UiPath Activity Criador .

Close Visual Studio and, once the VSIX Installer appears, complete the installation.

Etapa 2: Criar um projeto do UiPath

Reabra o Visual Studio e clique duas vezes em Criar um novo projeto na tela inicial.

Na tela Criar um novo projeto , digite "uipath" na barra de pesquisa, selecione UiPath Standard Activity Project e clique em Avançar.

Dê um nome ao seu projeto. A convenção do UiPath é <Your company's name>.<Your product's name> (por exemplo, UiPath.Orchestrator). Então clique em Criar.

Navegue até o Explorador de Soluções e observe que 3 projetos, uma pasta compartilhada e muitos arquivos foram adicionados à solução. Essa é a base de todos os pacotes de atividades.A Atividade Simples para adicionar sua primeira atividade.

The Simple Activity

Agora que você criou o pacote, vamos adicionar uma atividade a ele. Neste exemplo, você criará a atividade mostrada acima: uma atividade simples que adiciona dois números.

O que você precisará

• Visual Studio Community/Professional/Enterprise (2019 obrigatório)
• UiPath Studio
• Using The Activity Creator

Etapa 1: abrir o criador de atividades

Comece abrindo a solução do Visual Studio criada na seção anterior e selecione qualquer um dos projetos principais (esses são os rotulados como MyCompany.MyProduct...) no Explorador de Soluções. Navegue até Extensões > UiPath > Adicionar Atividades na barra de ferramentas. Esse menu estará desabilitado até que um dos projetos seja selecionado.

Etapa 2: criar uma atividade

Isso abrirá uma nova janela do Criador de atividades. A primeira tela oferece duas opções:

1. Criar: crie uma ou mais atividades do zero.
2. Importar: importe uma lista de atividades predefinidas que foram salvas em um formato padrão.

Por enquanto, selecione Criar.

Etapa 3: definir a atividade

Clique no botão Adicionar e preencha cada campo conforme mostrado abaixo. Isso preparará o criador para criar uma atividade chamada Adicional. Quando estiver pronto, clique no botão Editar para adicionar propriedades à atividade Add.

Etapa 4: adicionar propriedades

Isso abrirá uma nova janela Definir propriedades . Use o botão Adicionar para criar 3 propriedades conforme mostrado abaixo.

Certifique-se de que as duas primeiras sejam entradas e a última seja uma saída. Essas propriedades representarão dois números e a soma deles.

Etapa 5: gerar a atividade

Clique em OK na janela Propriedades e Concluir na janela de atividades. Em seguida, você verá alguns novos arquivos adicionados aos seus projetos.

Etapa 6: adicione funcionalidade

Abra o arquivo Addition.cs que acabou de ser criado e expanda a região Protected Methods dentro dele para revelar o método ExecuteAsync da atividade. Esse é o método chamado sempre que a atividade é executada no UiPath Studio.

Observe que as duas entradas criadas na etapa 4 (Primeiro Número e Segundo Número), bem como a saída (Soma) já foram adicionadas a este método. A etapa final é preencher a lacuna entre elas substituindo o bloco de comentários por um código que adicione as duas entradas e defina o resultado como Soma. Veja abaixo:

Etapa 7: compilação do pacote

No Solution Explorer, clique com o botão direito do mouse no seu projeto do Design e selecione Publicar. Essa opção cria seus projetos, empacota-os e envia o pacote para onde você quiser.

Na tela seguinte, insira a pasta em que você deseja salvar o pacote de atividades. É uma boa ideia escolher uma de suas origens de pacote do UiPath Studio (você pode encontrá-las em Configurações > Gerenciar Origens na página inicial do Studio) para que você possa publicar diretamente do Visual Studio no UiPath Studio.

Clique em Criar perfil para continuar.

Na página seguinte, renomeie a origem do pacote para Pacotes UiPath (ou o que você quiser) e altere a configuração para Depurar. Clique em "Publicar".

Para obter mais informações sobre configurações de Depuração vs. Versão, consulte Metadados de Pacote.

Sua saída mostrará que todos os três projetos foram criados com sucesso e o pacote resultante foi publicado. Agora você tem um pacote de atividades funcionando!

Etapa 8: Usar suas atividades no UiPath Studio

Abra o UiPath Studio, navegue até o Gerenciador de Pacotes e adicione sua atividade definida ao fluxo de trabalho.

Observe que uma nova categoria foi adicionada ao painel de Atividades.

Fácil assim! Experimente sua atividade nova!

Package Metadata

Olhando para o pacote de atividades criado neste tutorial, você verá vários placeholders onde informações como o autor, licença, ícone, etc. devem ir. Vamos personalizar o pacote substituindo esses placeholders por informações reais.

O foco desta seção será o projeto Design, que contém todas as informações do seu pacote.

O que você precisará

• Visual Studio Community/Professional/Enterprise (2019 obrigatório)
• UiPath Studio
• Using The Activity Creator

Etapa 1: Abrir o projeto de design

Abra o projeto MyCompany.MyProduct.Activities.Design clicando duas vezes nele. Observe que há três seções rotuladas:

• Package Metadata
• Versões do Pacote
• Ícone do Pacote

Package Metadata

Campo	Description
PackageLicenseExpression	Um identificador SPDX da licença que você deseja usar. O padrão é Apache 2.0.
Description	Uma breve descrição das atividades que serão exibidas no Gerenciador de Pacotes do UiPath Studio.
Authors and Company	O autor e o proprietário do pacote, respectivamente.
Copyright	O aviso de direitos autorais padrão.
PackageTags	Uma lista de termos que os usuários podem pesquisar para encontrar seu pacote.
PackageProjectUrl	Um link para a documentação das suas atividades ou a página inicial da empresa.
PackageIconUrl	Um link para um arquivo de imagem usado como ícone do pacote. Observe que a tag PackageIcon atualmente não é compatível com o UiPath Studio.

<PropertyGroup>
    <PackageRequireLicenseAcceptance>true</PackageRequireLicenseAcceptance>
    <PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>
    <Description>A package used to perform simple arithmetic operations in UiPath Studio.</Description>
    <Authors>My Company</Authors>
    <Company>My Company</Company>
    <Copyright>@ 2020 My Company</Copyright>
    <PackageTags>UiPath Activity MyCompany MyProduct Math Addition Arithmetic</PackageTags>
    <PackageProjectUrl>https://docs.uipath.com/integrations/docs/how-to-create-activities</PackageProjectUrl>
    <PackageIconUrl>https://raw.githubusercontent.com/NuGet/Samples/master/PackageIconNuspecExample/icon.png</PackageIconUrl>
    ...
</PropertyGroup>

Package Version

Observe que há duas tags PackageVersion aqui, que correspondem aos dois modos de criação de um pacote: Depurar e Versão.

• A depuração é útil durante o desenvolvimento. A versão incrementa com cada compilação para que as atualizações possam ser feitas e depois testadas imediatamente no UiPath Studio.

• Versão é usada para criar um pacote final pronto para publicação. Depois que o desenvolvimento terminar, defina a versão desejada aqui.

  <PropertyGroup Condition="'$(Configuration)' == 'Debug'">
      <PackageVersion>0.2.0.$([System.DateTime]::UtcNow.ToString(MMddHmmss)) Version</PackageVersion>
  </PropertyGroup>
    
  <PropertyGroup Condition="'$(Configuration)' == 'Release'">
      <PackageVersion>0.2.0</PackageVersion>
  </PropertyGroup>

Ícone do Pacote

Use a tag PackageIconUrl para adicionar um ícone ao seu pacote de atividades. Neste exemplo, um ícone de exemplo é usado.

Etapa 2: recompilação do pacote

Recrie o pacote e importe para o UiPath Studio como na seção anterior. Abra o Gerenciador de Pacotes e observe como seu pacote tem um novo ícone, descrição e metadados atualizados.