Lea y revise la documentación de Automation Anywhere

Automation 360

Cerrar contenidos

Contenidos

Abrir contenidos

Construir un edificio reutilizable packages

  • Actualizado: 2021/07/06
    • Automation 360 v.x
    • Crear
    • Espacio de trabajo de RPA

Construir un edificio reutilizable packages

Revise las directrices para entender cómo construir packages para la reutilización.

Conozca sus datos entrantes
Cuando configure los campos que su acción package requiere del usuario, proporcione detalles al establecer el tipo de atributo para limitar los tipos de datos que su package recibe.
  • Limitar la entrada para reducir la carga de comprobaciones que hay que hacer cuando se recibe el paquete.
  • Javadoc incluye 34 tipos de atributos definidos, así que revíselos cuando construya su package para seleccionar los tipos de campo adecuados.
  • Configure su package para que tome un valor almacenado. Por ejemplo, en nombre del bot, su package está haciendo llamadas a la API, verifica que el AtributoTipo del campo de entrada de la acción para la clave de la API o un token se establece en credencial. De este modo, se anima a los usuarios a utilizar un valor almacenado en el Credential Vault para los datos de entrada sensibles que el package requiere.
Utilizar adecuadamente las etiquetas
En el CommandPkg utilice diferentes etiquetas, node_labels y descripciones de forma adecuada.
  • Utiliza estas etiquetas como descripciones breves de tu acción y usa sólo unas pocas palabras para describir una acción.
  • Replica el mismo estilo de nomenclatura que se presenta en la Acción por defecto packages.
  • Cada acción es un elemento hijo de un packagey la etiqueta de la acción se muestra junto con el icono package en el panel de acciones. Utiliza nombres cortos para describir cada acción.
  • Documentar un formato de entrada esperado para ciertos campos. Utilice la descripción del parámetro @Pkg de la anotación. Esto permite a los package a los desarrolladores revisar el formato, los requisitos o los datos que deben utilizarse para un campo de entrada específico. Por ejemplo:
    @Pkg(label = "Start Date", description="Date Format as MM/DD/YYYY"
Pruebas unitarias de sus componentes
Durante el package desarrollo, cree pruebas unitarias para validar que cada componente y la acción del package funcionan como se espera.
  • Validar el comportamiento de la unidad de prueba individual, una sola clase, o una sola acción, para asegurar que está funcionando como se espera.
  • Revisar y documentar cualquier defecto de funcionalidad o característica en las primeras etapas del proceso de desarrollo.
Manejo de errores
Incluya el manejo de errores en la bot lógica para asegurar que todos los errores se manejan con elegancia. Si un error no se maneja, podría impedir que un bot ejecutar otras tareas.
  • Crear mensajes de error significativos que puedan ayudar bot a los consumidores con la resolución de errores.
  • Como package desarrollador, tenga en cuenta estas recomendaciones:
    • Utilice Try/Catch para acomodar un error.
    • Utiliza un bloque de captura múltiple para encontrar errores específicos, y utiliza la función BotCommandException para devolver mensajes de error personalizados. Por ejemplo:
      //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]));
      }
Seguir el principio de responsabilidad única
A package es una colección de acciones. Cada acción dentro de un package debe tener una sola responsabilidad y esa responsabilidad debe estar encapsulada por esa acción.
  • Seguir el principio de responsabilidad única ayuda a sus package consumidores a implementarlo fácilmente, simplifica las pruebas y evita modificaciones innecesarias.
  • Las acciones que usted ofrece permiten package a los consumidores personalizar la forma de utilizar su package dentro de su botsy pueden ayudar a que su bots ser lo más eficiente posible.
Proporcione ejemplos
Al presentar packages a la Bot Store incluya una demostración bot que demuestre el uso del package.
  • Utilice las Automation 360 acciones y permitir que los package que los consumidores utilicen estas acciones para gastar sus bot capacidades.
  • Proporcione siempre muestras bots con descripciones para ayudar a sus package consumidores con los conocimientos necesarios para entender su uso adecuado.
Enviar comentarios