Uso del API de texto › API de texto › Formato de entrada

Formato de entrada

La entrada al API de texto se especifica de las siguientes maneras:

• En la interfaz de línea de comandos, la entrada se especifica generalmente en un archivo de texto pasado al comando pdm_text_cmd.
• En la interfaz de correo electrónico, se especifica en el texto del correo electrónico. El usuario especifica una expresión regular para encontrar los identificadores de objeto de destino.

El usuario aplica formato a la entrada del API de texto de la misma manera sin importar qué interfaz utiliza.

El formato básico para la entrada es el siguiente:

%palabra_clave=valor

or

%PROPERTY={{etiqueta_propiedad}}valor

El comportamiento normal de los comandos del API de texto tiene las excepciones siguientes, donde el comando que aparece al último de dos o más comandos en conflicto tiene prioridad:

• Cuando un mensaje contiene varios artefactos de ID de ticket válidos que coinciden con la cadena de filtro de regla de buzón de correo o varios comandos de ID de ticket del API de texto, se utiliza el primero que se encuentra. También, un artefacto de ID de ticket, que se identifica utilizando la cadena de filtro de regla para el buzón de correo, anula cualquier comando de ID de ticket del API de texto, sin tener en cuenta cuál aparece primero.
• Cuando un mensaje contiene varios comandos del API de texto de comentario del registro, todos los comentarios se envían, aunque el orden en el cual aparecen en el registro de actividades del ticket puede variar.

Todos los artefactos de ID de ticket que coinciden con el filtro, sean válidos o no, y los comandos de ID de ticket del API de texto dentro del mensaje, sean aplicables o no, o se hayan aplicado o no, se comentan antes de que el mensaje se envíe. Los artefactos de ID de ticket identificados a través de los filtros de la regla para el buzón de correo aparecen como -((...))-. Los signos de porcentaje (%) adelante de los comandos de ID del API de texto se convierten en dos paréntesis de apertura ((, y dos paréntesis de cierre)) siguen al comando. Si un comando de ID de ticket del API de texto aparece después de otro comando del API de texto con un comentario de registro (%LOG=…), el comando de ID de ticket del API de texto comentado se convierte en un comentario de registro separado.

Nota: El comentario de registro es el único comando del API de texto que puede aparecer repetidas veces en un mensaje y aún así tener cada resultado aplicado. Para algunos otros comandos, el API de texto utiliza solamente el último resultado porque los resultados múltiples de otros comandos se contradicen. Los comandos de comentario de registro múltiples envían mensajes de comentario de registro separados al ticket, y no necesariamente siguiendo algún orden en particular.

Además, si un comando de ID de ticket del API de texto aparece en el mensaje, ya sea al inicio del mensaje o entre otros dos comandos del API de texto, se convierte en un comentario de registro. Si el comando anterior es un comentario de registro (%LOG=…) o una descripción de actualización (%DESCRIPTION=…), se añade a ese comando en lugar de convertirse en un comentario de registro separado.

Los mensajes entrantes que se envían sólo como HTML, sin una versión de texto sin formato incluida, pierde su cuerpo de mensaje. Si el mensaje hace coincidir algunos filtros de regla para el buzón de correo con un cuerpo de mensaje vacío, se puede crear un ticket con una descripción vacía o con el asunto de mensaje citado como la totalidad de la descripción de ticket.