Criar plug-ins de usuário para Design studio de RPA para desktop

Crie plug-ins de usuário usando Microsoft Visual Studio para permitir que os desenvolvedores de RPA usem componentes .NET complexos ou bibliotecas em Design studio de RPA para desktop de maneira contínua.

Antes de Iniciar

Use a versão Microsoft Visual Studio Pro, Community ou Enterprise para executar esta tarefa.

Função necessária: nenhuma

Por Que e Quando Desempenhar Esta Tarefa

O procedimento a seguir descreve como criar um plug-in de usuário usando C#.NET.

Procedimento

1. Abra Microsoft Visual Studio e clique em Criar um novo projeto.
2. Na caixa de diálogo Criar um novo projeto, selecione o modelo Biblioteca de classes (.NET Framework).

   Figura 1. Selecione um tipo de projeto da Biblioteca de classes DOT NET Framework

   

3. Clique em Avançar.
4. Na caixa de diálogo Configurar seu novo projeto, preencha os seguintes campos:

   Campo	Descrição e ação
   Nome do projeto	Nome do seu projeto. Por exemplo, MyFirstPlugin.
   Local	Local do seu projeto. Selecione um local do disco.
   Nome da solução	Nome da solução do seu projeto.
   Estrutura	Selecione uma versão da estrutura. Selecione a versão .NET Framework 4.7.

5. Clique em Criar.
   O arquivo Class1.cs é aberto.
6. No painel do Gerenciador de soluções, clique com o botão direito do mouse em Referências e selecione Adicionar referência.
7. Na caixa de diálogo Gerenciador de referências, navegue até Conjuntos > Estrutura.
8. Selecione o conjunto System.AddIn para adicionar uma anotação deste add-in.

   Figura 2. Selecionar conjunto System.AddIn

   

9. Clique em OK.
10. No arquivo Class1.cs, adicione o snippet de código System.AddIn.AddIn("MyFirstPlugin", description = "Learning to create custom components", Version = "1.0") acima da classe.
11. No arquivo Class1.cs, crie um ou mais métodos estáticos públicos para o seu código.
    Neste exemplo, dois métodos são adicionados ao código:

    • MétodoDigaOlá : o nome é usado como entrada e retorna "Olá" com um nome seguido por um ponto de exclamação. Por exemplo, se a entrada for Usuário, ela retornará "Olá usuário!".
    • Método desoma : dois números são usados como entrada e retorna a soma desses dois números. Por exemplo, se as entradas forem 5 e 12, ele retornará "17".

    Figura 3. Métodos estáticos públicos

    

12. Clique em Salvar.
13. No painel do Gerenciador de Soluções, clique com o botão direito do mouse no projeto e selecione Criar.
14. Depois que a compilação for bem-sucedida, execute as seguintes ações para copiar e colar os arquivos .dll:
    1. No painel do Gerenciador de soluções, clique com o botão direito do mouse no projeto e selecione Abrir pasta no Gerenciador de arquivos.
    2. Navegar até bin > Depurar e copie os arquivos .dll.
    3. Vá para a pasta do projeto de automação Design studio de RPA para desktop e crie uma nova pasta como UserPlugins.
       Importante:

       Certifique-se de que a ortografia desta pasta seja inserida corretamente.
    4. Na pasta UserPlugins, crie uma pasta e insira um nome para a pasta.
       Por exemplo, MyFirstPlugin.
    5. Cole os arquivos .dll nesta pasta.
15. No Design studio de RPA para desktop, execute as seguintes ações para adicionar o plug-in ao seu projeto de automação:
    1. No painel do Project Explorer, clique com o botão direito do mouse em Plug- ins do usuário e selecione Adicionar plug-in do usuário.
    2. Na caixa de diálogo Plug-ins do usuário disponíveis, selecione o plug-in.
    3. Clique em OK.
    No painel Caixa de ferramentas, o plug-in do usuário que você criou é exibido.
16. Realize as seguintes ações para usar o plug-in do usuário:
    1. No painel Caixa de ferramentas, navegue até a categoria do componente de plug-in do usuário para selecionar um método.

       Figura 4. Dois métodos que aparecem na categoria de componente de plug-in do usuário

       

    2. Arraste um método para a superfície Design.
    3. Para fornecer o valor do parâmetro de entrada manualmente, clique duas vezes no campo do parâmetro de entrada no método e insira o valor.
    4. Para fornecer o valor do parâmetro de entrada de outro método ou componente, conecte a porta de entrada de dados do método à porta de saída de dados de outro método ou componente.
    5. Conecte as portas de controle do método às portas correspondentes de outro método ou componente.
    6. Na superfície Design, clique com o botão direito do mouse na barra de título do componente de onde você deseja iniciar a execução e selecione Executar a partir daqui.

       Figura 5. Saída do método DigaOlá

       

       Figura 6. Saída do método Sum