pdm_text_cmd -- Text API 命令行界面

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

重要信息！ 您不能将单引号或双引号用作 pdm_text_nxd 或 bop_cmd 命令的参数。

语法

此命令具有以下格式：

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 文件。

-T timeout

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

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

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

注意：在通过命令提示符传递参数时，请在 Windows 中使用 Ctrl+Z，在 POSIX 中使用 Ctrl+D。

详细信息：

使用 Text API