依 ID 取得實體
使用「依 ID 取得實體」動作,可根據物件識別元清單擷取實體的詳細資訊。您可以從 Windchill 觸發器或在其輸出結構描述中提供物件 ID 的其他任何 Windchill 動作中取得 Windchill 物件識別元。
完成下列步驟,可在工作流程中使用「依 ID 取得實體」動作:
1. 將
Windchill·下的
「依 ID 取得實體」動作拖曳至畫布,並將指標置於該動作上,然後按一下
![](../../../../ThingWorx/images/SettingsIcon.png)
或連按兩下該動作。「依 ID 取得實體」視窗即會開啟。
2. 視需要編輯「標籤」。依預設,標籤名稱與動作名稱相同。
如果您之前已新增連接器類型,請選取適當的「連接器類型」,然後在「連接器名稱」下,選取連接器。
4. 按一下「測試」,驗證連接器。
5. 按一下
「Map 連接器」以使用與您用來填入輸入欄位之連接器不同的連接器來執行動作。在
「執行時間連接器」欄位中,提供有效的 Windchill 連接器名稱。如需有關
「Map 連接器」的詳細資訊,請參閱
使用 Map 連接器。
6. 在「實體類型」清單中,選取適當的實體類型。
7. 在「識別元清單」欄位中,以 Windchill OID 格式 (例如 OR:Type:ID) 指定物件 ID 的逗號分隔清單,其中,Type 是 Windchill 實體類型的內部名稱。
例如,OR:wt.part.WTPart:646192、OR:wt.part.WTPart:601234
您可對應來自之前動作的識別元清單。
8. 使用「查詢類型」清單中的選項,根據您想要輸出中所具有的物件內容來篩選輸出。
視實體傳回類型而定,查詢具有下列參數:
◦ 單一物件 -「選取內容」、「新增相關項目」
◦ 物件集合 -「篩選器」、「選取內容」、「新增相關項目」、「限制」、「跳過」
表單查詢 a. (僅適用於物件集合) 在「篩選器」群組下,執行下列操作: a. 在「連接方式」清單中,選取連接篩選子句的邏輯運算子。預設值為 and。 b. 在「篩選子句」下,按一下「新增」來新增篩選器: ▪ 「內容」- 選取內容。 ▪ 「相符條件」- 選取條件。條件取決於所選內容的類型,例如「字串」、「布林值」等。 ▪ 「值」- 輸入內容值。 按一下 「新增」可新增多個篩選器。按一下 ![](../../../../ThingWorx/images/DeleteIcon.png) 可刪除您新增的任何篩選器。 如果您新增相同內容,並在「連接方式」清單中選取 AND,則屬性會由 OR 運算子連接。 b. 在「選取內容」下,按一下「新增」,然後在「內容」清單中,選取您要擷取其值的內容。 按一下 「新增」可新增多個內容。按一下 ![](../../../../ThingWorx/images/DeleteIcon.png) 可刪除您新增的任何內容。 依預設,會在輸出中擷取 'key' 內容的值。 c. 在「新增相關項目」下,按一下「新增」,然後在 「相關項目」 清單中,選取您要擷取其值的相關專案。 按一下 「新增」可新增多個相關項目。按一下 ![](../../../../ThingWorx/images/DeleteIcon.png) 可刪除您新增的任何相關項目。 標記為 NavigationProperty 的任何內容會分類為「相關項目」。 d. (僅適用於物件集合) 在「限制」欄位中,輸入值來將輸出限制為指定的實體數。 e. (僅適用於物件集合) 在「跳過」欄位中,輸入您要略過的資源數。 |
「離散查詢」 a. (僅適用於物件集合) 在「篩選器」欄位中,以 propertyName operator 'value' [and | or | not]... 的格式指定 OData 篩選條件。 例如,number eq '0000222341' 或 name eq 'PTC' 或 startswith(name, 'PTC') b. 在「選取內容」欄位中,指定 OData 選取運算式,以提供內容名稱的逗號分隔清單。 依預設,會在輸出中擷取 'key' 內容的值。 c. 在「新增相關項目」欄位中,指定 OData 選取運算式,以提供相關項目的逗號分隔清單。 標記為 NavigationProperty 的任何內容會分類為「相關項目」。 d. (僅適用於物件集合) 在「限制」欄位中,輸入您要擷取的搜尋結果數目。 e. (僅適用於物件集合) 在「跳過」欄位中,輸入您要從結果中略過幾個排在最前面的搜尋結果。 |
「原始查詢」 在「查詢」欄位中,指定 OData 查詢運算式。 例如:$select=name,number&$expand=context&$top=2&$skip=1&$orderby=name asc&$filter=name eq 'PTC' 依預設,會在輸出中擷取 'key' 內容的值。 標記為 NavigationProperty 的任何內容會分類為「相關項目」。 根據實體傳回類型而定,您可以在查詢運算式中提供篩選器、限制及跳過參數。 |
9. 按一下「顯示其他欄位」,查看其他欄位。
◦ 在「取得 OData 註解」中,選取 true 以在輸出中包括 OData 注釋。預設值為 false。
10. 按一下「完成」。
輸出結構描述
「依 ID 取得實體」動作的輸出結構描述為動態結構描述。此結構描述會傳回一個物件陣列,其中包含所選實體類型的內容,以及所查詢之所有實體類型的識別元清單。
如果您選取「表單查詢」來指定查詢參數,輸出結構描述只會提供所選內容的詳細資訊。
針對「離散查詢」或「原始查詢」,輸出結構描述會包含所傳回物件的所有內容,但只提供所選內容的值。
下圖顯示預設輸出結構描述:
如果針對「實體類型」選取 CADDocuments,則輸出結構描述如下圖所示:
如果針對「實體類型」選取 CADDocuments,並將「內容」設定為 AuthoringApplication,則輸出結構描述如下圖所示:
如果針對「實體類型」選取 CADDocuments,並將「內容」設定為 AuthoringApplication,而將「相關項目」設定為 Versions,則輸出結構描述如下圖所示: