参考命令 › pdm_text_cmd -- Text API 命令行界面

pdm_text_cmd -- Text API 命令行界面

pdm_text_cmd 是 Text API 的命令行界面，可用于创建和更新各种对象（例如请求、变更单、投诉、资产和联系人）。

语法

此命令具有以下格式：

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

-t table

（必需）指定要处理的表。 table 名称可以是以下值之一（不区分大小写）：

• 资产
• 联系人
• 更改
• 问题
• 请求

注意：有关有效表名称的完整列表，请参阅 text_api.cfg 文件的 [OPTIONS] 部分。

-u from_userid | -p from_persid

（必需选择其中一个选项）指定该操作的联系人：

• -u from_userid

  使用用户 ID 值指定联系人。

• -p from_persid

  使用联系人记录的唯一对象标识符指定联系人。 from_persid 的形式必须为 cnt:xxxx. xxxx 是对象的永久 ID。

注意：您使用该选项指定的值将使用相应的关键字（%FROM_USERID 或 %FROM_PERSID）追加到 pdm_text_cmd 命令输入的结尾。

-o operation

指定要执行的操作。 operation 必须是以下其中一个值（不区分大小写）：

• NEW - 创建对象。 如果未指定操作，则该值为默认值。
• UPDATE | UPD - 如果未找到对象，则创建该对象；如果找到现有对象，则更新该对象。
• UPDATE_ONLY | UPDO - 如果找到对象，则更新该对象；否则，不执行任何操作。

UPDATE 和 UPDATE_ONLY 要求在命令输入中提供 %SEARCH 关键字。 您仅可以对每个 pdm_text_cmd 调用执行一次操作处理。

-f input_file

指定要处理的文件的完整路径，该文件是包含有效的 Text API 命令的文本文件。 如果您省略该参数，则从 STDIN 使用命令。 Text API 将以下基本格式用于输入：

%keyword=value

通过使用至少五个百分号 (%%%%%) 将命令请求分隔开，可在输入中发出多个命令。

注意：有关有效关键字及 Text API 格式输入的详细信息，请参阅 text_api.cfg 文件。 有关详细信息，请参阅使用 Text API。

-T timeout

指定超时之前等待服务器响应的秒数。 默认值为 30 秒。

注意：pdm_text_cmd 可显示从 Text API 收到的基于文本的回复，这些回复包括成功消息或错误消息，以及使用 API 发送的用于处理的原始文本。 如果命令成功完成并且没有警告或错误，则 pdm_text_cmd 返回零；如果命令成功完成但有警告，则 pdm_text_cmd 返回一。 任何其它返回值表示出错。

重要信息！ 在 UNIX 上，运行多个 CA Service Desk Manager 实用程序之前，必须先设置 LIBPATH。 在运行实用程序之前使用 pdm_task 设置 LIBPATH。 例如，输入“pdm_task pdm_clean_attachments ...”。