Como usar o Activity Creator

Atividades são os blocos construtivos da automação de processos. Cada uma contém uma ação autônoma que, agrupada com outras atividades, compõe um fluxo de trabalho.

O UiPath Studio inclui uma série de 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 fornecerão a você a base para criar atividades personalizadas em apenas 5 minutos. Nesta seção, criaremos um pacote de atividades e, na próxima, o preencheremos com atividades funcionais.

O que você precisa

• Visual Studio Community/Professional/Enterprise 2022 com o desenvolvimento de desktop *.NET
• carga de trabalho 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 origens de pacotes.
• .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 criadas com sucesso.

Etapa 1: adicione a extensão do UiPath Activity Creator ao Visual Studio

Open Visual Studio and click Extensions > Manage Extensions.

In the wizard that appears, click Online and then Search (Ctrl+E) for UiPath. Download the UiPath Activity Creator extension.

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

Etapa 2: Crie um projeto da UiPath

Reopen Visual Studio and double-click Create a new project on the home screen.

On the Create a new project screen, type "uipath" in the search bar, select UiPath Standard Activity Project, and click Next.

Give your project a name. The UiPath convention is <Your company's name>.<Your product's name> (e.g. UiPath.Orchestrator). Then click Create.

Navegue até o Explorador de soluções e observe que três 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.

A atividade simples

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 MyCompany.MyProduct...) no Explorador de soluções. Em seguida, navegue até Extensões > UiPath > Adicionar atividades na barra de ferramentas. Observe que esse menu ficará 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. Create: Build one or more activities from scratch.
2. Import: Import a list of predefined activities that have been saved in a standard format.

For now, select Create.

Etapa 3: definir a atividade

Click the Add button and fill in each field as shown below. This will prepare the creator to build an activity named Addition. When ready, click the Edit button to add properties to the Addition activity.

Etapa 4: Adicionar propriedades

Isso abrirá uma nova janela Definir propriedades . Use o botão Adicionar para criar 3 propriedades como 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 Finalizar na janela de atividades. Em seguida, você verá alguns arquivos novos adicionados aos seus projetos.

Etapa 6: adicionar 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: criar o pacote

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

Na próxima tela, insira a pasta em que você deseja salvar seu 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 poder publicar diretamente do Visual Studio no UiPath Studio.

Clique em Criar perfil para continuar.

Na próxima página, renomeie sua origem de pacotes para Pacotes UiPath (ou o que você quiser) e altere a configuração para Depurar. Em seguida, 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!

Metadados do pacote

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ê precisa

• 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

Metadados do pacote

Campo	Description
PackageLicenseExpression	Um identificador SPDX da licença que você deseja usar. O padrão é 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>

Versão do pacote

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 é incrementada com cada compilação para que as atualizações possam ser feitas e depois testadas imediatamente no UiPath Studio.
• A versão é usada para criar um pacote final pronto para publicação. Depois que o desenvolvimento terminar, você pode definir 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 de pacote

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

Etapa 2: recompilar o pacote

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