Lire et examiner la documentation Automation Anywhere

Automation Anywhere Automation 360

Fermer les contenus

Contenus

Ouvrir les contenus

Créer des packages réutilisables

  • Mis à jour le : 11/30/2020
    • Automation 360 v.x
    • Création
    • Espace de travail RPA

Créer des packages réutilisables

Passez en revue les directives pour comprendre comment développer des packages réutilisables.

Connaissez vos données entrantes
Lorsque vous définissez les champs que votre package d’action requiert de l’utilisateur, fournissez des détails dans la définition du type d’attribut pour limiter les types de données que votre package reçoit.
  • Limitez les entrées pour réduire la charge des vérifications qui doivent être effectuées lorsque le package est reçu.
  • Javadoc inclut 34 types d’attributs définis : passez les en revue lorsque vous créez votre package pour sélectionner les types de champs appropriés.
  • Configurez votre package pour qu’il prenne une valeur stockée. Par exemple, si votre package effectue des appels d’API pour le compte du robot, vérifiez que l’ AttributeType du champ d’entrée d’action pour la clé d’API ou un jeton est défini sur Informations d’identification. De cette façon, les utilisateurs sont encouragés à utiliser une valeur stockée dans le Credential Vault pour les données d’entrée sensibles requises par le package.
Utilisez les libellés de façon appropriée
Dans l’annotation CommandPkg, n’hésitez pas à utiliser des libellés, des node_labels et des descriptions à bon escient.
  • Utilisez ces libellés pour décrire brièvement votre action en quelques mots.
  • Reproduisez le même style de dénomination qu’il est présenté dans l’Action par packagesdéfaut.Utilisez la même convention de nommage que dans les Actions par défaut.
  • Chaque action est un élément enfant d’un package, et le libellé d’action s’affiche avec l’icône du package dans le volet Actions. Utilisez des noms courts pour décrire chaque action.
  • Documentez un format d’entrée attendu pour certains champs. Utilisez la description du paramètre pour l’annotation @Pkg. Cela permet aux développeurs de package d’examiner le format, les exigences ou les données qui doivent être utilisées pour une zone de saisie spécifique. Par exemple :
    @Pkg(label = "Start Date", description="Date Format as MM/DD/YYYY"
Tests unitaires des composants
En développant votre package, créez des tests unitaires pour valider que l’action du package et tous ses composants fonctionnent comme prévu.
  • Validez le comportement de chaque test unitaire, classe ou et action pour vous assurer qu’il fonctionne comme prévu.
  • Examinez et documentez tout défaut de caractéristique ou de fonctionnalité dès les premiers stades de votre processus de développement.
Gestion des erreurs
Incluez la gestion des erreurs dans la logique du robot pour vous assurer que toutes les erreurs sont traitées correctement. Si une erreur n’est pas gérée, elle peut empêcher un robot runner d’exécuter d’autres tâches.
  • Créez des messages d’erreur significatifs qui peuvent aider les consommateurs de votre robot à résoudre les erreurs.
  • En tant que développeur de package, gardez à l’esprit les recommandations suivantes :
    • Utilisez un bloc Try/Catch pour traiter une erreur.
    • Utilisez un bloc multi-catch pour rechercher des erreurs spécifiques et utilisez 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]));
      }
Suivez le principe de responsabilité unique
Un package est un ensemble d’actions. Chaque action dans un package doit avoir une seule responsabilité et cette responsabilité doit être encapsulée par cette action.
  • Suivre le principe de responsabilité unique aide les consommateurs à implémenter facilement votre package, simplifie les tests et évite les modifications inutiles.
  • Les actions que vous proposez permettent aux consommateurs de votre package d’optimiser l’efficacité de leurs robots et de personnaliser la façon dont ils utilisent votre package dans leurs robots.
Donnez des exemples
Lorsque vous soumettez des packages au - Bot Store, incluez un robot de démo qui illustre l’utilisation du package.
  • Utilisez les actions de Automation 360 et autorisez les consommateurs de votre package à utiliser ces actions pour étendre les capacités de leur robot.
  • Fournissez toujours des exemples de robots avec des descriptions pour aider les consommateurs de votre package à comprendre son utilisation correcte.
Envoyer le commentaire