配置 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。
• 使用 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-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 的參考組態。
|
||||
|
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。
|
||||
|
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 伺服器建立之連線的名稱。
|
|
標籤
|
在 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 核取方塊可顯示小型與大型預覽。
資料類型為 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 資源屬性的名稱。
|
||
|
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 實體的權限。