與其他應用程式整合 > 數位產品追溯 > 在 ThingWorx 中配置 Windchill Digital Product Traceability (DPT) Extension > 配置 Windchill DPT 延伸功能
配置 Windchill DPT 延伸功能
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 資源的服務。
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 延伸功能，以使用 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-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 的一部份。
Resource
* 
請確保針對上述所列實體啟用正確的權限。請參閱 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 延伸功能可使用下列已定義內容。
• 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 伺服器建立之連線的名稱。
標籤
在 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 核取方塊可顯示小型與大型預覽。
資料類型為 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 伺服器定義的內容名稱。例如，針對 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 實體的權限。
這是否有幫助?