Lire et examiner la documentation Automation Anywhere

Automation 360

Fermer les contenus

Contenus

Ouvrir les contenus

Construction de bâtiments réutilisables packages

  • Mis à jour le : 2021/07/06
    • Automation 360 v.x
    • Créer
    • Espace de travail RPA

Construction de bâtiments réutilisables packages

Consultez les directives pour comprendre comment construire packages pour la réutilisation.

Connaître vos données entrantes
Lorsque vous définissez les champs que votre action package exige de l'utilisateur, donnez des précisions en définissant le type d'attribut afin de limiter les types de données que votre action package reçoit.
  • Limitez la saisie pour réduire la charge des contrôles à effectuer à la réception du colis.
  • La Javadoc comprend 34 types d'attributs définis, donc consultez-les lorsque vous construisez votre package pour sélectionner les types de champs appropriés.
  • Réglez votre package pour qu'il prenne une valeur stockée. Par exemple, au nom de l botvotre package effectue des appels API, vérifiez que l'attribut AttributeType du champ de saisie de l'action pour la clé API ou un jeton est défini sur justificatif. De cette manière, les utilisateurs sont encouragés à utiliser une valeur stockée dans le fichier Credential Vault pour les données d'entrée sensibles que le package nécessite.
Utiliser les étiquettes de manière appropriée
Dans le CommandPkg utilisez les différents labels, node_labels, et descriptions de manière appropriée.
  • Utilisez ces étiquettes comme de courtes descriptions de votre action et n'utilisez que quelques mots pour décrire une action.
  • Reproduire le même style de dénomination que celui présenté dans l'action par défaut. packages.
  • Chaque action est un élément enfant de l'élément packageet l'étiquette de l'action est affichée avec l'icône package dans le volet des actions. Utilisez des noms courts pour décrire chaque action.
  • Documenter un format d'entrée attendu pour certains champs. Utilisez la description du paramètre pour l'élément @Pkg pour l'annotation @Pkg. Cela permet package aux développeurs d'examiner le format, l'exigence ou les données qui doivent être utilisés pour un champ de saisie spécifique. Par exemple :
    @Pkg(label = "Start Date", description="Date Format as MM/DD/YYYY"
Testez vos composants à l'unité
Au cours du package développement, créez des tests unitaires pour valider que chaque composant et l'action de la package fonctionne comme prévu.
  • Valider le comportement de l'unité de test individuelle, d'une classe unique ou d'une action unique, pour s'assurer qu'elle fonctionne comme prévu.
  • Review and document any feature or functionality defects at early stages of the development process.
Traitement des erreurs
Incluez la gestion des erreurs dans la bot logique afin de s'assurer que toutes les erreurs sont traitées de manière élégante. Si une erreur n'est pas traitée, elle peut empêcher un bot d'exécuter d'autres tâches.
  • Créez des messages d'erreur significatifs qui peuvent aider bot les consommateurs à résoudre les erreurs.
  • En tant que package développeur, gardez à l'esprit ces recommandations :
    • Utilisez Try/Catch pour tenir compte d'une erreur.
    • Utilisez un bloc multi-catch pour trouver des erreurs spécifiques, et utilisez la fonction BotCommandException pour renvoyer des messages d'erreur personnalisés. Par exemple :
      //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]));
      }
Suivre le principe de la responsabilité unique
A package est une collection d'actions. Chaque action au sein d'un package doit avoir une seule responsabilité et cette responsabilité doit être encapsulée dans cette action.
  • Le respect du principe de responsabilité unique permet à vos package consommateurs à le mettre en œuvre facilement, simplifie les tests et évite les modifications inutiles.
  • Les actions que vous proposez permettent package aux consommateurs de personnaliser la façon dont ils utilisent votre package dans leur botset peuvent les aider à bots être aussi efficaces que possible.
Donnez des exemples
En soumettant packages au Bot Store inclure une démo bot qui démontre l'utilisation de l'outil package.
  • Utilisez les Automation 360 actions et permettre aux package consommateurs d'utiliser ces actions pour dépenser leurs bot capacités.
  • Toujours fournir des échantillons bots avec des descriptions pour aider vos package consommateurs à acquérir les connaissances nécessaires pour en comprendre le bon usage.
Envoyer le commentaire