kcode-pi 0.1.0

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

@@ -0,0 +1,253 @@
+/**
+ * 打开单据/动态表单弹窗并处理关闭回调示例。
+ * <p>
+ * 适用插件：表单插件、单据插件
+ * 优先封装：ShowParameterUtils、DynamicObjectUtils
+ * 原生兜底：CloseCallBack、ClosedCallBackEvent、FormShowParameter / ListShowParameter
+ * 相关 lint 规则：当前无专门规则，可参考 STYLE-013、SCENE-005
+ * <p>
+ * 使用场景：
+ * 1. 打开 F7 列表让用户多选基础资料；
+ * 2. 打开自定义动态表单并按当前分录回填结果；
+ * 3. 打开特殊成员 F7，并按动态 actionId 回填多选基础资料。
+ */
+package kd.cd.common.snippets.form;
+
+import kd.bos.bill.OperationStatus;
+import kd.bos.dataentity.entity.DynamicObject;
+import kd.bos.dataentity.entity.DynamicObjectCollection;
+import kd.bos.dataentity.entity.MulBasedataDynamicObjectCollection;
+import kd.bos.dataentity.resource.ResManager;
+import kd.bos.entity.datamodel.ListSelectedRow;
+import kd.bos.entity.datamodel.ListSelectedRowCollection;
+import kd.bos.form.CloseCallBack;
+import kd.bos.form.FormShowParameter;
+import kd.bos.form.ShowType;
+import kd.bos.form.events.ClosedCallBackEvent;
+import kd.bos.form.IPageCache;
+import kd.bos.list.ListFilterParameter;
+import kd.bos.list.ListShowParameter;
+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.CharSequenceUtils;
+import kd.cd.core.util.CollectionUtils;
+
+import java.util.LinkedHashSet;
+import java.util.Set;
+
+public class OpenBillModalSample extends AbstractFormPluginExt {
+    private static final String CALLBACK_SELECT_SUPPLIER = "select_supplier";
+    private static final String CALLBACK_SELECT_BUDGET = "select_budget";
+    private static final String CALLBACK_SELECT_DIM_MEMBER_PREFIX = "select_dim_member:";
+    private static final String SUPPLIER_ENTRY = "entrysupplier";
+    private static final String SUPPLIER_FIELD = "supplier";
+    private static final String BILL_ENTRY = "billentry";
+    private static final String SPECIAL_MEMBER_F7_FORM_ID = "bcm_mulmemberf7base_tem";
+    private static final String PAGE_CACHE_BUDGET_ROW = "budget_callback_row";
+    private static final String FIELD_BUDGET_ORG_NUMBER = "xxxx_orgnumber";
+    private static final String FIELD_BUDGET_YEAR = "xxxx_budgetyear";
+    private static final String FIELD_COST_CENTER = "xxxx_costcenter";
+    private static final String FIELD_WORKTASK = "xxxx_worktask";
+    private static final String FIELD_WORKTASK_NO = "xxxx_worktaskno";
+    private static final String FIELD_FEE_ACCOUNT = "xxxx_feeaccount";
+    private static final String FIELD_FEE_ACCOUNT_NO = "xxxx_feeaccountno";
+    private static final String FIELD_BUDGET_OFFICER = "xxxx_budgetofficer";
+    private static final String RES_APP_ID = "kd-cd-common-snippets";
+
+    public void openSupplierSelector(Object orgId, Object materialId) {
+        ListShowParameter showParameter = ShowParameterUtils.getF7List("bd_supplier", true);
+        showParameter.setCloseCallBack(new CloseCallBack(this, CALLBACK_SELECT_SUPPLIER));
+
+        ListFilterParameter listFilter = showParameter.getListFilterParameter();
+        listFilter.getQFilters().add(new QFilter("enable", QCP.equals, true));
+        listFilter.getQFilters().add(new QFilter("createorg.id", QCP.equals, orgId));
+        listFilter.getQFilters().add(new QFilter("suppliermaterial.material.masterid.id", QCP.equals, materialId));
+        getView().showForm(showParameter);
+    }
+
+    public void openBudgetSelectorForCurrentRow() {
+        int rowIndex = getModel().getEntryCurrentRowIndex(BILL_ENTRY);
+        if (!isValidEntryRow(rowIndex)) {
+            getView().showTipNotification(ResManager.loadKDString("请先定位到需要回填的分录行", "OpenBillModalSample_0", RES_APP_ID));
+            return;
+        }
+
+        String orgNumber = toText(getModel().getValue(FIELD_BUDGET_ORG_NUMBER, rowIndex));
+        String budgetYear = toText(getModel().getValue(FIELD_BUDGET_YEAR, rowIndex));
+        String costCenter = toText(getModel().getValue(FIELD_COST_CENTER, rowIndex));
+        if (CharSequenceUtils.isBlank(orgNumber)
+                || CharSequenceUtils.isBlank(budgetYear)
+                || CharSequenceUtils.isBlank(costCenter)) {
+            getView().showTipNotification(ResManager.loadKDString("请先补全预算组织、预算年度和成本中心", "OpenBillModalSample_1", RES_APP_ID));
+            return;
+        }
+
+        getPageCache().put(PAGE_CACHE_BUDGET_ROW, String.valueOf(rowIndex));
+        openBudgetSelector(orgNumber, budgetYear, costCenter);
+    }
+
+    public void openBudgetSelector(String orgNumber, String budgetYear, String costCenter) {
+        FormShowParameter fsp = ShowParameterUtils.getForm(
+                "xxxx_budgetlist",
+                OperationStatus.ADDNEW,
+                ShowType.Modal,
+                "900px",
+                "600px"
+        );
+        fsp.setCustomParam("OrgNumber", orgNumber);
+        fsp.setCustomParam("BudgetYear", budgetYear);
+        fsp.setCustomParam("CostCenter", costCenter);
+        fsp.setCloseCallBack(new CloseCallBack(this, CALLBACK_SELECT_BUDGET));
+        getView().showForm(fsp);
+    }
+
+    public void openMemberSelector(Object modelId, String fieldKey, String memberModel, Object dimensionId) {
+        ListShowParameter showParameter = ShowParameterUtils.getF7List(SPECIAL_MEMBER_F7_FORM_ID, true);
+        showParameter.setCustomParam("KEY_MODEL_ID", String.valueOf(modelId));
+        showParameter.setCustomParam("dimensionid", String.valueOf(dimensionId));
+        showParameter.setCustomParam("mutilentity", "[]");
+        showParameter.setCustomParam("sign", fieldKey);
+        showParameter.setCloseCallBack(new CloseCallBack(this, buildMemberCallbackId(fieldKey, memberModel)));
+        getView().showForm(showParameter);
+    }
+
+    @Override
+    public void closedCallBack(ClosedCallBackEvent e) {
+        super.closedCallBack(e);
+        // 回调数据类型和对应选择页的回传类型保持一致即可。
+        String actionId = e.getActionId();
+        Object returnData = e.getReturnData();
+        if (returnData == null) {
+            return;
+        }
+        if (actionId != null && actionId.startsWith(CALLBACK_SELECT_DIM_MEMBER_PREFIX)) {
+            handleDimMemberSelected(actionId, (DynamicObjectCollection) returnData);
+        } else if (CALLBACK_SELECT_SUPPLIER.equals(actionId)) {
+            handleSupplierSelected((ListSelectedRowCollection) returnData);
+        } else if (CALLBACK_SELECT_BUDGET.equals(actionId)) {
+            @SuppressWarnings("unchecked")
+            java.util.Map<String, String> selectedBudget = (java.util.Map<String, String>) returnData;
+            handleBudgetSelected(selectedBudget);
+        }
+    }
+
+    private void handleSupplierSelected(ListSelectedRowCollection selectedRows) {
+        if (CollectionUtils.isEmpty(selectedRows)) {
+            return;
+        }
+
+        Set<Object> existingSupplierIds = new LinkedHashSet<>();
+        for (DynamicObject row : getModel().getEntryEntity(SUPPLIER_ENTRY)) {
+            DynamicObject supplier = row.getDynamicObject(SUPPLIER_FIELD);
+            Object supplierId = DynamicObjectUtils.nullSafeGet(supplier, "id");
+            if (EntityUtils.isNotEmptyPk(supplierId)) {
+                existingSupplierIds.add(supplierId);
+            }
+        }
+
+        int addedCount = 0;
+        for (ListSelectedRow selectedRow : selectedRows) {
+            Object supplierId = selectedRow.getPrimaryKeyValue();
+            if (EntityUtils.isEmptyPk(supplierId) || !existingSupplierIds.add(supplierId)) {
+                continue;
+            }
+            int rowIndex = getModel().createNewEntryRow(SUPPLIER_ENTRY);
+            getModel().setItemValueByID(SUPPLIER_FIELD, supplierId, rowIndex);
+            addedCount++;
+        }
+        if (addedCount == 0) {
+            getView().showTipNotification(ResManager.loadKDString("所选供应商已全部存在，无需重复回填", "OpenBillModalSample_2", RES_APP_ID));
+            return;
+        }
+        getView().updateView(SUPPLIER_ENTRY);
+        getView().showSuccessNotification(String.format(
+                ResManager.loadKDString("已新增%s行供应商", "OpenBillModalSample_3", RES_APP_ID),
+                addedCount
+        ));
+    }
+
+    private void handleBudgetSelected(java.util.Map<String, String> selectedBudget) {
+        int rowIndex = resolveBudgetRowIndex();
+        if (!isValidEntryRow(rowIndex)) {
+            getView().showTipNotification(ResManager.loadKDString("目标分录行已不存在，请重新选择预算", "OpenBillModalSample_4", RES_APP_ID));
+            return;
+        }
+
+        getModel().setEntryCurrentRowIndex(BILL_ENTRY, rowIndex);
+        getModel().setValue(FIELD_WORKTASK, selectedBudget.get("workTask"), rowIndex);
+        getModel().setValue(FIELD_WORKTASK_NO, selectedBudget.get("workTaskNo"), rowIndex);
+        getModel().setValue(FIELD_FEE_ACCOUNT, selectedBudget.get("feeAccount"), rowIndex);
+        getModel().setValue(FIELD_FEE_ACCOUNT_NO, selectedBudget.get("feeAccountNo"), rowIndex);
+        getModel().setValue(FIELD_BUDGET_OFFICER, selectedBudget.get("budgetOfficer"), rowIndex);
+        getView().updateView(BILL_ENTRY);
+        getView().showSuccessNotification(String.format(
+                ResManager.loadKDString("已回填第%s行预算信息", "OpenBillModalSample_5", RES_APP_ID),
+                rowIndex + 1
+        ));
+    }
+
+    private String buildMemberCallbackId(String fieldKey, String memberModel) {
+        return CALLBACK_SELECT_DIM_MEMBER_PREFIX + fieldKey + "|" + memberModel;
+    }
+
+    private void handleDimMemberSelected(String actionId, DynamicObjectCollection selectedRows) {
+        String[] parts = actionId.substring(CALLBACK_SELECT_DIM_MEMBER_PREFIX.length()).split("\\|", 2);
+        if (parts.length != 2) {
+            return;
+        }
+
+        String fieldKey = parts[0];
+        String memberModel = parts[1];
+        MulBasedataDynamicObjectCollection coll = (MulBasedataDynamicObjectCollection) getModel().getValue(fieldKey);
+
+        Set<Object> existingMemberIds = new LinkedHashSet<>();
+        for (DynamicObject row : coll) {
+            DynamicObject member = row.getDynamicObject("fbasedataid");
+            Object memberId = DynamicObjectUtils.nullSafeGet(member, "id");
+            if (EntityUtils.isNotEmptyPk(memberId)) {
+                existingMemberIds.add(memberId);
+            }
+        }
+
+        int addedCount = 0;
+        for (DynamicObject selectedRow : selectedRows) {
+            Object memberId = selectedRow.get("mid1");
+            if (EntityUtils.isEmptyPk(memberId) || !existingMemberIds.add(memberId)) {
+                continue;
+            }
+            DynamicObject row = coll.addNew();
+            DynamicObject member = DynamicObjectUtils.newDynamicObject(memberModel);
+            member.set("id", memberId);
+            row.set("fbasedataid", member);
+            addedCount++;
+        }
+        if (addedCount == 0) {
+            getView().showTipNotification(ResManager.loadKDString("所选成员已全部存在，无需重复回填", "OpenBillModalSample_6", RES_APP_ID));
+            return;
+        }
+        getModel().setValue(fieldKey, coll);
+        getView().updateView(fieldKey);
+    }
+
+    private int resolveBudgetRowIndex() {
+        IPageCache pageCache = getPageCache();
+        String rowText = pageCache.get(PAGE_CACHE_BUDGET_ROW);
+        pageCache.remove(PAGE_CACHE_BUDGET_ROW);
+        if (rowText == null) {
+            return getModel().getEntryCurrentRowIndex(BILL_ENTRY);
+        }
+        return Integer.parseInt(rowText);
+    }
+
+    private boolean isValidEntryRow(int rowIndex) {
+        return rowIndex >= 0 && rowIndex < getModel().getEntryEntity(BILL_ENTRY).size();
+    }
+
+    private String toText(Object value) {
+        return value == null ? "" : String.valueOf(value).trim();
+    }
+}

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

