与其他应用程序集成 > 数码产品可追溯性 > 在 ThingWorx 中配置 Windchill Digital Product Traceability (DPT) Extension > 配置 Windchill DPT Extension
配置 Windchill DPT Extension
1. 导入扩展并验证 ThingWorx 实体和参考示例。
a. Windchill_Digital_Product_Traceability-extension - 将此压缩文件导入到 ThingWorx Platform。在导入 DPT 扩展后，验证 ThingWorx Composer 中是否存在以下实体：
* 
所导入扩展中的 Windchill 产品版本以下列格式显示：
xx.x.xxx
此处，前四位数字表示 Windchill 版本，而最后两位数字表示关键修复程序集 (CPS) 的版本编号。
例如，Windchill 12.0.0 版本的 CPS 03 版本在扩展中表示为 12.0.003。
实体
说明
类型
OslcDataServicesThing
此事物包含从 Windchill 调用的 OSLC 资源的服务。
“事物”
OslcFlowsThing
此事物包含使用 ThingWorx Flow 从远程 OSLC 系统提取数据的工作流服务。
“事物”
OslcValidationFlowThing
此事物包含默认的验证工作流事物。
“事物”
OslcValidationServicesThing
此事物包含从 Windchill 调用的 OSLC 资源的验证服务。
“事物”
PTC-PLM
• PTC-PLM:TRACELINKS 模型标记用于标记扩展中的所有可用实体。有关详情，请参阅 ThingWorx Platform 帮助中心的“标记”帮助主题。
• PTC-PLM:TRACELINKS-DPT-EXTENSION-PROPERTIES 模型标记默认会启用 Windchill DPT Extension 以使用 DPTExtensionPropertiesExampleConfigThing。
• PTC-PLM:TRACELINKS ROOT SELECTION DIALOG 模型标记：如果向配置事物中添加了该模型标记，则“选择上下文”表格中会显示根。如果未添加该模型标记，则“选择上下文”表格中会显示完整的树结构。此标记特定于 Windchill Modeler。
• PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH 模型标记：如果向配置事物中添加了该模型标记，则使用外部资源搜索选取器来显示外部 OSLC 资源。如果未添加此标记，则选择对话框会显示外部 OSLC 资源。预设情况下，PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH 标记被添加到 ModelerExampleConfigThing 和 CodebeamerExampleThing。
* 
如果为 OSLC 配置事物添加了 PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH 和 PTC-PLM:TRACELINKS ROOT SELECTION DIALOG 标记，则忽略 PTC-PLM:TRACELINKS ROOT SELECTION DIALOG 标记。
• PTC-PLM:TRACELINKS-OSLC-QUERY-SELECT-ALL 模型标记：使用 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-12.1.205.jar
此资源是 Windchill_Digital_Product_Traceability-extension 的一部分。
“资源”
* 
请确保针对上述实体启用了正确的权限。请参阅 ThingWorx Platform 实体的权限部分。
* 
模型标记由词汇表和词语构成。例如，在 PTC-PLM-ValidationFlows:modeler 标记中，PTC-PLM-ValidationFlows 为词汇表，modeler 为词语的值。模型标记的值对于事物是唯一的。
b. Windchill_Digital_Product_Traceability_Config_Things - 提取文件夹，然后将每个 XML 文件导入到 ThingWorx Platform。将参考示例事物用作配置事物的参考。验证是否已导入下列 XML 文件：
实体
说明
DoorsExampleConfigThing
此示例事物包含 IBM Rational Doors NG 的参考配置。
ModelerExampleConfigThing
此示例事物包含 Windchill Modeler 的参考配置。
* 
ModelerReferenceConfigThing 应始终使用 ModelerValidationFlowThing 进行标记。如果移除了此标记，则系统不支持创建 Windchill Modeler 资源的追溯链接。
WRVSExampleConfigThing
此示例事物包含 Windchill RV&S 的参考配置。
CodebeamerExampleThing
此示例事物包含 Codebeamer 的参考配置。
DPTExtensionPropertiesExampleConfigThing
使用 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 - 指定用于返回资源类型值的 Windchill Modeler OSLC 服务器的属性名。默认值设为 ptc_im_am:dynamicUmlClassName。
* 
如果指定的值错误或未指定任何值，或者如果从配置中删除了该特性，则系统不支持添加 Windchill Modeler 资源的追溯链接。
* 
您可以更新这些配置特性的值。要应用这些变更，请重新启动 ThingWorx Foundation 服务。
ModelerValidationFlowThing
此示例事物包含用于自定义 Windchill Modeler 验证工作流的参考。管理员可以根据业务需求自定义验证工作流事物。
* 
• 预设情况下，此标记被添加到特性示例配置事物中。
• 您可以更新这些配置特性的值。要应用这些变更，请重新启动 ThingWorx Foundation 服务。
2. 在 ThingWorx Flow 中，使用以下说明并针对需要集成的 OSLC 系统创建新连接。请参阅 ThingWorx Platform 帮助中心的“创建和管理连接”主题：
a. 为 OSLC 系统创建连接。
▪ 对于基本身份验证，请选择“OSLC 基本验证”连接类型。
▪ 对于 SSO 配置，请创建 OAuth 连接。
* 
您必须接受对 OSLC OAuth 会话连接对象的授予批准。有关详情，请参阅为 ThingWorx 创建 OAuth 客户端连接。
b. 在“添加连接”窗口中输入以下信息：
▪ “连接标签”- 键入连接的名称。此处指定的连接名称用于配置“事物”。
▪ “目录 URL”- 键入外部系统的 OSLC 服务器的“目录 URL”。请参阅参考文档网站中的 Windchill RV&S OSLC Client (《Windchill RV&S OSLC 客户端》) 指南 (12.3.0.0 及更高版本)，Windchill Modeler 帮助中心的 "OSLC integration with Integrity Modeler" 以及 "OSLC integration with IBM Rational DOORS Next Generation" 主题。
* 
有关支持的 Windchill RV&S 和 Windchill Modeler 应用程序版本的说明，请参阅文档。
▪ 访问 OSLC 服务器时所需的外部系统服务帐户的登录凭据。
▪ “并发请求”- 指定从 ThingWorx Flow 同时调用的资源请求的数量。默认值为 5。
管理员可以根据服务器配置修改请求的数量。
c. 保存连接。
d. 单击“关闭”。
3. 将 ThingWorx Platform 配置为与外部系统的 OSLC 服务器集成。在 ThingWorx Platform 中，创建配置和验证事物。
a. 要创建配置事物：
i. 导航到“事物” > “新建”，并指定属性的值。选择 PTC.PLM.TraceLinks.OslcMappingConfigThingTemplate 作为“基本事物模板”。
ii. 在“配置”选项卡中，如下表中所述配置映射。您可以参考 WRVSExampleConfigThing 作为示例，并输入 OSLC 系统的详情。
▪ OSLCServerMappingConfigTable
属性
说明
Server
外部 OSLC 服务器的名称。
BaseUrl
外部 OSLC 服务器的基本 URL。
ConnectionObject
为外部 OSLC 服务器创建的连接的名称。
Tag
在 PTC-PLM-Validation-Flows 模型标记词汇表中定义的“词语”值，用于标识远程服务器。
此步骤为可选步骤。仅当使用验证工作流时，才需要执行此步骤。
有关添加标记的详情，请参阅 ThingWorx Platform 帮助中心的“标记”主题。
▪ OSLCResourceMappingConfigTable
属性
说明
WindchillType
Windchill 内“类型和属性管理”实用程序中需求资源或架构资源的内部名称。创建资源的追溯链接。
OSLCResourceType
在外部 OSLC 服务器中定义的需求资源、架构资源的类型或其子类型。OSLCResourceType 的值是在外部 OSLC 服务器中配置的资源及其子类型的名称。例如，在 Windchill Modeler 中，活动被定义为架构域资源的子类型。用户可以将名称定义为“资源|活动”的形式，其中，“活动”是架构域 OSLC 类型资源的子类型。为架构资源类型指定的名称应使用竖线分隔。
有关需求资源或架构资源内部名称的信息，请参阅系统兼容性与系统要求中的“类型和属性”。
* 
如果 OSLC 资源类型已映射到 Windchill 对象类型，则不要将 OSLC 资源类型重新映射到 Windchill 对象类型。在 Windchill 中针对对象进行追踪后，最初在 ThingWorx 中所定义的 Windchill 对象类型到 OSLC 资源类型的重新映射会导致数据损坏。
▪ OSLCResourceAttributeMappingConfigTable
属性
说明
WindchillTableId
Windchill 中的表 ID，用于显示外部 OSLC 服务器中的数据。
WindchillType
Windchill 内“类型和属性管理”实用程序中需求资源或架构资源的内部名称。
▪ OSLCResourceAttributeMappingConfigTable 的属性映射
属性
说明
WindchillAttribute
要在 Windchill 表格中显示的 Windchill 属性的名称。
OSLCResourceAttribute
OSLC 资源属性的名称。
* 
要为远程 OSLC 系统添加自定义属性，请遵循命名约定 prefix:propertyName。其中，prefix 是在特性名称之前添加的词缀，而 propertyName 是由 OSLC 服务器定义的属性名称。例如，对于自定义属性 state，Windchill 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 服务器定义的属性名称。例如，对于 Windchill 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 服务器定义的属性名称。例如，对于 Windchill RV&S OSLC 服务器所公开的自定义属性 state，Windchill RV&S 的 OSLCResourceAttribute 值为 dcterms:state。
WindchillAttributeDataType
Windchill 属性的数据类型。String、Timestamp 和 RichText 是预设支持的数据类型值。
iii. 单击“保存并继续”。
b. 验证工作流事物由一系列用于验证 Windchill 中选定资源类型是否与 OSLC 委派对话框中选定 OSLC 资源类型相匹配的工作流服务组成。Windchill 资源类型可通过“添加追踪”窗口中的“类型”菜单访问。ModelerValidationFlowThing 是预设提供的示例工作流事物。下图所示为验证工作流。
要创建验证工作流事物，请执行以下步骤。导入 ModelerValidationFlowThing 示例事物是创建验证工作流事物的先决条件
i. 选择 ModelerValidationFlowThing，然后单击“重复”。
ii. 在“常规信息”选项卡中，指定“名称”和“标记”属性的值。
标记将使用在 PTC-PLM-Validation-Flows 模型标记中创建的“词语”的值来标识外部服务器。在 PTC-PLM-Validation-Flows 标记中，针对要集成的外部服务器指定一个“词语”值。在 OSLCServerMappingConfigTable 的“标记”字段中指定相同的“词语”值。
iii. 单击“保存”。
有关在 ThingWorx Platform 中配置 DPT 扩展所需先决条件的详情，请参阅先决条件。
有关 ThingWorx 用户配置文件所需权限的详情，请参阅 ThingWorx Platform 实体的权限。
这对您有帮助吗?