Comentarios
Como en un lenguaje de scripts, en ACLScript puede agregar comentarios usando la palabra clave COMMENT. 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ínease ignora todo el texto que sigue a COMMENT hasta llegar al final de la línea
- bloques de comentarios de varias líneascomienzan 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 *** the start date for the analysis period
v_Start_Date = `20150101`
Bloques de comentarios de varias líneas
Utilice bloques de comentarios de varias líneas para describir scripts o secciones de scripts.
COMMENT
**********************
** This section of the script prepares data for import
**********************
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
************************************************************
*** Script Name: {App_ID}{Script name}
*** Parameters: {Detailed description}
*** Output: {Describe parameters}
*** Written By: {Name}, ABC Corporation, {Month YYYY}
*** Modified By: {Name}, ABC Corporation, script purpose and logic
*** Version: 1.1.1 {app_ver.script_ver.defect.fix}
************************************************************
END