kcode-pi 0.1.0

package/vendor/kingdee-skills/ok-cosmic/assets/snippets/data/DynamicObjectCrudSample.java

@@ -0,0 +1,205 @@
+/**
+ * 后端数据对象批量新建 / 批量保存 / 批量查询 / 批量复制示例。
+ * <p>
+ * 适用插件：操作插件、服务层、后台任务
+ * 优先封装：DynamicObjectUtils、OpUtils
+ * 原生兜底：BusinessDataServiceHelper、SaveServiceHelper、QueryServiceHelper
+ * 相关 lint 规则：STYLE-003、STYLE-008、STYLE-015
+ * <p>
+ * 使用场景：
+ * 1. 在服务层或操作插件中一次性构建多张单据数据包；
+ * 2. 批量保存、批量提交、批量复制备份；
+ * 3. 按主键集合、表头条件、单据体条件批量查询数据。
+ */
+package kd.cd.common.snippets.data;
+
+import kd.bos.dataentity.OperateOption;
+import kd.bos.dataentity.entity.DynamicObject;
+import kd.bos.dataentity.entity.DynamicObjectCollection;
+import kd.bos.dataentity.resource.ResManager;
+import kd.bos.orm.query.QCP;
+import kd.bos.orm.query.QFilter;
+import kd.bos.servicehelper.BusinessDataServiceHelper;
+import kd.bos.servicehelper.QueryServiceHelper;
+import kd.bos.servicehelper.operation.SaveServiceHelper;
+import kd.cd.common.operate.OpUtils;
+import kd.cd.common.util.DynamicObjectUtils;
+import kd.cd.core.util.CollectionUtils;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+public class DynamicObjectCrudSample {
+    private static final String FORM_ID = "kded_simplebill";
+    private static final String ENTRY_KEY = "entryentity";
+    private static final String SUBENTRY_KEY = "subentryentity";
+    private static final String FIELD_BILL_NO = "billno";
+    private static final String FIELD_STATUS = "billstatus";
+    private static final String FIELD_REMARK = "remark";
+    private static final String FIELD_ENTRY_TEXT = "kded_dealdesc";
+    private static final String FIELD_SUB_TEXT = "kded_subdec";
+
+    /**
+     * 批量构建表头数据包，适合导入暂存、批量生成草稿单据。
+     */
+    public DynamicObject[] newBills(List<String> billNos) {
+        List<DynamicObject> bills = new ArrayList<>(billNos.size());
+        int index = 1;
+        for (String billNo : billNos) {
+            DynamicObject bill = DynamicObjectUtils.newDynamicObject(FORM_ID);
+            bill.set(FIELD_BILL_NO, billNo);
+            bill.set(FIELD_STATUS, "A");
+            bill.set(FIELD_REMARK, String.format(
+                    ResManager.loadKDString("批量代码创建-%s", "DynamicObjectCrudSample_0", "kd-cd-common-snippets"),
+                    index
+            ));
+            bills.add(bill);
+            index++;
+        }
+        return bills.toArray(new DynamicObject[0]);
+    }
+
+    /**
+     * 批量构建含单据体 / 子单据体的数据包，适合批量造单后统一保存。
+     */
+    public DynamicObject[] newBillsWithEntryAndSubEntry(List<String> billNos) {
+        DynamicObject[] bills = newBills(billNos);
+        for (int index = 0; index < bills.length; index++) {
+            DynamicObject bill = bills[index];
+            DynamicObjectCollection entryRows = bill.getDynamicObjectCollection(ENTRY_KEY);
+            DynamicObject entryRow = entryRows.addNew();
+            entryRow.set(FIELD_ENTRY_TEXT, String.format(
+                    ResManager.loadKDString("批量代码新增单据体-%s", "DynamicObjectCrudSample_1", "kd-cd-common-snippets"),
+                    index + 1
+            ));
+
+            DynamicObjectCollection subRows = entryRow.getDynamicObjectCollection(SUBENTRY_KEY);
+            DynamicObject subRow = subRows.addNew();
+            subRow.set(FIELD_SUB_TEXT, String.format(
+                    ResManager.loadKDString("批量代码新增子单据体-%s", "DynamicObjectCrudSample_2", "kd-cd-common-snippets"),
+                    index + 1
+            ));
+        }
+        return bills;
+    }
+
+    /**
+     * 批量保存并触发保存校验 / 保存插件。
+     */
+    public void saveOpBatch(Collection<DynamicObject> bills) {
+        if (CollectionUtils.isNotEmpty(bills)) {
+            SaveServiceHelper.saveOperate(FORM_ID, bills.toArray(new DynamicObject[0]), OperateOption.create());
+        }
+    }
+
+    /**
+     * 批量直接保存，适合已完成预校验的后台修数 / 中间表同步。
+     */
+    public void saveBatchDirectly(Collection<DynamicObject> bills) {
+        if (CollectionUtils.isNotEmpty(bills)) {
+            SaveServiceHelper.save(bills.toArray(new DynamicObject[0]));
+        }
+    }
+
+    /**
+     * 批量提交，失败抛出异常，适合保存后统一提交流程。
+     */
+    public void submitBatch(Collection<DynamicObject> bills) {
+        if (CollectionUtils.isNotEmpty(bills)) {
+            OpUtils.executeOperateOrThrow("submit", FORM_ID, bills.toArray(new DynamicObject[0]));
+        }
+    }
+
+    /**
+     * 按主键集合批量加载实体包，适合后续统一修改后再保存。
+     */
+    public DynamicObject[] loadByPks(Collection<?> pkValues) {
+        return BusinessDataServiceHelper.load(
+                FORM_ID,
+                "id,billno,billstatus,remark," + ENTRY_KEY + "." + FIELD_ENTRY_TEXT,
+                new QFilter("id", QCP.in, pkValues).toArray()
+        );
+    }
+
+    /**
+     * 按创建人批量查询单据，适合批量重算、批量审核前的候选集准备。
+     */
+    public DynamicObject[] queryByCreatorNames(Collection<String> creatorNames) {
+        return BusinessDataServiceHelper.load(
+                FORM_ID,
+                "id,billno,creator,creator.id,createtime",
+                new QFilter("creator.name", QCP.in, creatorNames).toArray()
+        );
+    }
+
+    /**
+     * 按分录业务员批量查询扁平结果，适合做分组、校验、汇总，不适合直接回写保存。
+     */
+    public DynamicObjectCollection queryByEntryUserNames(Collection<String> userNames) {
+        return QueryServiceHelper.query(
+                FORM_ID,
+                "id,billno,entryentity.kded_dealuser.name,entryentity.kded_dealdesc",
+                new QFilter("entryentity.kded_dealuser.name", QCP.in, userNames).toArray()
+        );
+    }
+
+    // ==================== 特殊情况：基础资料属性字段（BasedataPropField）查询取值 ====================
+    // BasedataPropField 是基础资料的派生显示字段，它的标识（如 e_materialname）是表单控件标识，
+    // 在查询的 select 字段和 QFilter 中必须使用元数据中的「引用关系」路径。
+    //
+    // 示例：元数据查询结果
+    //   标识: e_materialname | 类型: BasedataPropField | 引用关系: e_material.name
+    //
+    // ✅ 正确：使用引用关系路径
+    //   select: "entryentity.e_material.name"
+    //   filter: new QFilter("entryentity.e_material.name", QCP.like, "%某物料%")
+    //
+    // ❌ 错误：使用控件标识（查询时无法识别）
+    //   select: "entryentity.e_materialname"
+
+    /**
+     * 按分录物料名称查询，演示 BasedataPropField 在查询中的正确用法。
+     */
+    public DynamicObjectCollection queryByMaterialName(String materialName) {
+        return QueryServiceHelper.query(
+                FORM_ID,
+                // ✅ select 中使用引用关系路径 e_material.name，而非控件标识 e_materialname
+                "id,billno," + ENTRY_KEY + ".e_material.name," + ENTRY_KEY + ".e_material.number",
+                new QFilter(ENTRY_KEY + ".e_material.name", QCP.like, "%" + materialName + "%").toArray()
+        );
+    }
+
+    /**
+     * 批量复制单据作为备份包，适合修改前先批量做快照。
+     */
+    public DynamicObject[] cloneBatchForBackup(Collection<DynamicObject> origins) {
+        List<DynamicObject> backups = new ArrayList<>(origins.size());
+        for (DynamicObject origin : origins) {
+            if (origin == null) {
+                continue;
+            }
+            DynamicObject backup = DynamicObjectUtils.clone(origin);
+            backup.set(FIELD_REMARK, String.format(
+                    ResManager.loadKDString("批量备份-%s", "DynamicObjectCrudSample_3", "kd-cd-common-snippets"),
+                    origin.getString(FIELD_BILL_NO)
+            ));
+            backups.add(backup);
+        }
+        return backups.toArray(new DynamicObject[0]);
+    }
+
+    /**
+     * 把批量加载结果转成主键映射，便于后续本地批量反写。
+     */
+    public Map<Object, DynamicObject> toPkMap(Collection<?> pkValues) {
+        return Arrays.stream(loadByPks(pkValues)).collect(Collectors.toMap(
+                DynamicObject::getPkValue,
+                bill -> bill,
+                (left, right) -> left
+        ));
+    }
+}

