執行函數
在 OData 中,動作用來對實體新增伺服器端操作。函數的目標可以是單一實體也可以是實體集合。函數可傳回不直接對應實體或集合的資料。
使用「執行函數」動作可執行在 OData 中繼資料中定義的函數。
完成下列步驟,可在工作流程中使用「執行函數」動作:
1. OData 下的「執行函數」動作拖曳至畫布,將指標置於動作上,然後按一下 或連按兩下該動作。「執行函數」視窗即會開啟。
2. 視需要編輯「標籤」。依預設,標籤名稱與動作名稱相同。
3. 欲新增 OData 連接器類型,請參閱支援的 OData 連接器類型
如果您之前已新增連接器類型,請選取適當的「連接器類型」,然後在「連接器名稱」下,選取連接器。
4. 按一下「測試」,驗證連接器。
5. 按一下「Map 連接器」以使用與您用來填入輸入欄位之連接器不同的連接器來執行動作。在「執行時間連接器」欄位中,提供有效的 OData 連接器名稱。如需有關「Map 連接器」的詳細資訊,請參閱使用 Map 連接器
6. 選取「包括參考網域」核取方塊,以顯示參考網域中 FunctionImport 所描述的所有函數。
7. 「函數」清單中,選取您要執行的 OData 函數。
輸入表單中的欄位會根據您選取的函數動態變更。
8. 選取「表單」以提供列在表單中之個別內容的輸入,或選取「指派 JSON」以指定具有所有必要內容的單一 JSON。
9. 使用「查詢類型」清單中的選項,根據您想要輸出中所具有的物件內容來篩選輸出。如果函數未傳回物件,則「查詢類型」選項無法使用。
根據函數的傳回類型,查詢具有下列參數:
單一物件 -「選取內容」「新增相關項目」
物件集合 -「篩選器」「選取內容」「新增相關項目」「限制」「跳過」
「查詢類型」清單中,選取表單查詢離散查詢原始查詢,可提供查詢參數。
表單查詢
a. (僅適用於物件集合) 在「篩選器」群組下,執行下列操作:
a. 「連接方式」清單中,選取連接篩選子句的邏輯運算子。預設值為 and
b. 「篩選子句」下,按一下「新增」來新增篩選器:
「內容」- 選取內容。
「相符條件」- 選取條件。條件取決於所選內容的類型,例如「字串」、「布林值」等。
「值」- 輸入內容值。
按一下「新增」可新增多個篩選器。按一下 可刪除您新增的任何篩選器。
如果您新增相同內容,並在「連接方式」清單中選取 AND,則屬性會由 OR 運算子連接。
b. 「選取內容」下,按一下「新增」,然後在「內容」清單中,選取您要擷取其值的內容。
按一下「新增」可新增多個內容。按一下 可刪除您新增的任何內容。
依預設,如果您選取任何內容,則會在輸出中擷取所選內容與 'key' 內容的值。如果您未選取任何內容,預設會將所有實體內容包含在輸出中。
c. 「新增相關項目」下,按一下「新增」,然後在 「相關項目」 清單中,選取您要擷取其值的相關專案。
按一下「新增」可新增多個相關項目。按一下 可刪除您新增的任何相關項目。
標記為 NavigationProperty 的任何內容會分類為「相關項目」
d. (僅適用於物件集合) 在「限制」欄位中,輸入值來將輸出限制為指定的實體數。
e. (僅適用於物件集合) 在「跳過」欄位中,輸入您要略過的資源數。
「離散查詢」
a. (僅適用於物件集合) 在「篩選器」欄位中,以 propertyName operator 'value' [and | or | not]... 的格式指定 OData 篩選條件。
例如,number eq '0000222341'name eq 'PTC'startswith(name, 'PTC')
b. 「選取內容」欄位中,指定 OData 選取運算式,以提供內容名稱的逗號分隔清單。
依預設,如果您在查詢中指定任何內容,則會在輸出中擷取所選內容的值。如果您未指定任何內容,預設會將所有實體內容包含在輸出中。
c. 「新增相關項目」欄位中,指定 OData 選取運算式,以提供相關項目的逗號分隔清單。
標記為 NavigationProperty 的任何內容會分類為「相關項目」
d. (僅適用於物件集合) 在「限制」欄位中,輸入您要擷取的搜尋結果數目。
e. (僅適用於物件集合) 在「跳過」欄位中,輸入您要從結果中略過幾個排在最前面的搜尋結果。
「原始查詢」
「查詢」欄位中,指定 OData 查詢運算式。
例如:$select=name,number&$expand=context&$top=2&$skip=1&$orderby=name asc&$filter=name eq 'PTC'
依預設,如果您在查詢中指定任何內容,則會在輸出中擷取所選內容的值。如果您未指定任何內容,預設會將所有實體內容包含在輸出中。
標記為 NavigationProperty 的任何內容會分類為「相關項目」
根據函數的傳回類型而定,您可以在查詢運算式中提供篩選器、限制及跳過參數。
10. 按一下「顯示其他欄位」
11. 「標題」群組下,按一下「新增」可將自訂標題新增至請求。提供「索引鍵」「值」對。
按一下「新增」可新增多個金鑰-值對。按一下 可刪除您新增的任何自訂標題。
12. 按一下「完成」
輸出結構描述
根據您選取的 OData 函數而定,「執行函數」動作會傳回動態輸出結構描述。如果函數沒有傳回類型,會傳回訊息字串。
如果您選取「表單查詢」來指定查詢參數,輸出結構描述只會提供所選內容的詳細資訊。
針對「離散查詢」「原始查詢」,輸出結構描述會包含所傳回物件的所有內容,但只提供所指定內容的值。
這是否有幫助?