@@ -0,0 +1,295 @@
+/**
+ * 子页面选中数据后 returnDataToParent(...) 示例。
+ * <p>
+ * 适用插件：表单插件、单据插件
+ * 优先封装：AbstractFormPluginExt
+ * 原生兜底：returnDataToParent(...)、sendFormAction(...)、IFormView
+ * 相关 lint 规则：当前无专门规则，可参考 SCENE-005、STYLE-013、RESOURCE-002
+ * <p>
+ * 使用场景：
+ * 1. 单行 Map 回传，父页面按目标行覆盖；
+ * 2. List<Map> 回传，父页面批量追加并去重；
+ * 3. 子页面直接修改父页面模型后 sendFormAction。
+ */
+package kd.cd.common.snippets.form;
+
+import kd.bos.bill.OperationStatus;
+import kd.bos.dataentity.entity.DynamicObject;
+import kd.bos.dataentity.resource.ResManager;
+import kd.bos.entity.datamodel.IDataModel;
+import kd.bos.form.CloseCallBack;
+import kd.bos.form.FormShowParameter;
+import kd.bos.form.IFormView;
+import kd.bos.form.ShowType;
+import kd.bos.form.control.Control;
+import kd.bos.form.control.events.RowClickEvent;
+import kd.bos.form.control.events.RowClickEventListener;
+import kd.bos.form.events.ClosedCallBackEvent;
+import kd.cd.common.entity.EntityUtils;
+import kd.cd.common.form.ShowParameterUtils;
+import kd.cd.common.plugin.AbstractFormPluginExt;
+import kd.cd.core.util.CharSequenceUtils;
+import kd.cd.core.util.CollectionUtils;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.EventObject;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+public class ReturnParentDataSample extends AbstractFormPluginExt implements RowClickEventListener {
+    private static final String ENTRY_KEY = "entryentity";
+    private static final String BTN_OK = "btnok";
+    private static final String FIELD_NUMBER = "number";
+    private static final String FIELD_NAME = "name";
+    private static final String FIELD_OWNER = "owner";
+    private static final String PARENT_REMARK = "remark";
+    private static final String CALLBACK_CHILD_SELECT = "select_from_child";
+    private static final String CHILD_FORM_ID = "xxxx_child_selector";
+    private static final String CUSTOM_PARAM_TARGET_ROW_INDEX = "targetRowIndex";
+    private static final String RES_APP_ID = "kd-cd-common-snippets";
+
+    @Override
+    public void registerListener(EventObject e) {
+        super.registerListener(e);
+        addClickListeners(BTN_OK);
+        addEntryRowClickListeners(ENTRY_KEY);
+    }
+
+    @Override
+    public void click(EventObject evt) {
+        super.click(evt);
+        Control control = (Control) evt.getSource();
+        if (BTN_OK.equalsIgnoreCase(control.getKey())) {
+            returnSelectedData();
+        }
+    }
+
+    @Override
+    public void entryRowDoubleClick(RowClickEvent evt) {
+        DynamicObject row = resolveRowByIndex(evt.getRow());
+        if (row != null) {
+            returnSingleRow(row);
+        }
+    }
+
+    private void returnSelectedData() {
+        List<DynamicObject> selectedRows = getEntrySelectRowsEntity(ENTRY_KEY);
+        if (CollectionUtils.isNotEmpty(selectedRows)) {
+            if (selectedRows.size() == 1) {
+                returnSingleRow(selectedRows.get(0));
+            } else {
+                returnMultiRows(selectedRows);
+            }
+            return;
+        }
+
+        DynamicObject currentRow = resolveRowByIndex(getModel().getEntryCurrentRowIndex(ENTRY_KEY));
+        if (currentRow == null) {
+            getView().showTipNotification(ResManager.loadKDString("请先选择一行数据", "ReturnParentDataSample_0", RES_APP_ID));
+            return;
+        }
+        returnSingleRow(currentRow);
+    }
+
+    private void returnSingleRow(DynamicObject row) {
+        Map<String, String> result = buildRowResult(row);
+        if (CollectionUtils.isEmpty(result)) {
+            return;
+        }
+        getView().returnDataToParent(result);
+        getView().close();
+    }
+
+    private void returnMultiRows(List<DynamicObject> selectedRows) {
+        List<Map<String, String>> resultList = new ArrayList<>(selectedRows.size());
+        for (DynamicObject row : selectedRows) {
+            Map<String, String> result = buildRowResult(row);
+            if (!result.isEmpty()) {
+                resultList.add(result);
+            }
+        }
+        if (CollectionUtils.isEmpty(resultList)) {
+            getView().showTipNotification(ResManager.loadKDString("所选数据无可回传内容", "ReturnParentDataSample_1", RES_APP_ID));
+            return;
+        }
+        getView().returnDataToParent(resultList);
+        getView().close();
+    }
+
+    private Map<String, String> buildRowResult(DynamicObject row) {
+        Object ownerId = row.get(FIELD_OWNER + "_id");
+        if (EntityUtils.isEmptyPk(ownerId)) {
+            getView().showErrorNotification(ResManager.loadKDString("所选行未设置负责人，不能回传", "ReturnParentDataSample_2", RES_APP_ID));
+            return Collections.emptyMap();
+        }
+
+        String number = row.getString(FIELD_NUMBER);
+        if (CharSequenceUtils.isBlank(number)) {
+            getView().showErrorNotification(ResManager.loadKDString("所选行编码为空，不能回传", "ReturnParentDataSample_3", RES_APP_ID));
+            return Collections.emptyMap();
+        }
+
+        Map<String, String> result = new HashMap<>(4);
+        result.put(FIELD_NUMBER, number);
+        result.put(FIELD_NAME, row.getString(FIELD_NAME));
+        result.put("ownerId", String.valueOf(ownerId));
+
+        int targetRowIndex = resolveRowIndex(getView().getFormShowParameter().getCustomParam(CUSTOM_PARAM_TARGET_ROW_INDEX));
+        if (targetRowIndex >= 0) {
+            result.put(CUSTOM_PARAM_TARGET_ROW_INDEX, String.valueOf(targetRowIndex));
+        }
+        return result;
+    }
+
+    public void writeBackToParentDirectly() {
+        DynamicObject currentRow = resolveRowByIndex(getModel().getEntryCurrentRowIndex(ENTRY_KEY));
+        IFormView parentView = getView().getParentView();
+        if (currentRow == null || parentView == null) {
+            return;
+        }
+
+        IDataModel parentModel = parentView.getModel();
+        int targetRowIndex = resolveRowIndex(
+                getView().getFormShowParameter().getCustomParam(CUSTOM_PARAM_TARGET_ROW_INDEX)
+        );
+        if (isValidParentRow(parentModel, targetRowIndex)) {
+            parentModel.setValue(FIELD_NUMBER, currentRow.get(FIELD_NUMBER), targetRowIndex);
+            parentModel.setValue(FIELD_NAME, currentRow.get(FIELD_NAME), targetRowIndex);
+            parentModel.setValue(FIELD_OWNER, currentRow.get(FIELD_OWNER), targetRowIndex);
+            parentView.updateView(ENTRY_KEY);
+        } else {
+            parentModel.setValue(PARENT_REMARK, currentRow.get(FIELD_NAME));
+            parentView.updateView(PARENT_REMARK);
+        }
+        getView().sendFormAction(parentView);
+        getView().close();
+    }
+
+    private DynamicObject resolveRowByIndex(int rowIndex) {
+        List<DynamicObject> rows = getModel().getEntryEntity(ENTRY_KEY);
+        if (rowIndex < 0 || rowIndex >= rows.size()) {
+            return null;
+        }
+        return rows.get(rowIndex);
+    }
+
+    private boolean isValidParentRow(IDataModel parentModel, int rowIndex) {
+        int rowCount = parentModel.getDataEntity(true).getDynamicObjectCollection(ENTRY_KEY).size();
+        return rowIndex >= 0 && rowIndex < rowCount;
+    }
+
+    /**
+     * 父页面侧：打开子页面，并在 closedCallBack 中消费回传数据。
+     */
+    public static class ParentReceiveSide extends AbstractFormPluginExt {
+        public void openChildSelector() {
+            FormShowParameter fsp = ShowParameterUtils.getForm(
+                    CHILD_FORM_ID,
+                    OperationStatus.ADDNEW,
+                    ShowType.Modal,
+                    "800px",
+                    "600px"
+            );
+            int rowIndex = getModel().getEntryCurrentRowIndex(ENTRY_KEY);
+            if (rowIndex >= 0) {
+                fsp.setCustomParam(CUSTOM_PARAM_TARGET_ROW_INDEX, rowIndex);
+            }
+            fsp.setCloseCallBack(new CloseCallBack(this, CALLBACK_CHILD_SELECT));
+            getView().showForm(fsp);
+        }
+
+        @Override
+        public void closedCallBack(ClosedCallBackEvent e) {
+            super.closedCallBack(e);
+            // 回调数据类型和子页面 returnDataToParent(...) 的回传类型保持一致即可。
+            if (!CALLBACK_CHILD_SELECT.equals(e.getActionId())) {
+                return;
+            }
+            Object returnData = e.getReturnData();
+            if (returnData == null) {
+                return;
+            }
+            if (returnData instanceof List<?>) {
+                @SuppressWarnings("unchecked")
+                List<Map<?, ?>> returnDataList = (List<Map<?, ?>>) returnData;
+                applyReturnedList(returnDataList);
+                return;
+            }
+            applyReturnedMap((Map<?, ?>) returnData);
+        }
+
+        private void applyReturnedMap(Map<?, ?> returnData) {
+            int rowIndex = resolveRowIndex(returnData.get(CUSTOM_PARAM_TARGET_ROW_INDEX));
+            if (!isValidEntryRow(rowIndex)) {
+                rowIndex = getModel().getEntryCurrentRowIndex(ENTRY_KEY);
+            }
+            if (!isValidEntryRow(rowIndex)) {
+                rowIndex = getModel().createNewEntryRow(ENTRY_KEY);
+            }
+            fillParentRow(rowIndex, returnData);
+            getModel().setEntryCurrentRowIndex(ENTRY_KEY, rowIndex);
+            getView().updateView(ENTRY_KEY);
+            getView().showSuccessNotification(ResManager.loadKDString("已回填当前行数据", "ReturnParentDataSample_4", RES_APP_ID));
+        }
+
+        private void applyReturnedList(List<Map<?, ?>> returnDataList) {
+            Set<String> existingNumbers = collectExistingNumbers();
+            int addedCount = 0;
+            int lastRowIndex = -1;
+            for (Map<?, ?> rowData : returnDataList) {
+                String number = String.valueOf(rowData.get(FIELD_NUMBER));
+                if (CharSequenceUtils.isBlank(number) || !existingNumbers.add(number)) {
+                    continue;
+                }
+                lastRowIndex = getModel().createNewEntryRow(ENTRY_KEY);
+                fillParentRow(lastRowIndex, rowData);
+                addedCount++;
+            }
+            if (addedCount == 0) {
+                getView().showTipNotification(ResManager.loadKDString("回传数据已全部存在，无需重复追加", "ReturnParentDataSample_5", RES_APP_ID));
+                return;
+            }
+            if (lastRowIndex >= 0) {
+                getModel().setEntryCurrentRowIndex(ENTRY_KEY, lastRowIndex);
+            }
+            getView().updateView(ENTRY_KEY);
+            getView().showSuccessNotification(String.format(
+                    ResManager.loadKDString("已追加%s行数据", "ReturnParentDataSample_6", RES_APP_ID),
+                    addedCount
+            ));
+        }
+
+        private void fillParentRow(int rowIndex, Map<?, ?> returnData) {
+            getModel().setValue(FIELD_NUMBER, returnData.get(FIELD_NUMBER), rowIndex);
+            getModel().setValue(FIELD_NAME, returnData.get(FIELD_NAME), rowIndex);
+            getModel().setItemValueByID(FIELD_OWNER, returnData.get("ownerId"), rowIndex);
+        }
+
+        private Set<String> collectExistingNumbers() {
+            List<DynamicObject> rows = getModel().getEntryEntity(ENTRY_KEY);
+            Set<String> numbers = new HashSet<>(rows.size());
+            for (DynamicObject row : rows) {
+                String number = row.getString(FIELD_NUMBER);
+                if (CharSequenceUtils.isNotBlank(number)) {
+                    numbers.add(number);
+                }
+            }
+            return numbers;
+        }
+
+        private boolean isValidEntryRow(int rowIndex) {
+            return rowIndex >= 0 && rowIndex < getModel().getEntryEntity(ENTRY_KEY).size();
+        }
+    }
+
+    private static int resolveRowIndex(Object rowValue) {
+        if (rowValue == null) {
+            return -1;
+        }
+        return Integer.parseInt(String.valueOf(rowValue).trim());
+    }
+}

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