package/vendor/kingdee-skills/ok-cosmic/assets/snippets/data/DynamicObjectOpsSample.java

@@ -0,0 +1,100 @@
+/**
+ * DynamicObjectUtils 常见能力示例。
+ * <p>
+ * 适用插件：表单插件、操作插件、服务层
+ * 优先封装：DynamicObjectUtils
+ * 原生兜底：DynamicObject、DynamicObjectCollection 原生 API
+ * 相关 lint 规则：STYLE-006、STYLE-015
+ * <p>
+ * 使用场景：
+ * 1. 脱离表单模型后，直接操作 DynamicObject / DynamicObjectCollection；
+ * 2. 安全取值、批量收集字段值、对象克隆与序列化；
+ * 3. 不再重复表单层的 getModel().getValue / setValue 写法。
+ */
+package kd.cd.common.snippets.data;
+
+import kd.bos.dataentity.entity.DynamicObject;
+import kd.bos.dataentity.entity.DynamicObjectCollection;
+import kd.cd.common.util.DynamicObjectUtils;
+import kd.cd.core.util.CollectionUtils;
+
+import java.math.BigDecimal;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+public class DynamicObjectOpsSample {
+
+    // ==================== 场景1：原生取值 ====================
+
+    public static Object getValue(DynamicObject bill, String fieldKey) {
+        return DynamicObjectUtils.nullSafeGet(bill, fieldKey);
+    }
+
+    public static Object nullSafeGet(DynamicObject bill, String fieldPath) {
+        return DynamicObjectUtils.nullSafeGet(bill, fieldPath);
+    }
+
+    public static String getBaseDataNumber(DynamicObject bill, String fieldKey) {
+        Object number = DynamicObjectUtils.nullSafeGet(bill, fieldKey + ".number");
+        return number == null ? "" : String.valueOf(number);
+    }
+
+    // ==================== 特殊情况：基础资料属性字段（BasedataPropField）取值 ====================
+    // BasedataPropField 是基础资料的派生显示字段，它的标识（如 e_materialname）是表单控件标识，
+    // 在 DynamicObject 上取值时必须使用元数据中的「引用关系」路径。
+    //
+    // 示例：元数据查询结果
+    //   标识: e_materialname | 类型: BasedataPropField | 引用关系: e_material.name
+    //
+    // ✅ 正确：使用引用关系路径
+    //   DynamicObjectUtils.nullSafeGet(entryRow, "e_material.name");
+    //
+    // ❌ 错误：使用控件标识（DynamicObject 上不存在该属性）
+    //   DynamicObjectUtils.nullSafeGet(entryRow, "e_materialname");
+
+    // ==================== 场景2：原生赋值 ====================
+
+    public static void setValue(DynamicObject bill, String fieldKey, Object value) {
+        if (bill != null) {
+            bill.set(fieldKey, value);
+        }
+    }
+
+    public static void batchSetValues(DynamicObject bill, Map<String, Object> fieldValues) {
+        if (CollectionUtils.isEmpty(fieldValues)) {
+            return;
+        }
+        fieldValues.forEach(bill::set);
+    }
+
+    // ==================== 场景3：分录集合操作 ====================
+
+    public static DynamicObjectCollection getEntryRows(DynamicObject bill, String entryKey) {
+        return bill.getDynamicObjectCollection(entryKey);
+    }
+
+    public static BigDecimal sumEntryAmount(DynamicObject bill, String entryKey, String amountField) {
+        return DynamicObjectUtils.sumOf(getEntryRows(bill, entryKey), amountField);
+    }
+
+    public static Set<Object> collectEntryIds(Collection<DynamicObject> rows) {
+        return CollectionUtils.isEmpty(rows) ? Collections.emptySet() : DynamicObjectUtils.setOfIds(rows);
+    }
+
+    public static List<String> collectEntryNumbers(Collection<DynamicObject> rows, String numberField) {
+        return CollectionUtils.isEmpty(rows) ? Collections.emptyList() : DynamicObjectUtils.listOf(rows, numberField);
+    }
+
+    // ==================== 场景4：调试/排查 ====================
+
+    public static boolean containsProperty(DynamicObject bill, String fieldKey) {
+        return DynamicObjectUtils.containsKey(bill, fieldKey);
+    }
+
+    public static Map<String, Object> dumpBill(DynamicObject bill) {
+        return DynamicObjectUtils.dump(bill);
+    }
+}

