Comando COMMENT

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

Sintaxis

Comentarios de una sola línea

COMMENT comment_text

Comentarios de varias líneas

COMMENT
  comment_text
  <...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 sola líneaEscriba el texto del comentario completo sin un salto de línea.
  • Comentario de varias líneasEscriba 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 Generate the standard deviation and average.
STATISTICS ON %v_amt% STD TO SCREEN NUMBER 5
COMMENT Create fields for storing standard deviation and average.
DEFINE FIELD Standard_Dev COMPUTED STDDEV1
DEFINE FIELD Average 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
  This analytic identifies multiple records having common
  transaction originator IDs (like vendor ID or merchant ID)
  where the transaction date values are either equal or one day apart.
  This analytic can be used for split invoices, split purchase orders,
  split requisitions, and split corporate card transactions.
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.