配置 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。
• 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 模型标记用于标识验证工作流事物。有关参考信息，请参阅 ModelerValidationFlowThing 示例。有关详细信息，请参阅 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-13.0.001.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 的参考配置。
|
||||
|
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。
|
||||
|
ModelerValidationFlowThing
|
此示例事物包含用于自定义 Windchill Modeler 验证工作流的参考。管理员可以根据业务需求自定义验证工作流事物。有关参考信息，请参阅 ModelerValidationFlowThing 示例。
|
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 模型标记词汇表中定义的“词语”值，用于标识远程服务器。
此步骤为可选步骤。仅当使用验证工作流时，才需要执行此步骤。有关参考，请参阅示例配置中的 ModelerValidationFlowThing 示例。
有关添加标记的详细信息，请参阅 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 资源属性的名称。
|
||
|
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 资源属性的名称。
|
||
|
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 实体的权限。