package/vendor/kingdee-skills/ok-cosmic/assets/snippets/form/BeforeOperationConfirmSample.java

@@ -0,0 +1,217 @@
+/**
+ * beforeDoOperation 拦截 + 弹窗确认后继续执行示例。
+ * <p>
+ * 适用插件：表单插件、单据插件
+ * 优先封装：ShowParameterUtils、AbstractFormPluginExt
+ * 原生兜底：FormOperate、OperateOption、ClosedCallBackEvent
+ * 相关 lint 规则：SCENE-008、STYLE-013
+ * <p>
+ * 使用场景：
+ * 1. 提交前先做内存校验，命中风险则打开说明页；
+ * 2. 部分检查必须先保存拿到主键，再在 afterDoOperation 中弹结果页；
+ * 3. 用户确认后，带 continue 标记重新执行原提交操作。
+ */
+package kd.cd.common.snippets.form;
+
+import kd.bos.bill.OperationStatus;
+import kd.bos.dataentity.OperateOption;
+import kd.bos.dataentity.entity.DynamicObject;
+import kd.bos.dataentity.entity.DynamicObjectCollection;
+import kd.bos.dataentity.resource.ResManager;
+import kd.bos.form.CloseCallBack;
+import kd.bos.form.FormShowParameter;
+import kd.bos.form.ShowType;
+import kd.bos.form.events.AfterDoOperationEventArgs;
+import kd.bos.form.events.BeforeDoOperationEventArgs;
+import kd.bos.form.events.ClosedCallBackEvent;
+import kd.bos.form.operate.FormOperate;
+import kd.bos.orm.query.QCP;
+import kd.bos.orm.query.QFilter;
+import kd.cd.common.entity.EntityUtils;
+import kd.cd.common.form.ShowParameterUtils;
+import kd.cd.common.plugin.AbstractFormPluginExt;
+import kd.cd.common.util.DynamicObjectUtils;
+import kd.cd.core.util.BigDecimalUtils;
+import kd.cd.core.util.CollectionUtils;
+import kd.bos.servicehelper.QueryServiceHelper;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+public class BeforeOperationConfirmSample extends AbstractFormPluginExt {
+    private static final String OP_SAVE = "save";
+    private static final String OP_SUBMIT = "submit";
+    private static final String CHECK_WARNING_FORM_ID = "xxxx_billcheckresult";
+    private static final String CHECK_WARNING_CALLBACK_ID = "bill_check_warning";
+    private static final String CHECK_RESULT_FORM_ID = "xxxx_billcheckdetail";
+    private static final String CHECK_RESULT_CALLBACK_ID = "bill_check_detail";
+    private static final String OPTION_CONTINUE = "ContinueToSubmit";
+    private static final String OPTION_SAVE_THEN_CHECK = "SaveThenCheck";
+    private static final String ENTRY_KEY = "billentry";
+    private static final String FIELD_SUPPLIER = "supplier";
+    private static final String FIELD_QTY = "qty";
+    private static final String FIELD_TAX_AMOUNT = "taxamount";
+    private static final String RES_APP_ID = "kd-cd-common-snippets";
+
+    @Override
+    public void beforeDoOperation(BeforeDoOperationEventArgs args) {
+        super.beforeDoOperation(args);
+        if (args.isCancel()) {
+            return;
+        }
+
+        FormOperate operate = (FormOperate) args.getSource();
+        if (!OP_SUBMIT.equals(operate.getOperateKey()) || isContinueSubmit(operate.getOption())) {
+            return;
+        }
+
+        List<String> warnings = collectSubmitWarnings();
+        if (CollectionUtils.isNotEmpty(warnings)) {
+            openWarningConfirmForm(warnings);
+            args.setCancel(true);
+            return;
+        }
+
+        Object billPk = getModel().getDataEntity().getPkValue();
+        if (EntityUtils.isEmptyPk(billPk)) {
+            OperateOption saveOption = OperateOption.create();
+            saveOption.setVariableValue(OPTION_SAVE_THEN_CHECK, "true");
+            getView().invokeOperation(OP_SAVE, saveOption);
+            args.setCancel(true);
+            return;
+        }
+
+        List<Object> resultIds = queryCheckResultIds(billPk);
+        if (CollectionUtils.isNotEmpty(resultIds)) {
+            openPersistedCheckResultForm(resultIds);
+            args.setCancel(true);
+        }
+    }
+
+    @Override
+    public void afterDoOperation(AfterDoOperationEventArgs args) {
+        super.afterDoOperation(args);
+        FormOperate operate = (FormOperate) args.getSource();
+        if (OP_SAVE.equals(operate.getOperateKey())) {
+            handleSaveAfterCheck(operate, args);
+            return;
+        }
+        if (OP_SUBMIT.equals(operate.getOperateKey())
+                && args.getOperationResult().isSuccess()
+                && isContinueSubmit(operate.getOption())) {
+            args.getOperationResult().setMessage(ResManager.loadKDString("提交成功：已按确认结果继续执行", "BeforeOperationConfirmSample_3", RES_APP_ID));
+        }
+    }
+
+    @Override
+    public void closedCallBack(ClosedCallBackEvent e) {
+        super.closedCallBack(e);
+        // 回调数据类型和确认页的回传类型保持一致即可。
+        String actionId = e.getActionId();
+        if (!CHECK_WARNING_CALLBACK_ID.equals(actionId) && !CHECK_RESULT_CALLBACK_ID.equals(actionId)) {
+            return;
+        }
+        @SuppressWarnings("unchecked")
+        Map<String, Object> returnData = (Map<String, Object>) e.getReturnData();
+        if (returnData != null && shouldContinueSubmit(returnData)) {
+            invokeContinueSubmit();
+        }
+    }
+
+    private void handleSaveAfterCheck(FormOperate operate, AfterDoOperationEventArgs args) {
+        if (!"true".equalsIgnoreCase(operate.getOption().getVariableValue(OPTION_SAVE_THEN_CHECK, "false"))) {
+            return;
+        }
+        if (!args.getOperationResult().isSuccess()) {
+            return;
+        }
+
+        Object billPk = getModel().getDataEntity().getPkValue();
+        List<Object> resultIds = queryCheckResultIds(billPk);
+        if (CollectionUtils.isEmpty(resultIds)) {
+            invokeContinueSubmit();
+            return;
+        }
+        openPersistedCheckResultForm(resultIds);
+    }
+
+    private void openWarningConfirmForm(List<String> warnings) {
+        FormShowParameter fsp = ShowParameterUtils.getForm(
+                CHECK_WARNING_FORM_ID,
+                OperationStatus.VIEW,
+                ShowType.Modal,
+                "900px",
+                "600px"
+        );
+        fsp.setCustomParam("warnings", warnings);
+        fsp.setCloseCallBack(new CloseCallBack(this, CHECK_WARNING_CALLBACK_ID));
+        getView().showForm(fsp);
+    }
+
+    private void openPersistedCheckResultForm(List<Object> resultIds) {
+        FormShowParameter fsp = ShowParameterUtils.getForm(
+                CHECK_RESULT_FORM_ID,
+                OperationStatus.VIEW,
+                ShowType.Modal,
+                "960px",
+                "640px"
+        );
+        fsp.setCustomParam("sourceBillId", String.valueOf(getModel().getDataEntity().getPkValue()));
+        fsp.setCustomParam("resultIds", resultIds);
+        fsp.setCloseCallBack(new CloseCallBack(this, CHECK_RESULT_CALLBACK_ID));
+        getView().showForm(fsp);
+    }
+
+    private void invokeContinueSubmit() {
+        OperateOption option = OperateOption.create();
+        option.setVariableValue(OPTION_CONTINUE, "true");
+        getView().invokeOperation(OP_SUBMIT, option);
+    }
+
+    private List<Object> queryCheckResultIds(Object billPk) {
+        if (EntityUtils.isEmptyPk(billPk)) {
+            return Collections.emptyList();
+        }
+        QFilter filter = new QFilter("sourcebill.id", QCP.equals, billPk);
+        DynamicObjectCollection rows = QueryServiceHelper.query(CHECK_RESULT_FORM_ID, "id", filter.toArray());
+        return DynamicObjectUtils.listOf(rows, "id");
+    }
+
+    private boolean shouldContinueSubmit(Map<String, Object> returnData) {
+        return Boolean.TRUE.equals(returnData.get("confirmed"));
+    }
+
+    private List<String> collectSubmitWarnings() {
+        DynamicObjectCollection entryRows = getModel().getDataEntity(true).getDynamicObjectCollection(ENTRY_KEY);
+        List<String> warnings = new ArrayList<>(entryRows.size() * 3);
+        for (int i = 0; i < entryRows.size(); i++) {
+            DynamicObject row = entryRows.get(i);
+            int seq = i + 1;
+            if (row.getDynamicObject(FIELD_SUPPLIER) == null) {
+                warnings.add(String.format(
+                        ResManager.loadKDString("第%s行未选择供应商", "BeforeOperationConfirmSample_0", RES_APP_ID),
+                        seq
+                ));
+            }
+            if (BigDecimalUtils.lessEqualsZero(row.getBigDecimal(FIELD_QTY))) {
+                warnings.add(String.format(
+                        ResManager.loadKDString("第%s行数量必须大于0", "BeforeOperationConfirmSample_1", RES_APP_ID),
+                        seq
+                ));
+            }
+            if (row.getBigDecimal(FIELD_TAX_AMOUNT) == null) {
+                warnings.add(String.format(
+                        ResManager.loadKDString("第%s行税额未计算，请先刷新金额", "BeforeOperationConfirmSample_2", RES_APP_ID),
+                        seq
+                ));
+            }
+        }
+        return warnings;
+    }
+
+    private boolean isContinueSubmit(OperateOption option) {
+        return option != null && "true".equalsIgnoreCase(option.getVariableValue(OPTION_CONTINUE, "false"));
+    }
+}

