Tema anterior: Formato de entradaTema siguiente: Convenciones de entrada de palabra clave


Palabras clave

Hay dos tipos de palabras clave que se pueden utilizar en las entradas de Text API.

Palabra clave

Descripción

ASSET

Se emplea para adjuntar elementos a los tickets; es válida para peticiones, incidencias y órdenes de cambio. El valor especificado es el nombre del elemento, que ya debe existir. Esta palabra clave se puede especificar varias veces ya que los tickets pueden tener adjuntos varios elementos.

ATTACHMENT

La interfaz de correo electrónico la usa de forma interna para agregar adjuntos a los partes.

DESCRIPTION

Especifica el valor que se debe usar para el campo de descripción del parte. Esta palabra clave se sobrentiende si se envía la entrada a Text API sin indicar ninguna palabra clave. Esta palabra clave es aplicada automáticamente por el receptor de correo cuando el mensaje no empieza con una palabra clave pero contiene un artefacto de ID de ticket o palabra clave.

Es posible cambiar la manera de tratar en las actualizaciones la palabra clave DESCRIPTION mediante la entrada siguiente de la sección [OPTIONS] del archivo text_api.cfg:

UPDATE_DESC_IS_LOG

Si se define esta opción en SÍ, se emplea el valor para crear un comentario de registro; en cambio, si se define en NO, el valor sobrescribe el campo de descripción existente.

FROM_EMAIL
FROM_EMAIL_OVERRIDE

La interfaz de correo electrónico la usa para realizar la comparación con el campo Dirección de correo electrónico del registro de la tabla ca_contact. También sirve como log_agent para el tíquet. Si se proporcionan los dos, se ignora FROM_EMAIL.

Nota: El receptor de correo establece FROM_EMAIL automáticamente por el receptor con la dirección del remitente del mensaje.

FROM_PERSID

La interfaz de la línea de comandos la usa para definir el log_agent de las operaciones, por ejemplo, si el registro de ca_contact carece de ID de usuario. pdm_text_cmd traslada automáticamente esta palabra clave si se especifica el parámetro ‑p. El valor se compara con el valor de persistent_id del registro de ca_contact.

FROM_USERID

Sólo se usa en la interfaz de la línea de comandos para definir el log_agent de las operaciones. pdm_text_cmd traslada automáticamente esta palabra clave si se especifica el parámetro ‑u. El valor se compara con el ID de usuario de un contacto.

LOG

Sirve para crear entradas de registro; es válida para solicitudes, órdenes de cambios, incidencias y contactos. El receptor de correo aplica esta palabra clave automáticamente cuando el mensaje no empieza con una palabra clave pero contiene o un artefacto de ID de ticket o palabra clave, o una palabra clave DESCRIPTION.

LOG_AGENT

La interfaz de CA NSM la usa para definir el log_agent de las operaciones. El valor se compara con el campo ID del registro de contacto oportuno.

PROPERTY

Sirve para definir el valor de las propiedades; es válida para solicitudes, órdenes de cambios e incidencias. A diferencia de otras palabras clave, que van seguidas tan sólo de un signo igual y un valor, la sintaxis de la palabra clave PROPERTY debe incluir la etiqueta de la propiedad como se ilustra a continuación:

PROPERTY={{etiqueta_propiedad}}valor

Debe especificar la etiqueta_propiedad exactamente como aparezca en la base de datos.

SEARCH

Sólo se usa en la interfaz de la línea de comandos y la interfaz de CA NSM para suministrar una lista de palabras clave que se pueden usar en las consultas para actualizar varios tickets para un activo. El valor se corresponde con la lista de palabras clave que se emplea en la búsqueda.

La interfaz de CA NSM define de forma automática la palabra clave SEARCH.

SEARCH_EXPLICIT

Sólo se usa en la interfaz de CA NSM para sustituir la palabra clave SEARCH que proporciona la propia interfaz. Los valores aportados son idénticos a los de la palabra clave SEARCH.

Más información:

pdm_text_cmd: interfaz de la línea de comandos de Text API