SAP Business One扩展：sap.ui.model.odata.type.DateTimeOffset非法错误求助

问题分析 #

沙箱模式自动生成的edm.DateTimeOffset类型模拟数据格式看似符合ISO 8601标准，但SAP Fiori的sap.ui.model.odata.type.DateTimeOffset解析仍报错，核心原因是OData v2规范对DateTimeOffset的严格要求——沙箱生成的Z后缀格式在部分OData v2解析逻辑中不被兼容，规范要求必须使用+00:00这类明确的时区偏移格式。

解决方案 #

1. 直接修改模拟数据文件 #

找到webapp/localService/mockdata/目录下对应实体集的JSON文件，将日期字段的Z替换为+00:00：

{
  DocEntry: 1,
  U_CardCode: "U_CardCode_0",
  U_CardName: "U_CardName_0",
  U_DocCurrency: "U_DocCurrency_0",
  U_DocTotal: "",
  U_DueDate: "2017-04-13T14:50:39.000+00:00",
  U_Status: "U_Status_0",
  U_SupplierInvNo: "U_SupplierInvNo_0",
}

2. 扩展模拟服务器自动转换格式 #

在webapp/localService/mockserver.js中添加拦截逻辑，自动处理所有DateTimeOffset类型字段：

sap.ui.define([
  "sap/ui/core/util/MockServer"
], function(MockServer) {
  "use strict";

  return {
    init: function() {
      const oMockServer = new MockServer({
        rootUri: "/b1s/v2/"
      });

      // 拦截响应并转换日期格式
      oMockServer.attachAfter("GET", function(oEvent) {
        const oResponse = oEvent.getParameter("response");
        if (!oResponse?.data) return;

        const aEntities = Array.isArray(oResponse.data) ? oResponse.data : [oResponse.data];
        aEntities.forEach(oEntity => {
          Object.keys(oEntity).forEach(sKey => {
            const sValue = oEntity[sKey];
            if (typeof sValue === "string" && sValue.endsWith("Z")) {
              oEntity[sKey] = sValue.replace("Z", "+00:00");
            }
          });
        });
      });

      // 加载元数据与模拟数据
      oMockServer.simulate("webapp/localService/metadata.xml", {
        mockdataBaseUrl: "webapp/localService/mockdata",
        generateMissingMockData: true
      });

      oMockServer.start();
    }
  };
});

3. 关闭模型严格解析 #

在manifest.json的OData模型配置中，关闭DateTimeOffset的严格解析限制：

"models": {
  "": {
    "dataSource": "mainService",
    "settings": {
      "odataVersion": "2.0",
      "typeMappings": {
        "Edm.DateTimeOffset": {
          "class": "sap.ui.model.odata.type.DateTimeOffset",
          "settings": {
            "strictParsing": false
          }
        }
      }
    }
  }
}

验证步骤 #

1. 执行npm run start-local重启沙箱服务
2. 刷新页面，检查Illegal sap.ui.model.odata.type.DateTimeOffset报错是否消失
3. 确认U_DueDate字段正常渲染

内容的提问来源于stack exchange，提问作者GreysonTyrus