package/vendor/kingdee-skills/ok-cosmic/assets/snippets/form/ConfirmDialogSample.java

@@ -0,0 +1,131 @@
+/**
+ * 确认框弹窗 + 回调处理示例。
+ * <p>
+ * 适用插件：表单插件、单据插件
+ * 优先封装：AbstractFormPluginExt、PageCache
+ * 原生兜底：ConfirmCallBackListener、MessageBoxOptions、Toolbar
+ * 相关 lint 规则：SCENE-005、STYLE-013、RESOURCE-002
+ * <p>
+ * 使用场景：对分录批量标记、批量关闭、批量清理等动作做二次确认。
+ * 关键点：
+ * 1. 普通自定义按钮可在 itemClick 中直接弹确认框；
+ * 2. 标准工具栏按钮更适合在 beforeItemClick 中先拦截，再在确认后重放原动作；
+ * 3. pageCache 可用于避免确认回调后二次拦截。
+ */
+package kd.cd.common.snippets.form;
+
+import kd.bos.dataentity.entity.DynamicObject;
+import kd.bos.dataentity.resource.ResManager;
+import kd.bos.form.ConfirmCallBackListener;
+import kd.bos.form.MessageBoxOptions;
+import kd.bos.form.MessageBoxResult;
+import kd.bos.form.control.Toolbar;
+import kd.bos.form.control.events.BeforeItemClickEvent;
+import kd.bos.form.control.events.ItemClickEvent;
+import kd.bos.form.events.MessageBoxClosedEvent;
+import kd.cd.common.plugin.AbstractFormPluginExt;
+import kd.cd.core.util.CollectionUtils;
+
+import java.util.EventObject;
+import java.util.List;
+
+public class ConfirmDialogSample extends AbstractFormPluginExt {
+    private static final String ENTRY_TOOLBAR = "tbmainentry";
+    private static final String MAIN_TOOLBAR = "toolbarap";
+    private static final String ITEM_MARK_SELECTED = "xxxx_markselected";
+    private static final String CALLBACK_MARK_SELECTED = "xxxx_markselected_confirm";
+    private static final String ITEM_COPY_HISTORY = "btn_copyhis";
+    private static final String PAGE_CACHE_CONFIRM_COPY_HISTORY = "pagecache_confirm_copyhis";
+    private static final String ENTRY_KEY = "entryentity";
+    private static final String FIELD_MARKED = "xxxx_selected";
+    private static final String RES_APP_ID = "kd-cd-common-snippets";
+
+    // --- 在 registerListener 中注册工具栏按钮 ---
+    @Override
+    public void registerListener(EventObject e) {
+        super.registerListener(e);
+        addItemClickListeners(ENTRY_TOOLBAR, MAIN_TOOLBAR);
+    }
+
+    // --- 标准工具栏按钮：先拦截，再确认后重放原动作 ---
+    @Override
+    public void beforeItemClick(BeforeItemClickEvent evt) {
+        super.beforeItemClick(evt);
+        if (!ITEM_COPY_HISTORY.equals(evt.getItemKey())) {
+            return;
+        }
+
+        if ("true".equals(getView().getPageCache().get(PAGE_CACHE_CONFIRM_COPY_HISTORY))) {
+            getView().getPageCache().put(PAGE_CACHE_CONFIRM_COPY_HISTORY, "false");
+            return;
+        }
+
+        evt.setCancel(true);
+        getView().showConfirm(
+                ResManager.loadKDString("获取上年同期会覆盖当前取数结果，确认继续吗？", "ConfirmDialogSample_0", RES_APP_ID),
+                MessageBoxOptions.YesNo,
+                new ConfirmCallBackListener(ITEM_COPY_HISTORY, this)
+        );
+    }
+
+    // --- 按钮点击后先弹确认框 ---
+    @Override
+    public void itemClick(ItemClickEvent evt) {
+        super.itemClick(evt);
+        if (!ITEM_MARK_SELECTED.equals(evt.getItemKey())) {
+            return;
+        }
+
+        List<DynamicObject> selectedRows = getEntrySelectRowsEntity(ENTRY_KEY);
+        if (CollectionUtils.isEmpty(selectedRows)) {
+            getView().showTipNotification(ResManager.loadKDString("请先选择要处理的分录行", "ConfirmDialogSample_1", RES_APP_ID));
+            return;
+        }
+
+        ConfirmCallBackListener listener = new ConfirmCallBackListener(CALLBACK_MARK_SELECTED, this);
+        getView().showConfirm(ResManager.loadKDString("确定要标记所选分录吗？", "ConfirmDialogSample_2", RES_APP_ID), MessageBoxOptions.YesNo, listener);
+    }
+
+    // --- 用户确认后执行实际逻辑 ---
+    @Override
+    public void confirmCallBack(MessageBoxClosedEvent evt) {
+        super.confirmCallBack(evt);
+        String callBackId = evt.getCallBackId();
+        if (CALLBACK_MARK_SELECTED.equals(callBackId)) {
+            if (MessageBoxResult.Yes.equals(evt.getResult())) {
+                markSelectedRows();
+            }
+            return;
+        }
+        if (ITEM_COPY_HISTORY.equals(callBackId)) {
+            tryReplayToolbarAction(evt);
+        }
+    }
+
+    private void tryReplayToolbarAction(MessageBoxClosedEvent evt) {
+        if (!MessageBoxResult.Yes.equals(evt.getResult())) {
+            return;
+        }
+        getView().getPageCache().put(PAGE_CACHE_CONFIRM_COPY_HISTORY, "true");
+        Toolbar toolbar = getControl(MAIN_TOOLBAR);
+        toolbar.addItemClickListener(this);
+        toolbar.itemClick(ITEM_COPY_HISTORY, "");
+    }
+
+    private void markSelectedRows() {
+        List<DynamicObject> selectedRows = getEntrySelectRowsEntity(ENTRY_KEY);
+        if (CollectionUtils.isEmpty(selectedRows)) {
+            return;
+        }
+
+        for (DynamicObject row : selectedRows) {
+            row.set(FIELD_MARKED, true);
+        }
+
+        getView().updateView(ENTRY_KEY);
+        getView().showSuccessNotification(String.format(
+                ResManager.loadKDString("已标记%s行分录", "ConfirmDialogSample_3", RES_APP_ID),
+                selectedRows.size()
+        ));
+    }
+}