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

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 3 min. de leitura

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

    Antes de Iniciar

    Use as versões 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 de biblioteca de classes DOT NET Framework
      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 Localização 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 Explorador 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é Montagens > Estrutura.
    8. Selecione o conjunto montado System.AddIn para adicionar uma anotação deste suplemento.
      Figura 2. Selecionar conjunto montado System.AddIn
      Selecione o 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 e um ponto de exclamação. Por exemplo, se a entrada for Usuário, ela retornará "Olá, usuário!".
      • Métodode soma : 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
      Métodos estáticos públicos.
    12. Clique em Salvar.
    13. No painel do Explorador 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 Explorador de soluções, clique com o botão direito do mouse no projeto e selecione Abrir pasta no Explorador de arquivos.
      2. Navegar até compartimento > Depurar e copie os arquivos .dll.
      3. Acesse 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 esteja 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. Em 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 Explorador de projetos, 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 de 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. Execute as seguintes ações para usar o plug-in do usuário:
      1. No painel Caixa de ferramentas, navegue até a categoria do componente do plug-in do usuário para selecionar um método.
        Figura 4. Dois métodos que aparecem na categoria de componente do plug-in do usuário
        Dois métodos que aparecem na categoria de componente do 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á
        Saída do método DigaOlá que aparece como "Olá, usuário!".
        Figura 6. Saída do método Sum
        Saída do método Sum que aparece como "17".