Lea y revise la documentación de Automation Anywhere

Automation 360

Cerrar contenidos

Contenidos

Abrir contenidos

Prácticas de codificación estándar y directrices para el desarrollo de paquetes

  • Actualizado: 2022/05/19
    • Automation 360 v.x
    • Crear
    • Espacio de trabajo de RPA

Prácticas de codificación estándar y directrices para el desarrollo de paquetes

Este tema abarca las prácticas y directrices de codificación estándar que ayudan a garantizar el desarrollo de paquetes de alta calidad.

Probando
Garantizar un código de alta calidad. Escriba suficientes pruebas unitarias y de integración para su paquete.
Iconos
Establezca el icono adecuado para su paquete.
Configurar la versión manualmente
La versión de construcción del paquete SDK se actualiza automáticamente cada vez que se produce una construcción. Sin embargo, se puede establecer manualmente en el proyecto de comandos de un build.gradle común.
  • Actualizar el archivo build.gradle antes de una compilación.
  • Introduzca hasta cuatro dígitos, separados por un punto, como se muestra a continuación:

. . .
ext {
    version '2.0.8'
}
dependencies {...}
Dependencias
Incorpore todas las dependencias en su paquete JAR. Cargue las dependencias en tiempo de ejecución extrayéndolas a una ubicación temporal. Asegúrese de limpiar la ubicación temporal después de cargar las dependencias.
Archivos JAR dependientes
Añade los archivos JAR dependientes bajo dependencias en el archivo build.gradle como implementación para que los archivos JAR dependientes sean empaquetados.
	
. . .
dependencies {
		compileOnly name: 'command-annotations'
		compileOnly name: 'bot-runtime'
		compileOnly name: 'bot-api'
		implementation name: 'i18n-api'
              implementation name: 'mydependentjavafile.jar'
		apt name: 'command-processor'
		compileOnly group: 'org.apache.logging.log4j', name: 'log4j-core', version: "$loggerVersion"
		testImplementation "org.testng:testng:$testNgVersion"
		testImplementation name: 'bot-runtime'
		testImplementation name: 'bot-api'
	}
. . . 
Añadir nuevas acciones al paquete existente
Cuando añada nuevas acciones a un paquete existente, asegúrese de hacer una limpieza antes de empaquetar. Siempre es una buena práctica hacer clean build - gradlew.bat clean build shadowJar.
Mensajes de error
Proporcionar mensajes de error significativos.
  • Hacer lanzar mensajes de error significativos. Por ejemplo, en el idioma local utilizando las APIs i18n con BotCommandExceptionlanzaría una nueva excepción BotCommandException(MESSAGES.getString("Run.Exception.InvalidWorkingDirPath")).
  • No lanzar mensajes de error genéricos, como ex.mensaje.
Validación básica
Utiliza las reglas de anotación de validación, como @NotEmpty incluidas en este kit de desarrollo. No añada validaciones básicas para su código. Consulte Anotaciones de validación.
Bucles
Evite los bucles de larga duración en su código. Los bucles de larga duración pueden causar un alto uso de la CPU, dando lugar a errores como "El bot no responde".
Añadir registro
Utilizar la opción por defecto log4J proporcionado en el marco de tiempo de ejecución del bot. No añada su propio registrador. Consulte el código de ejemplo para obtener más detalles.
Niveles de registro
  • ERROR/FATAL: Evento de error grave que afecta al usuario y no hay solución.
  • ADVERTENCIA : Se ha producido un error inesperado pero el sistema se ha recuperado de él.
  • INFO: Mensajes informativos sobre el cambio de estado, por ejemplo, una solicitud aceptada.
  • DEBUG: Información de diagnóstico detallada que será necesaria para depurar cuando algo vaya mal.
  • TRACE: Se captura toda la información sobre el comportamiento de una aplicación.

    Si no está seguro del nivel de registro, póngalo en TRACE.

Carga de recursos
Todos los recursos deben ser cargados usando el cargador de clases del contexto actual del hilo, como se muestra en el siguiente ejemplo:
Thread.currentThread().getContextClassLoader().getResourceAsStream("resource.json");
Enviar comentarios