Leia e revise a documentação do Automation Anywhere

Automation Anywhere Automation 360

Fechar conteúdo

Contents (Conteúdo)

Abrir conteúdo

Como criar packages reutilizáveis

  • Atualizado: 5/07/2020
    • Automation 360 v.x
    • Criar
    • Espaço de trabalho RPA

Como criar packages reutilizáveis

Revise as diretrizes para entender como construir packages para reutilização.

Conheça seus dados de entrada
Ao definir campos que seu package de ação requer do usuário, forneça detalhes específicos na configuração do tipo de atributo para limitar os tipos de dados que seu package recebe.
  • Limite a entrada para reduzir a carga de verificações que precisam ser feitas quando o pacote é recebido.
  • O Javadoc inclui 34 tipos de atributos definidos, portanto, revise-os quando criar seu package para selecionar os tipos de campo apropriados.
  • Defina seu package para que ele use um valor armazenado. Por exemplo, em nome do bot, seu package está fazendo chamadas de API, verifique se o AttributeType do campo de entrada de ação para a chave de API ou um token está definido como credencial. Dessa forma, os usuários são incentivados a usar um valor armazenado no Credential Vault para dados de entrada confidenciais exigidos pelo package.
Use rótulos de forma adequada
Na anotação CommandPkg, use rótulos diferentes, node_labels (rótulos de nós) e descrições de forma adequada.
  • Use esses rótulos como breves descrições de sua ação e use apenas algumas palavras para descrever uma ação.
  • Replique o mesmo estilo de nomenclatura que é apresentado nos packages de ação padrão.
  • Cada ação é um elemento filho de um package, e o rótulo da ação é exibido junto com o ícone package no painel Ações. Use nomes curtos para descrever cada ação.
  • Documente um formato de entrada esperado para determinados campos. Use a descrição de parâmetro para a anotação @Pkg. Isso permite que os desenvolvedores de package revisem o formato, requisito ou dados que devem ser usados para um campo de entrada específico. Por exemplo:
    @Pkg(label = "Start Date", description="Date Format as MM/DD/YYYY"
Teste os componentes da unidade
Durante o desenvolvimento de package, crie testes de unidade para validar se cada componente e ação do package está funcionando como esperado.
  • Valide o comportamento da unidade de teste individual, uma única classe ou uma única ação, para garantir que ela esteja funcionando como esperado.
  • Revise e documente qualquer defeito de recurso ou funcionalidade nos estágios iniciais do processo de desenvolvimento.
Como tratar erros
Inclua o tratamento de erros na lógica do bot para garantir que todos os erros sejam tratados com tranquilidade. Se um erro não for tratado, ele poderá impedir que um executor de bot execute outras tarefas.
  • Crie mensagens de erro significativas que possam ajudar os consumidores de bot com resoluções de erro.
  • Como desenvolvedor de package, lembre-se destas recomendações:
    • Use o bloco Tentar/Capturar para acomodar um erro.
    • Use um bloco de multicaptura para encontrar erros específicos e use o BotCommandException para retornar mensagens de erro personalizadas. Por exemplo:
      //create array of 3 items
      int[] myIntArray = new int[]{1, 0, 7};
      try {
          //print 4th item in array
          System.out.println(myIntArray[3]);
          //Perform operation on first and second items in array
          int result = myIntArray[0] / myIntArray[1];
      } catch (ArrayIndexOutOfBoundsException e) {
          //Throw custom message for IndexOutofBounds
          throw new BotCommandException("The array does have the number of expected items.");
      } catch (ArithmeticException e) {
          //Throw custom message on Atithmetic Exception
          throw new BotCommandException("Math Operation Error with " + Integer.toString(myIntArray[0]) + " and " + Integer.toString(myIntArray[1]));
      }
Siga o princípio de responsabilidade única
Um package é uma coleção de ações. Cada ação dentro de um package deve ter uma única responsabilidade e essa responsabilidade deve ser encapsulada por essa ação.
  • Seguir o princípio de responsabilidade única ajuda os consumidores de seus package a implementá-los facilmente, simplifica os testes e evita modificações desnecessárias.
  • As ações que você oferece permitem que os consumidores de package personalizem a maneira como usam seu package dentro do bots, e podem ajudar seus bots a serem o mais eficiente possível.
Forneça exemplos
Ao enviar packages para a Bot Store, inclua um bot de demonstração que mostre o uso do package.
  • Use as ações do Automation 360 e permita que os consumidores do package usem essas ações para usarem as capacidades do bot.
  • Forneça sempre um bots de amostra com descrições para ajudar os consumidores de seus package com o conhecimento necessário para entender o uso adequado.
Send Feedback (Enviar Feedback)