如何在双向绑定的SAP UI5 V2 OData模型中新增记录

嘿，这个场景我太熟悉了，刚好之前做过类似的需求，完全可以复用你现有的表单来实现新增功能，核心是利用UI5 V2 OData模型的createEntry方法来创建待提交的空白实体，不需要手动解绑原有绑定（因为新的绑定上下文会直接覆盖旧的）。下面给你详细的步骤和代码示例：

一、核心思路：创建空白实体并绑定到表单 #

当用户点击「新增」按钮时，我们通过OData模型的createEntry方法生成一个空白的实体条目，这个条目会被临时存入模型的待变更集合中，之后直接把这个新条目绑定到你的表单即可。这样表单的双向绑定就会作用于这个新条目，不会影响表格里的现有记录。

具体代码实现（新增按钮的Press事件） #

onAddNewRecord: function() {
    // 获取页面的V2 OData模型
    const oODataModel = this.getView().getModel();
    // 替换成你实际的OData实体集名称，比如"Products"、"Orders"
    const sEntitySet = "/YourEntitySetName";

    // 创建空白实体，可按需设置默认属性值
    const oNewEntryContext = oODataModel.createEntry(sEntitySet, {
        // 可选：给某些字段设置初始默认值
        properties: {
            Status: "Draft",
            CreatedDate: new Date().toISOString().split("T")[0]
        },
        // 可选：新增成功后的回调
        success: () => {
            sap.m.MessageToast.show("记录新增成功！");
            // 刷新表格，让新增的记录显示出来
            oODataModel.refresh();
        },
        // 可选：新增失败后的错误处理
        error: (oError) => {
            sap.m.MessageToast.show(`新增失败：${oError.message}`);
        }
    });

    // 将新创建的空白实体绑定到表单（直接覆盖原有绑定上下文）
    const oForm = this.getView().byId("yourFormControlId");
    oForm.setBindingContext(oNewEntryContext);
}

二、提交新增记录 #

因为createEntry创建的空白条目已经被加入到模型的待变更队列中，所以你不需要修改现有的提交逻辑——直接调用model.submitChanges()就可以了，UI5会自动识别这是新增操作，发送POST请求到OData服务器。

三、取消新增的处理（可选） #

如果用户在新增过程中想放弃，你可以调用deleteCreatedEntry方法移除这个待提交的空白条目，然后把表单重新绑定回之前选中的记录（或者清空表单）：

onCancelAdd: function() {
    const oODataModel = this.getView().getModel();
    const oFormContext = this.getView().byId("yourFormControlId").getBindingContext();
    
    // 判断当前上下文是否是待创建的条目
    if (oODataModel.isCreatedEntry(oFormContext.getPath())) {
        // 删除待创建的空白条目
        oODataModel.deleteCreatedEntry(oFormContext);
    }

    // 可选：把表单重新绑定回表格选中的记录（如果需要）
    const oSelectedItem = this.getView().byId("yourTableId").getSelectedItem();
    if (oSelectedItem) {
        this.getView().byId("yourFormControlId").setBindingContext(oSelectedItem.getBindingContext());
    } else {
        // 如果没有选中记录，也可以清空表单的绑定
        this.getView().byId("yourFormControlId").setBindingContext(null);
    }
}

关键注意事项 #

• 确保实体集名称与你的OData服务定义完全一致（注意大小写，OData服务通常是区分大小写的）。
• 如果表单中有必填字段，建议在提交前做前端验证，避免服务器返回错误。
• 新增的条目在提交前只会存在于客户端模型中，提交后才会同步到服务器，所以如果页面刷新，未提交的新增条目会丢失。

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