与其他应用程序集成 > Digital Product Traceability > Windchill 作为 OSLC 客户端 > 在 ThingWorx 中配置 Windchill Digital Product Traceability (DPT) Extension > 配置 Windchill DPT Extension
配置 Windchill DPT Extension
1. 导入该扩展以及所需的 PTC 参考配置事物，并验证 ThingWorx 实体。
a. Windchill_Digital_Product_Traceability-extension - 将此 ZIP 文件导入到 ThingWorx Platform。导入 DPT 扩展后，验证 ThingWorx Composer 中是否存在以下实体：
* 
所导入扩展中的 Windchill 产品版本以下列格式显示：xx.x.xxx。前四位数字表示 Windchill 版本，最后两位数字表示关键补丁集 (CPS) 的版本号。
例如，Windchill 12.0.0 的 CPS 03 版本在该扩展中表示为 12.0.003。
实体
说明
类型
DPTAdminConfigThing
此配置事物中包含的服务用于创建 DPTEndUserGroup 和 DPTConfiguratorGroup 以及为 ThingWorx Platform 实体分配必要权限。
ConfigThing
OslcDataServicesThing
此事物包含从 Windchill 调用的 OSLC 资源的服务。
Thing
OslcFlowsThing
此事物包含使用 ThingWorx Flow 从远程 OSLC 系统提取数据的工作流服务。
Thing
OslcValidationFlowThing
此事物包含默认的验证工作流事物。
Thing
OslcValidationServicesThing
此事物包含从 Windchill 调用的 OSLC 资源的验证服务。
Thing
PTC-PLM
• PTC-PLM:TRACELINKS 模型标记用于标记扩展中的所有可用实体。有关详情，请参阅 ThingWorx Platform 帮助中心的“标记”帮助主题。
• PTC-PLM:TRACELINKS-DPT-EXTENSION-PROPERTIES 模型标记默认会启用 Windchill DPT Extension 来使用 DPTExtensionPropertiesConfigThing。
• PTC-PLM:TRACELINKS ROOT SELECTION DIALOG 模型标记：如果向配置事物中添加了该模型标记，“选择上下文”表格中会显示根。如果未添加该模型标记，“选择上下文”表格中会显示完整的树结构。此标记特定于 PTC Modeler。
• PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH 模型标记：如果向配置事物中添加了该模型标记，使用外部资源搜索选取器来显示外部 OSLC 资源。如果未添加此标记，选择对话框会显示外部 OSLC 资源。预设会将 PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH 标记添加到 PTCModelerConfigThing 中。PTC 建议不要将 PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH 模型标记添加到 PTCPolarionConfigThing 中。
* 
如果为 OSLC 配置事物添加了 PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH 和 PTC-PLM:TRACELINKS ROOT SELECTION DIALOG 标记，忽略 PTC-PLM:TRACELINKS ROOT SELECTION DIALOG 标记。
• 使用 PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH 标记时，应为 IBM Rational Doors NG 参考配置事物指定 PTC-PLM:TRACELINKS-OSLC-QUERY-SELECT-ALL 模型标记。
ModelTagVocabulary
PTC-PLM-VALIDATION-FLOWS
PTC-PLM-VALIDATION:modeler 模型标记用于标识验证工作流事物。有关详情，请参阅 ThingWorx Platform 帮助中心的“标记”主题。
ModelTagVocabulary
PTC.PLM.TraceLinks.AttributeMappingConfigDataShape
此数据形状在 OSLCResourceAttributeMappingConfigTable 中用于属性映射。
DataShape
PTC.PLM.TraceLinks.DPTExtensionPropertiesThingTemplate
此事物模板包含 Windchill_Digital_Product_Traceability-extension 的配置特性。
ThingTemplate
PTC.PLM.TraceLinks.OslcDataServicesThingShape
此事物形态包含为 Windchill 定义的服务合约。
ThingShape
PTC.PLM.TraceLinks.OslcDataServicesThingTemplate
此事物模板包含为 Windchill 定义的数据服务。
ThingTemplate
PTC.PLM.TraceLinks.OslcFlowsTemplate
此事物模板包含工作流服务。
ThingTemplate
PTC.PLM.TraceLinks.OslcMappingConfigThingTemplate
此事物模板用于为每个外部系统创建配置事物。
ThingTemplate
PTC.PLM.TraceLinks.OslcValidationServicesThingTemplate
此事物模板包含 Windchill 的验证服务。
ThingTemplate
PTC.PLM.TraceLinks.ResourceShapeAttributeMappingDataShape
此数据形状在 OSLCResourceShapeConfigTable 中用于属性映射。
DataShape
PTC.PLM.TraceLinks.SearchAttributeMappingConfigDataShape
此数据形状在 OSLCSearchResultConfigTable 中用于属性映射。
DataShape
TRACELINKS
TRACELINKS:OSLC-FLOWS 模型标记用于标记扩展中的所有可用实体。有关详情，请参阅 ThingWorx Platform 帮助中心的“标记”主题。
ModelTagVocabulary
Windchill_Digital_Product_Traceability-xx.x.xxx.jar
此资源包含在 Windchill_Digital_Product_Traceability-extension 中。
* 
有关兼容性的信息，请在发布日历页面中打开本发行版的 View Matrix Page 链接。
Resource
* 
请确保针对上述实体启用正确的权限。有关详情，请参阅 ThingWorx Platform 实体的默认权限部分。
* 
模型标记由词汇表和词语构成。模型标记的值对于事物是唯一的。
b. Windchill_Digital_Product_Traceability_Config_Things - 解压缩该文件夹，然后将所需的 PTC 参考配置事物连同 DPTExtensionPropertiesConfigThing 一起导入到 ThingWorx Platform。将所导入的参考配置事物用作预设的支持和验证配置的参考。
实体
说明
PTCDoorsConfigThing
此配置事物包含 IBM Rational Doors NG 的参考配置，其中包括 Windchill 到 IBM Rational Doors NG OSLC 的所有数据映射和配置。
PTCModelerConfigThing
此配置事物包含 PTC Modeler 的参考配置，其中包括 Windchill 到 PTC Modeler OSLC 的所有数据映射和配置。
PTCRVSConfigThing
此配置事物包含 PTC RV&S 的参考配置，其中包括 Windchill 到 PTC RV&S OSLC 的所有数据映射和配置。
PTCCodebeamerConfigThing
此配置事物包含 Codebeamer 的参考配置，其中包括 Windchill 到 Codebeamer OSLC 的所有数据映射和配置。
PTCPolarionConfigThing
此配置事物包含 Siemens Polarion 的参考配置，其中包括 Windchill 到 Siemens Polarion OSLC 的所有数据映射和配置。
PTCJiraConfigThing
此配置事物包含 Jira (SodiusWillert) 的参考配置，其中包括 Windchill 到 Jira OSLC 的所有数据映射和配置。
PTCCatiaConfigThing
此配置事物包含 CATIA Magic Collaboration Studio 的参考配置，其中包括 Windchill 到 CATIA Magic Collaboration Studio OSLC 的所有数据映射和配置。
* 
只能使用 dcterms:title 和 dcterms:type 属性来筛选资源。
DPTExtensionPropertiesConfigThing
使用 TRACELINKS-DPT-EXTENSION-PROPERTIES 模型标记进行标记时，Windchill DPT Extension 可以使用以下定义的特性。
• CACHE-EXPIRY - 确定缓存条目的有效期。默认值设置为 5 分钟。
• SCHEDULER-INTERVAL - 确定自动清除缓存条目的频率。默认值设置为 30 分钟。
• CACHE-USERS - 确定缓存条目中的用户数。默认值设置为 200。
• CACHE-RESOURCES - 确定每个用户可缓存的资源数。默认值设置为 100。
• LARGE-PREVIEW-SHOW-DIMENSIONS - 用于控制：是否在新选项卡中显示大型预览。如果设置为 No，将在新选项卡中打开默认的大型预览。如果设置为 Yes，将在弹出窗口中打开预览。
* 
预设情况下，此标记被添加到特性示例配置事物中。
• OSLC-QUERY-PAGESIZE - 确定每页应显示的远程对象数量。预设情况下，此特性设置为 50。
• DEFINE-RESOURCETYPE-ATTRIBUTE - 指定用于返回资源类型值的 PTC Modeler OSLC 服务器的属性名。默认值设为 ptc_im_am:dynamicUmlClassName。
* 
如果指定的值有误，或未指定任何值，或者如果从配置中删除特性，系统不允许针对 Windchill Modeler 资源添加追溯链接。
* 
默认情况下，ThingWorx 会将远程资源信息缓存到其内存缓存中。要禁用缓存，请将 CACHE-DISABLE 特性添加到 DPTExtensionPropertiesConfigThing，并将其值设置为 Yes。
* 
可以更新这些配置特性的值。要应用这些变更，请重新启动 ThingWorx Foundation 服务。
c. 按照以下步骤执行 DPTAdminConfigThing 服务：
i. 以管理员身份登录 ThingWorx Platform。
ii. 导航到 DPTAdminConfigThing > “服务” > PostDPTExtensionImport > “执行”选项卡。
iii. 单击“执行”。
成功运行该服务后，系统会显示以下消息："Permissions applied successfully"
iv. 验证是否已在“安全” > “用户组”中创建了 DPTEndUserGroup 和 DPTConfiguratorGroup。确保为 ThingWorx Platform 实体分配必要权限。
有关详情，请参阅 ThingWorx Platform 实体的默认权限部分。
* 
• PostDPTExtensionImport 服务只能由 ThingWorx 管理员来执行。
• 执行服务后，将保留 DPTEndUserGroup 和 DPTConfiguratorGroup 的现有成员和权限。
2. 在 ThingWorx Flow 中，根据以下说明，针对需要集成的 OSLC 系统创建新连接。请参阅 ThingWorx Platform 帮助中心的“创建和管理连接”主题：
a. 为 OSLC 系统创建连接。
▪ 对于基本身份验证，请选择“OSLC 基本验证”连接类型。
▪ 对于 SSO 配置，请创建 OAuth 连接。
在创建 OAuth 连接之前，请确保已在 ThingWorx Flow 中配置 OAuth 提供者。有关详情，请参阅 ThingWorx Flow 帮助中心的“创建和管理 OAuth 提供者”以及“配置和加载 OAuth”。
* 
您必须接受对 OSLC OAuth 会话连接对象的授予批准。有关详情，请参阅为 ThingWorx 创建 OAuth 客户端连接。
b. 在“添加连接”窗口中输入以下信息：
▪ “连接标签”- 键入连接的名称。此处指定的连接名称用于配置事物。
▪ “目录 URL”- 键入外部系统的 OSLC 服务器的目录 URL。请参阅参考文档网站中的 PTC RV&S OSLC Client (《Windchill RV&S OSLC 客户端》) 指南 (12.3.0.0 及更高版本)，PTC Modeler 帮助中心的 "OSLC integration with Integrity Modeler" 以及 "OSLC integration with IBM Rational DOORS Next Generation" 主题。
* 
有关支持的 PTC RV&S 和 PTC Modeler 应用程序版本的说明，请参阅本文档。
▪ 访问 OSLC 服务器时所需的外部系统服务帐户的登录凭据。
▪ “并发请求”- 指定从 ThingWorx Flow 同时调用的资源请求的数量。默认值为 5。
管理员可以根据服务器配置修改请求的数量。
c. 保存连接。
d. 单击“关闭”。
* 
请不要修改 ThingWorx Flow 中的默认 PTC Modeler 连接器。
3. 将 ThingWorx Platform 配置为与外部系统的 OSLC 服务器集成。在 ThingWorx Platform 中，创建配置事物。
要创建配置事物：
a. 导航到“事物” > “新建”，并指定属性的值。选择 PTC.PLM.TraceLinks.OslcMappingConfigThingTemplate 作为“基本事物模板”。
b. 在“配置”选项卡中，如下表中所述配置映射。您可以将 PTC 参考配置事物作为参考，并输入 OSLC 系统的详情。
▪ OSLCServerMappingConfigTable
属性
说明
Server
外部 OSLC 服务器的名称。
BaseUrl
外部 OSLC 服务器的基础 URL。
* 
要映射到相应的 OSLC 服务器，必须执行此步骤。
ConnectionObject
为外部 OSLC 服务器创建的连接的名称。
Tag
在 PTC-PLM-Validation-Flows 模型标记词汇表中定义的“词语”值，用于标识远程服务器。
此步骤是可选的。只有在使用验证工作流时，才需要执行此步骤。
有关添加标记的详情，请参阅 ThingWorx Platform 帮助中心的“标记”主题。
▪ OSLCResourceMappingConfigTable 的属性映射
属性
说明
WindchillType
Windchill 内“类型和属性管理”实用程序中需求资源或架构资源的内部名称。创建资源的追溯链接。
OSLCResourceType
在外部 OSLC 服务器中定义的需求资源、架构资源的类型或其子类型。OSLCResourceType 的值是在外部 OSLC 服务器中配置的资源及其子类型的名称。例如，在 PTC Modeler 中，活动被定义为架构域资源的子类型。用户可以将名称定义为“资源|活动”的形式，其中，“活动”是架构域 OSLC 类型资源的子类型。为架构资源类型指定的名称应使用竖线分隔。
有关需求资源或架构资源内部名称的信息，请参阅系统兼容性与系统要求中的“类型和属性”。
* 
如果 OSLC 资源类型已映射到 Windchill 对象类型，则不要将 OSLC 资源类型重新映射到 Windchill 对象类型。在 Windchill 中针对对象进行追溯后，最初在 ThingWorx 中所定义的 Windchill 对象类型到 OSLC 资源类型的重新映射会导致数据损坏。
▪ OSLCResourceAttributeMappingConfigTable
属性
说明
WindchillTableId
Windchill 中的表 ID，用于显示外部 OSLC 服务器中的数据。
要添加多个表 ID 值，请使用以逗号分隔的列表。
WindchillType
Windchill 内“类型和属性管理”实用程序中需求资源或架构资源的内部名称。
▪ OSLCResourceAttributeMappingConfigTable 的属性映射
属性
说明
WindchillAttribute
要在 Windchill 表格中显示的 Windchill 属性的名称。
OSLCResourceAttribute
OSLC 资源属性的名称。
* 
要为远程 OSLC 系统添加自定义属性，请遵循命名约定 prefix:propertyName。其中，prefix 是在特性名称之前添加的词缀，而 propertyName 是由 OSLC 服务器定义的属性名称。例如，对于自定义属性 state，PTC RV&S 的 OSLCResourceAttribute 值为 wrvs:state。
WindchillAttributeDataType
Windchill 属性的数据类型。String、Timestamp 和 RichText 是预设支持的数据类型值。
IsPreview
针对属性选择 IsPreview 时，会显示由外部 OSLC 服务器公开的追溯远程对象的 HTML 表示。
选中 IsPreview 复选框可显示小型预览和大型预览。
IsPreview 可用于数据类型为 String 和 RichText 的属性。针对上述两种数据类型的属性显示小型预览，而仅针对数据类型为 String 的属性显示大型预览。
▪ OSLCResourceShapeConfigTable
属性
说明
OSLCResourceType
需求域、架构域或变更域所支持的资源类型，如在外部 OSLC 服务器中所定义。OSLCResourceType 的值是外部 OSLC 服务器中所配置资源的名称。
OSLCResourceShapeURI
这些 OSLC 服务器的 OSLC 资源形态的 URI 不会使用 OSLC 查询服务公开资源形态，但会使用其他服务公开。例如，IBM Rational Doors NG OSLC 服务器会使用 Creation Factory 服务公开资源形态。
▪ OSLCResourceShapeConfigTable 的属性映射
属性
说明
WindchillAttribute
要在外部资源搜索选取器的“筛选条件”窗格中显示的 Windchill 属性的名称。
OSLCResourceAttribute
要为 OSLC 属性添加值，请遵循命名约定 prefix:propertyName。其中，prefix 是在特性名称之前添加的词缀，而 propertyName 是由 OSLC 服务器定义的属性名称。例如，对于 PTC RV&S OSLC 服务器所公开的属性 state，OSLCResourceAttribute 值为 dcterms:state。
OSLCAttributeDataType
OSLC 资源的数据类型。String、LangString、XMLLiteral、Boolean、DateTime、DECIMAL、Double、Float 和 Integer 是受支持的 OSLC 数据类型值。
▪ OSLCSearchResultConfigTable
属性
说明
WindchillType
需求域、架构域或变更域所支持的 Windchill 资源类型。
▪ OSLCSearchResultConfigTable 的属性映射
属性
说明
WindchillAttribute
要在外部资源搜索选取器的“搜索结果表格”窗格中显示的 Windchill 属性的名称。
OSLCResourceAttribute
OSLC 资源属性的名称。
* 
要为远程 OSLC 系统添加自定义属性，请遵循命名约定 prefix:propertyName。其中，prefix 是在特性名称之前添加的词缀，而 propertyName 是由 OSLC 服务器定义的属性名称。例如，对于 PTC RV&S OSLC 服务器所公开的自定义属性 state，PTC RV&S 的 OSLCResourceAttribute 值为 dcterms:state。
WindchillAttributeDataType
Windchill 属性的数据类型。String、Timestamp 和 RichText 是预设支持的数据类型值。
▪ OSLCRemoteConfigTable
属性
说明
ReverseLookupURL
外部 OSLC 服务器反向查找服务的相对 URL。例如，对于 Codebeamer，请指定 /cb/api/oslc/links/traceLinkResources。
Method
反向查找服务支持的 HTTP 请求方法。有效值为 GET 和 POST。
* 
• PTC Modeler 和 Codebeamer 的有效值为 GET。
• PTC RV&S 的有效值为 POST。
TraceableUrlPrefix
与部件或可追溯对象 URL 一起使用的前缀。例如，对于 Codebeamer，请指定 cb:traceLinkTargetURI。
PageSize
用于确定：OSLC 反向查找服务的单次调用最多可获取的远程项的数量。
PTC RV&S 的默认限制为 200，Codebeamer 的默认限制为 500。
如果配置的值超过默认限制，则反向查找功能将失败。
* 
由于 PTC Modeler 不支持分页，此特性的默认值为空。
* 
PTC Modeler、PTC RV&S 和 Codebeamer OSLC 服务器支持反向查找功能。确保仅在受支持的 OSLC 服务器的参考配置文件中定义上述属性值。
c. 单击“保存并继续”。
这对您有帮助吗?