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 registros múltiples con la misma
  identificación para el originador de la transacción (por ejemplo, misma ID de proveedor o ID de comerciante)
  y con fechas de transacción iguales o con un día de diferencia.
  Este estudio analítico se puede utilizar para facturas divididas, órdenes de compra divididas,
  solicitudes divididas y transacciones con tarjetas corporativas 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.