Comandos de referencia › pdm_text_cmd: interfaz de la línea de comandos de Text API

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

pdm_text_cmd es la interfaz de la línea de comandos de Text API, que sirve para crear y actualizar diversos objetos como, por ejemplo, solicitudes, órdenes de cambio, incidencias, activos y contactos.

Sintaxis

Este comando tiene el formato siguiente:

pdm_text_cmd –t table {-u from_userid –p from_persid} [-o operation] [-f input file] [-T timeout] [-h]

-t table

(Obligatorio) Especifica la tabla que se debe procesar. El nombre de tabla puede ser uno de los siguientes valores (no se distingue entre mayúsculas y minúsculas):

• Activo
• Contacto
• Cambiar
• Incidencia
• Solicitud

Nota: consulte en la sección [OPTIONS] del archivo text_api.cfg la lista completa de nombres de tabla válidos.

-u from_userid | -p from_persid

(Una opción es obligatoria) Identifica el contacto para esta operación:

• -u from_userid

  Identifica el contacto con el valor de ID de usuario.

• -p from_persid

  Identifica el contacto con el identificador de objeto exclusivo para el registro de contacto. from_persid debe tener la forma cnt:xxxx. xxxx es el ID persistente del objeto.

Nota: el valor especificado con esta opción se agrega al final de la entrada para el comando pdm_text_cmd mediante la palabra clave apropiada, %FROM_USERID o %FROM_PERSID.

-o operation

Especifica la operación que se debe realizar. El valor de operation debe ser uno de los siguientes valores (no se distingue entre mayúsculas y minúsculas):

• NEW: crea un objeto. Se trata del valor predeterminado en caso de que no se especifique ninguna operación.
• UPDATE | UPD: si no se encuentra el objeto, se crea y, si se encuentra, se actualiza.
• UPDATE_ONLY | UPDO: si se encuentra el objeto, se actualiza; de lo contrario, no se realiza ninguna acción.

Tanto UPDATE como UPDATE_ONLY requieren que se use la palabra clave %SEARCH en la entrada del comando. Sólo se puede realizar una operación cada vez que se invoque pdm_text_cmd.

-f input_file

Especifica la ruta completa al archivo que se debe procesar, que es un archivo de texto que contiene comandos de Text API válidos. Si se omite este parámetro, se utilizan los comandos de STDIN. El Text API utiliza el siguiente formato básico para la entrada:

%palabra_clave=valor

Puede emitir varios comandos dentro de la entrada si separa la solicitud de comandos con al menos cinco símbolos de porcentaje (%%%%%).

Nota: Para obtener más información sobre palabras clave válidas y sobre el formato de la entrada en Text API, consulte el archivo text_api.cfg. Para obtener más información, consulte Uso de Text API.

-T timeout

Especifica el número de segundos que se espera a que se produzca la respuesta del servidor antes de que se dé por agotado el tiempo de espera. El valor predeterminado es 30 segundos.

Nota: pdm_text_cmd muestra las respuestas basadas en texto y recibidas de Text API, que incluyen mensajes de error o de confirmación, así como el texto original enviado mediante la API para su procesamiento. pdm_text_cmd devuelve cero si el comando se ejecuta correctamente sin advertencias ni errores, o bien devuelve uno si se ejecuta correctamente pero con advertencias. Si se devuelve cualquier otro valor, significa que se ha producido algún error.

Importante: En UNIX, LIBPATH debe estar definido antes de ejecutar varias utilidades CA Service Desk Manager. Utilice pdm_task para definir LIBPATH antes de ejecutar una utilidad. Por ejemplo, indique "pdm_task pdm_clean_attachments ...".