Normas y buenas practicas Agility / Creación y uso de componentes
Actualizado: 28. August 2023

RECOMENDACIONES PARA EL USO Y CREACIÓN DE COMPONENTES TASK

  • NOMBRE PROYECTO:

AT<Funcionalidad>.agtx - (Limitar a 8 caracteres el nombre de la funcionalidad)
Ejemplo: ATWeb.agtx

  • PREFIJO PARA VARIABLES

AT<Funcionalidad> (Limitar a 8 caracteres el nombre de la funcionalidad) -
Ejemplo: ATWeb

  • VARIABLES ENTRADA Y SALIDA

Despues del prefijo usar In (variables de entrada) o Out (variables de salida) segun corresponda y el acronimo del tipo de contenido de la variable.

  • Para variables de entrada tipo string:
    AT<Funcionalidad>_In_str<nombreVariable>
    Ejemplo: ATWeb_In_strURL , ATWeb_In_strFuncion , ATWeb_In_intReintentos
  • Para variables de entrada tipo boolean
    AT<Funcionalidad>_In_bool<nombreVariable>
  • Para variables de entrada tipo numericos
    AT<Funcionalidad>_In_int<nombreVariable>
  • Para variables de entrada tipo array
    AT<Funcionalidad>_In_array<nombreVariable>
  • Para variables de entrada tipo json
    AT<Funcionalidad>_In_json<nombreVariable>
  • Para variables de entrada tipo date
    AT<Funcionalidad>_In_date<nombreVariable>
  • Para variables de salida tipo string
    AT<Funcionalidad>_Out_str<nombreVariable>
  • Para variables de salida tipo boolean
    AT<Funcionalidad>_Out_bool<nombreVariable>
  • Para variables de salida tipo numericos
    AT<Funcionalidad>_Out_int<nombreVariable>
  • Para variables de salida tipo array
    AT<Funcionalidad>_Out_array<nombreVariable> ->
  • Para variables de salida tipo json
    AT<Funcionalidad>_Out_json<nombreVariable> ->
  • Para variables de salida tipo date
    AT<Funcionalidad>_Out_date<nombreVariable> ->
  • VARIABLES INTERNAS DEL TASK

Globales:
Despues del prefijo usar glb y el acronimo del tipo de contenido de la variable.
Ejemplo: ATWeb_glb_boolAbrirURL

De subproceso:
Despues del prefijo usar sp## (donde ## indica el numero del subproceso en el task) y el acronimo del tipo de contenido de la variable.
Ejemplo: ATWeb_sp01_strURL

RECOMENDACIONES

  • No usar variables con valores fijos preestablecidos (Ej. c:/Usuarios/fulanito).

  • Los task no se puede usar config.agt, variables de configuracion por parametros.

  • Los task no se puede usar variables seguras, del pasword vault.

  • Lo primero que debe hacerse es tener un nodo que valide las variables de entrada y su tipo de valor segun la funcion interna que aplique.

  • Todo subproceso interno de un TASK debe garantizar el reset (valor predeterminado) de las variables usadas en el subproceso antes de empezar.

  • Tener presente que hacia el proyecto que utiliza el componente son esperadas las variables de salida que empiezan con AT<Funcionalidad>_Out

  • No editar o sobreescribir en la logica del TASK las variables recibidas de entrada que empiezan por AT<Funcionalidad>_In; de ser necesario hacer copia de ellas.

  • Evitar que subprocesos internos del TASK, se llamen a otros subprocesos.