Comando COMMENT

Agrega una nota explicativa a un script sin afectar el procesamiento.

Sintaxis

Comentarios de una sola línea

COMMENT texto_comentario

Comentarios de varias líneas

COMMENT 
  texto_comentario 
   <...n> 
<END>

Nota

No utilice el carácter de acento circunflejo ^ para anteceder líneas del texto de comentario. El acento circunflejo tiene un uso especial en el archivo de proyecto de .acl y el texto de comentario no se guarda si se antepone un acento circunflejo.

Parámetros

Nombre Descripción
texto_comentario

El comentario que agrega.

  • comentario de una línea escriba el texto del comentario completo sin un salto de línea
  • comentario de varias líneas escriba tantas líneas de texto de comentario como sea necesario comenzando por la línea que sigue inmediatamente al comando COMMENT

    Finalice un comentario de varias líneas con la palabra clave END en una línea independiente o con una línea en blanco.
END

opcional

El fin de un comando COMMENT de varias líneas.

Si utiliza END, lo debe introducir en la línea inmediatamente siguiente a la última línea de comentario. Si omite END, la última línea de comentario debe ir seguida de una línea en blanco.

Ejemplos

Comentarios de una sola línea

Los comentarios de una sola línea se usan antes de los comandos para agregar documentación para futuros usuarios que mantendrán el script:

COMMENT Generar una desviación estándar y un promedio. 
STATISTICS ON %v_importe% STD TO SCREEN NUMBER 5 
COMMENT Crear campos para almacenar la desviación estándar y el promedio. 
DEFINE FIELD Desviación_Estándar COMPUTED STDDEV1 
DEFINE FIELD Promedio COMPUTED AVERAGE1

Comentario de varias líneas

Comienza cada script que redacta con un comentario de varias líneas que explica el propósito del script:

COMMENT 
  Este estudio analítico identifica varios registros con ID de originador de la transacción común 
  (como ID de proveedor o ID de comerciante) 
  en los que los valores de fecha de la transacción son iguales o tienen una diferencia de un día. 
  Este estudio analítico se puede usar para facturas divididas, órdenes de compra divididas, 
  solicitudes divididas y transacciones de tarjeta corporativa divididas. 
END

Observaciones

Cuándo usar COMMENT

Utilice COMMENT para incluir información acerca del propósito de un script, la lógica utilizada y otra información, como las entradas requeridas para el script y el propósito de cada variable que defina.

Los comentarios de un script se escriben en el log de comandos de Analytics cada vez que se ejecuta el script.

[ Volver al inicio ]

Guía de creación de scripts de ACL 14.1