sap.ui.model.odata.v4.ODataModel 是应用 OData V4 服务的模型实现。

SAP Fiori 元素构建块 (sap.fe.macros) 必须与 SAPUI5 OData V4 模型一起应用，而不是智能控件（sap.ui.comp 库）或 sap.ui.table.AnalyticalTable（或剖析表计划）。不反对 TreeTable 与 SAPUI5 OData V4 模型一起应用。

OData V4 模型次要是为 OData V4 服务设计的。 不过，也能够通过适配器应用 OData V2 服务。OData V2 和 V4 两种模型的区别，参考这个链接。

无关更多信息，请参阅：应用 OData V4 模型应用 OData V2 服务

创立 OData V4 模型实例时，须要传入一个 map option 参数，该参数必须至多蕴含属性 serviceUrl 和同步模式。上面是一个例子：

sap.ui.define(["sap/ui/model/odata/v4/ODataModel"], function (ODataModel) {    var oModel = new ODataModel({        serviceUrl : "/sap/opu/odata4/IWBEP/V4_SAMPLE/default/IWBEP/V4_GW_SAMPLE_BASIC/0001/",        synchronizationMode : "None"    });});

也能够指定自定义 query：

sap.ui.define(["sap/ui/model/odata/v4/ODataModel"], function (ODataModel) {    var oModel = new ODataModel({        serviceUrl : "/sap/opu/odata4/IWBEP/V4_SAMPLE/default/IWBEP/V4_GW_SAMPLE_BASIC/0001/?customParam=foo",         synchronizationMode : "None"    });});

OData V4 模型容许开发人员指定是否将申请捆绑并作为批处理申请发送，以及何时发送申请。

参数 groupId 指定默认批处理组，默认为“$auto”。 能够应用参数 updateGroupId 为更新申请设置批处理组。 如果不设置此参数，将应用 groupId。

以下代码实例化了一个模型，该模型将批处理组 myAppUpdateGroup 中的所有更新申请捆绑在一起； 而后能够应用 oModel.submitBatch("myAppUpdateGroup") 发送批处理申请。

sap.ui.define(["sap/ui/model/odata/v4/ODataModel"], function (ODataModel) {    var oModel = new ODataModel({        serviceUrl : "/sap/opu/odata4/IWBEP/V4_SAMPLE/default/IWBEP/V4_GW_SAMPLE_BASIC/0001/",        synchronizationMode : "None",        updateGroupId : "myAppUpdateGroup"    });});

也能够应用 descriptor 文件来初始化 OData V4 模型。

上面是一个例子：

"dataSources": {            "default": {                "uri": "https://services.odata.org/TripPinRESTierService/(S(id))/",                "type": "OData",                "settings": {                    "odataVersion": "4.0"                }            }        }

上面是给 OData 模型设置 custom HTTP header 的形式：

 "sap.ui5" : {        "models" : {            "" : {                "dataSource" : "default",                "settings" : {                    "autoExpandSelect" : true,                    "httpHeaders" : {                        "custom" : "foo"                    },                    "synchronizationMode" : "None",                                     }            }        }    }

如果服务须要，OData V4 模型会通过“X-CSRF-Token”标头主动解决平安令牌。 为此，“X-CSRF-Token”标头以“Fetch”值结尾，并将蕴含在每个数据申请中。 如果数据响应蕴含“X-CSRF-Token”标头，则该新值将被记住并从那时起应用。 如果数据申请失败，状态为 403 且“X-CSRF-Token”响应头值为“required”（不辨别大小写），将获取新的平安令牌，并主动通明地反复数据申请。

应用“X-CSRF-Token”标头值“Fetch”通过服务 URL 上的 HEAD 申请获取新的平安令牌。 如果存在“X-CSRF-Token”的响应头值，则该响应值被保留到内存中以便下一次应用。

如果服务不须要“X-CSRF-Token”标头，OData V4 模型应该疏忽该申请标头。