使用 Windchill REST Web 服务来开发任务

Windchill 提供各种可在混搭中使用的 REST (表征状态转移) Web 服务。这些服务可用于访问 Windchill 数据以及利用 Windchill 系统的处理能力。PTC Windchill Extension 包括开启 Windchill REST Web 服务的 WindchillSwaggerConnector 事物模板。ThingWorx Navigate 连接器的实例是 ptc-windchill-integration-connector。

Windchill 还提供了基于 OData 的 Windchill REST 服务。在后续版本中，ThingWorx Navigate 将对这些服务加以利用。

我们建议您在自定义 ThingWorx Navigate 时规划此更改。

有关针对 Windchill 数据配置 OData 服务的详细信息和说明，请参阅 Windchill REST Services User’s Guide (《Windchill REST 服务的用户指南》)。

Windchill REST 服务与 Windchill Audit 日志记录集成。自此 PTC Windchill 扩展版本开始，将记录以下事件：

要了解在您的任务中调用 REST 服务的信息，请使用以下资源：

• ThingWorx 帮助有完整的一章介绍 WindchillSwaggerConnector 及其他集成连接器。您可以在其中了解背景信息，以及如何使用它们。首先请阅读主题“集成连接器”。

• “使用 WindchillSwaggerConnector”介绍如何安装必需的 Windchill 修补程序，并提供了可用于检索数据的受支持 Windchill 端点的列表。

• Windchill 文档包括资源、端点、参数、表示及其结构的说明。要访问文档，请单击“导航器”中的自定义图标，然后选择“文档”。

在 Windchill 用户界面中的“客户端自定义”首选项设置为“是”的情况下，文档才可用：

有关设置首选项的信息，请参阅 Windchill Help Center 中的“自定义工具概述”。

ServiceTimeout 属性用于控制在 Windchill 将错误返回混搭用户界面之前，ThingWorx 等待对 Windchill 执行的 REST 调用完成的默认时间 (以毫秒为单位)。您可以通过在调用 Windchill 时指定超时参数来覆盖单个调用的此默认值。例如，下面的代码会调用 Windchill REST 端点来执行已保存搜索，并指定 10 秒的超时。如果此调用未指定超时自变量，则使用在 ServiceTimeout 中指定的超时。

var params = {
queryParams: {
'$select': 'name,number,version'
},
data: {
keyword: undefined
},
type: 'POST',
url: me.getRestUrl() + "/search/saved-searches/" + encodeURIComponent(oid) + "/results",
timeout: 10000
};
var jsonResult = me.processJSONRequest(params);