@@ -0,0 +1,140 @@
+/**
+ * 树形控件（TreeView）交互示例。
+ * <p>
+ * 适用插件：表单插件
+ * 优先封装：AbstractFormPluginExt、PageCache
+ * 原生兜底：TreeView、TreeNode、SerializationUtils
+ * 相关 lint 规则：当前无专门规则，可参考 SCENE-005、RESOURCE-002
+ * <p>
+ * 使用场景：
+ * 1. 动态构建实体树形结构；
+ * 2. 树节点点击/双击事件处理；
+ * 3. 树节点搜索定位；
+ * 4. 多选/单选节点回传。
+ */
+package kd.cd.common.snippets.form;
+
+import kd.bos.dataentity.resource.ResManager;
+import kd.bos.dataentity.serialization.SerializationUtils;
+import kd.bos.entity.tree.TreeNode;
+import kd.bos.form.control.Search;
+import kd.bos.form.control.TreeView;
+import kd.bos.form.control.events.ItemClickEvent;
+import kd.bos.form.control.events.SearchEnterEvent;
+import kd.bos.form.control.events.SearchEnterListener;
+import kd.bos.form.control.events.TreeNodeClickListener;
+import kd.bos.form.control.events.TreeNodeEvent;
+import kd.cd.common.plugin.AbstractFormPluginExt;
+import kd.cd.core.util.CharSequenceUtils;
+import kd.cd.core.util.CollectionUtils;
+
+import java.util.ArrayList;
+import java.util.EventObject;
+import java.util.List;
+
+public class TreeControlSample extends AbstractFormPluginExt implements TreeNodeClickListener, SearchEnterListener {
+    private static final String TREE_CONTROL_KEY = "kdcd_treeviewap";
+    private static final String ROOT_NODE_CACHE = "rootjson";
+    private static final String BTN_OK = "kdcd_ok";
+    private static final String MULTI_SELECT_PARAM = "mutiSelect";
+    private static final String RES_APP_ID = "kd-cd-common-snippets";
+
+    // --- 注册树控件和搜索框监听 ---
+    @Override
+    public void registerListener(EventObject e) {
+        super.registerListener(e);
+        TreeView tree = getTreeView();
+        tree.addTreeNodeClickListener(this);
+        Search search = getControl("kdcd_searchap");
+        search.addEnterListener(this);
+        addItemClickListeners("kdcd_toolbarap");
+    }
+
+    // --- 初始化树结构 ---
+    private void buildTree(String entityId, String entryKey, boolean multiSelect) {
+        TreeView tree = getTreeView();
+        String rootId = CharSequenceUtils.isBlank(entryKey) ? entityId : entryKey;
+        TreeNode root = recoverRootNode();
+        tree.addNode(root);
+        tree.setRootVisible(true);
+        tree.expand(rootId);
+        tree.setMulti(multiSelect);
+    }
+
+    // --- 构建根节点（从自定义参数或缓存恢复） ---
+    private TreeNode recoverRootNode() {
+        String rootJsonString = getPageCache().get(ROOT_NODE_CACHE);
+        return SerializationUtils.fromJsonString(rootJsonString, TreeNode.class);
+    }
+
+    // --- 树节点双击事件：选中并返回 ---
+    @Override
+    public void treeNodeDoubleClick(TreeNodeEvent evt) {
+        closeAndReturnData();
+    }
+
+    // --- 搜索框回车事件：定位匹配节点 ---
+    @Override
+    public void search(SearchEnterEvent evt) {
+        String searchText = evt.getText();
+        if (CharSequenceUtils.isBlank(searchText)) {
+            return;
+        }
+
+        TreeNode root = recoverRootNode();
+        List<String> ids = loadSearchIds(root, searchText);
+
+        if (CollectionUtils.isEmpty(ids)) {
+            getPageCache().put(searchText, null);
+            getView().showSuccessNotification(ResManager.loadKDString("已是最后一个", "TreeControlSample_0", RES_APP_ID));
+            return;
+        }
+
+        // 定位到第一个匹配节点
+        String currId = ids.get(0);
+        ids.remove(0);
+        getPageCache().put(searchText, SerializationUtils.toJsonString(ids));
+
+        TreeNode currNode = root.getTreeNode(currId);
+        getTreeView().focusNode(currNode);
+    }
+
+    // --- 确定按钮点击：返回选中数据 ---
+    @Override
+    public void itemClick(ItemClickEvent evt) {
+        super.itemClick(evt);
+        if (BTN_OK.equals(evt.getItemKey())) {
+            closeAndReturnData();
+        }
+    }
+
+    // --- 关闭页面并返回选中数据 ---
+    private void closeAndReturnData() {
+        TreeView tree = getTreeView();
+        Object returnData = Boolean.TRUE.equals(getCustomParam(MULTI_SELECT_PARAM))
+                ? tree.getTreeState().getSelectedNodes()
+                : tree.getTreeState().getFocusNode();
+        getView().returnDataToParent(returnData);
+        getView().close();
+    }
+
+    @SuppressWarnings("unchecked")
+    private List<String> loadSearchIds(TreeNode root, String searchText) {
+        String cachedIds = getPageCache().get(searchText);
+        if (cachedIds != null) {
+            return SerializationUtils.fromJsonString(cachedIds, List.class);
+        }
+        List<TreeNode> matchedNodes = root.getTreeNodeListByText(new ArrayList<>(0), searchText, 10000);
+        List<String> ids = new ArrayList<>(matchedNodes.size());
+        for (TreeNode matchedNode : matchedNodes) {
+            ids.add(matchedNode.getId());
+        }
+        getPageCache().put(searchText, SerializationUtils.toJsonString(ids));
+        return ids;
+    }
+
+    // --- 获取树控件实例 ---
+    private TreeView getTreeView() {
+        return getControl(TREE_CONTROL_KEY);
+    }
+}