與其他應用程式整合 > 數位產品追溯 > 在 ThingWorx 中配置 Windchill Digital Product Traceability (DPT) Extension > 配置 Windchill DPT 延伸功能
配置 Windchill DPT 延伸功能
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 延伸功能，以使用 DPTExtensionPropertiesConfigThing。
• PTC-PLM:TRACELINKS ROOT SELECTION DIALOG 模型標籤，若新增至組態物件，會在「選取前後關聯」表中顯示根。若未新增該標籤，會在「選取前後關聯」表中顯示完整的樹結構。此標籤為 PTC Modeler 所特有。
• PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH 模型標籤，若新增至組態物件，會使用外部資源搜尋挑選器顯示外部 OSLC 資源。若未新增此標籤，選取對話方塊會顯示外部 OSLC 資源。依預設，會將 PTC-PLM:TRACELINKS-OSLC-QUERY-SEARCH 標籤新增至 PTCModelerConfigThing 與 PTCCodebeamerConfigThing。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 連結。
資源
* 
請確保針對上述所列實體啟用正確的權限。如需詳細資訊，請參閱 ThingWorx Platform 實體的預設權限。
* 
「模型標籤」由「詞彙」與「字詞」組成。例如，在 PTC-PLM-ValidationFlows:modeler 標籤中，PTC-PLM-ValidationFlows 是「詞彙」，modeler 是「字詞」的值。物件的模型標籤值具唯一性。
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 資料的所有對應與組態。
DPTExtensionPropertiesConfigThing
當使用 TRACELINKS-DPT-EXTENSION-PROPERTIES 模型標籤進行標記時，Windchill DPT 延伸功能可使用下列已定義內容。
• 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. 按一下「執行」。
成功執行服務後，會顯示下列訊息：「已成功套用權限」
iv. 核對是否已在「安全性」 > 「使用者群組」建立 DPTEndUserGroup 與 DPTConfiguratorGroup。確保已將必要的權限指派給 ThingWorx Platform 實體。
如需詳細資訊，請參閱 ThingWorx Platform 實體的預設權限。
* 
• PostDPTExtensionImport 服務只能由 ThingWorx 管理員執行。
• 執行服務後，DPTEndUserGroup 與 DPTConfiguratorGroup 的現有成員與權限會保留下來。
2. 在 ThingWorx Flow 中，請遵循下列指示，並為需要整合的 OSLC 系統建立新連線。請參閱「ThingWorx Platform 說明中心」的「建立及管理連線」主題：
a. 建立 OSLC 系統的「連接」。
▪ 針對基本驗證，請選取「OSLC 基本」連線類型。
▪ 針對 SSO 組態，請建立 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. 按一下「關閉」。
3. 配置 ThingWorx Platform 以與外部系統的 OSLC 伺服器整合。在 ThingWorx Platform 中，建立組態物件。
欲建立組態物件：
a. 導覽到「物件」 > 「新建」，並指定屬性值。選取 PTC.PLM.TraceLinks.OslcMappingConfigThingTemplate 作為「基礎物範本」。
b. 在「組態」標籤中，如下表所述配置對應。您可將 PTC 參考組態物件作為參考，並輸入 OSLC 系統的詳細資訊。
▪ OSLCServerMappingConfigTable
屬性
描述
Server
外部 OSLC 伺服器的名稱。
BaseUrl
外部 OSLC 伺服器的基礎 URL。
* 
若要對應至適當的 OSLC 伺服器，必須執行此步驟。
ConnectionObject
針對外部 OSLC 伺服器建立之連線的名稱。
標籤
在 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 核取方塊可顯示小型與大型預覽。
資料類型為 String 與 RichText 的屬性提供 IsPreview。兩種資料類型均可顯示小型預覽，但是，僅資料類型為 String 的屬性會顯示大型預覽。
▪ OSLCResourceShapeConfigTable
屬性
描述
OSLCResourceType
「需求網域」、「架構網域」或「變更網域」支援的資源類型，如在外部 OSLC 伺服器中所定義。OSLCResourceType 的值是在外部 OSLC 伺服器中配置之資源的名稱。
OSLCResourceShapeURI
不會以 OSLC 查詢服務顯露資源形式，但會以其他服務顯露資源形式之 OSLC 伺服器的 OSLC 資源形式 URI。例如，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。
「方法」
反向查詢服務所支援的 HTTP 請求方法。有效值為 GET 與 POST。
* 
• PTC Modeler 的有效值為 GET。
• PTC RV&S, 與 Codebeamer 的有效值為 POST。
TraceableUrlPrefix
與零件或可追蹤物件 URL 一起使用的前綴。例如，為 Codebeamer 指定 cb:traceLinkTargetURI。
* 
PTC Modeler、PTC RV&S 與 Codebeamer OSLC 伺服器支援反向查詢功能。請確保僅在支援 OSLC 伺服器的參考組態檔案中定義上述屬性值。
c. 按一下「儲存並繼續」。
這是否有幫助?