開放資料協議(OData)包括標準的 CRUD (建立、檢索、更新和刪除)操作，這些操作對映到 HTTP 方法的 POST、GET、PUT/MERGE 和 Delete 幾類。

此外，OData還支援進一步的服務操作：`Function Import`，這些操作可以由HTTP方法GET或POST呼叫，用於處理不能對映到標準 CRUD 操作的任何內容。

透過在資料模型中建立 `Function Import`，可以在 service Builder 中實現此類額外的服務操作。

例如，您可以為以下自定義操作建立函式匯入:

- Work Item confirmation

- 檢查航班的可用性

雖然建立新的函式匯入來呼叫自定義操作很簡單，但是如果可以使用標準的 CRUD 操作來呼叫要使用的操作，那麼就應該儘量避免函式匯入的建立。也就是說，應該只為不能使用標準操作呼叫的自定義操作建立函式匯入。

Function import 的例子如下：

![](https://img-blog.csdnimg.cn/img_convert/523fc3047998f9f9c75bbd687fb628ba.png)

Function Import 有下列屬性需要維護：

- Return Type Kind：

可以在 Complex Type 和 Entity Type 裡選擇，也可以選擇不返回任何結果。這種情況下，可以理解成一個產生side effect 的函式執行，比如審批某個 work item.

![](https://img-blog.csdnimg.cn/img_convert/17f84e0c23b6caec2170ed2171916fc2.png)

- Return Type: 輸入希望函式匯入返回的複雜型別或實體型別的名稱。可以使用輸入幫助從專案中選擇現有的複雜型別或實體型別。如果輸入幫助為空，則必須首先在專案中建立相關的複雜型別或實體型別。如果選擇了不返回，此欄位是不可編輯的。

- Return Cardinality：

![](https://img-blog.csdnimg.cn/img_convert/89f0a36edf3ebc79342994daa6775100.png)

如果 Function Import 的返回型別是實體型別，並且:

如果實體型別的關鍵屬性為核心型別 `Edm.DateTime`, `Edm.DateTimeoffset` 或 `Edm.Guid`，則返回基數選擇成 `0..1`是不允許的，因為對於這些核心型別，初始 ABAP 值並不是一個有效的 edm 值，它可能會導致執行時異常。因此無法選擇 `0..1`.

如果實體型別的關鍵屬性不是`Edm.DateTime`, `Edm.DateTimeoffset` 或 `Edm.Guid`，並返回基數 `0..1`, 此時會顯示一個警告訊息。因為根據 OData 標準，`0..1` 不建議用於任何核心型別。

升級時，如果你的專案包含Function Import，它的返回型別是一個實體型別，核心型別Edm的關鍵欄位。DateTime,電火花。DateTimeoffset或電火花。Guid，你會得到一條錯誤訊息。

選擇 HTTP 方法來呼叫函式匯入。如果不選擇HTTP方法，則必須使用GET或POST方法呼叫函式匯入。

SAP SEGW 事物碼裡的 Function Import

相關文章