Comentarios

Como en un lenguaje de scripts, en ACLScript puede agregar comentarios usando la palabra claveCOMMENT. Utilice los comentarios para que el código sea más fácil de comprender y para comunicarse con cualquier persona que intente leer, utilizar o comprender su script.

Tipos de comentarios

ACLScript admite dos tipos de comentarios:

  • comentarios de una sola línea se ignora todo el texto que sigue a COMMENT hasta llegar al final de la línea
  • bloques de comentario de varias líneas comienzan con COMMENT y se ignora cada una de las líneas siguientes hasta llegar a la palabra clave END o una línea en blanco

Comentarios de una sola línea

Utilice comentarios de una sola línea para describir los pasos individuales de su script o para describir las variables:

COMMENT *** la fecha de inicio para el período de análisis
v_fecha_de_inicio = `20170701`

Bloques de comentarios de varias líneas

Utilice bloques de comentarios de varias líneas para describir scripts o secciones de scripts.

COMMENT
**********************
Esta sección del script prepara los datos para la importación
**********************
END

Bloques de comentario de encabezado

Es una práctica recomendable incluir, al principio de cada script, un bloque de comentario de encabezado que contenga información del script clave:

COMMENT
************************************************************
*** Nombre del script:   {ID_App}{Nombre del script}
***Parámetros:    {Descripción detallada}
***Salida:        {Describir los parámetros}
*** Escrito por:    {Nombre}, ABC Corporation, {Mes AAAA}
*** Modificado por:   {Nombre}, ABC Corporation, finalidad y lógica del script
*** Versión:       1.1.1 {ver_app.ver_script.defecto.fix}
************************************************************
END
Guía de creación de scripts de ACL 14.1