kcode-pi 0.1.0

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

@@ -0,0 +1,116 @@
+/**
+ * 分录行遍历与表头汇总示例。
+ * <p>
+ * 适用插件：表单插件、单据插件
+ * 优先封装：DynamicObjectUtils、AbstractFormPluginExt
+ * 原生兜底：PropertyChangedArgs、AfterAddRowEventArgs、AfterDeleteRowEventArgs
+ * 相关 lint 规则：SCENE-008、STYLE-014、STYLE-015
+ * <p>
+ * 使用场景：
+ * 1. 数量/单价/税率变化后，回写当前行金额、税额；
+ * 2. 分录新增/删除后，刷新表头汇总字段；
+ * 3. 避免在 propertyChanged 里做重查询，只处理当前行和表头汇总。
+ * 参考写法：优先复用 getModel().getEntryEntity(...) + DynamicObjectUtils.sumOf(...)。
+ */
+package kd.cd.common.snippets.form;
+
+import kd.bos.dataentity.entity.DynamicObjectCollection;
+import kd.bos.entity.datamodel.events.AfterAddRowEventArgs;
+import kd.bos.entity.datamodel.events.AfterDeleteRowEventArgs;
+import kd.bos.entity.datamodel.events.PropertyChangedArgs;
+import kd.cd.common.plugin.AbstractFormPluginExt;
+import kd.cd.common.util.DynamicObjectUtils;
+import kd.cd.core.util.BigDecimalUtils;
+
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+
+public class EntryRowCalculateSample extends AbstractFormPluginExt {
+    private static final String ENTRY_KEY = "billentry";
+    private static final String FIELD_QTY = "qty";
+    private static final String FIELD_PRICE = "price";
+    private static final String FIELD_TAX_RATE = "taxrate";
+    private static final String FIELD_AMOUNT = "amount";
+    private static final String FIELD_TAX_AMOUNT = "taxamount";
+    private static final String FIELD_TOTAL_QTY = "totalqty";
+    private static final String FIELD_TOTAL_AMOUNT = "totalamount";
+    private static final String FIELD_TOTAL_TAX_AMOUNT = "totaltaxamount";
+
+    // --- 数量/单价/税率变化后，只重算当前行，再刷新表头汇总 ---
+    @Override
+    public void propertyChanged(PropertyChangedArgs e) {
+        super.propertyChanged(e);
+        String fieldKey = e.getProperty().getName();
+        if (!isCalcField(fieldKey)) {
+            return;
+        }
+        int rowIndex = getChangedRowIndex(e);
+        recalcEntryRow(rowIndex);
+        recalcEntrySummary();
+    }
+
+    // --- 新增分录后初始化默认值，并刷新表头汇总 ---
+    @Override
+    public void afterAddRow(AfterAddRowEventArgs e) {
+        super.afterAddRow(e);
+        if (ENTRY_KEY.equals(e.getEntryProp().getName())) {
+            int rowIndex = getModel().getEntryCurrentRowIndex(ENTRY_KEY);
+            getModel().beginInit();
+            getModel().setValue(FIELD_QTY, BigDecimal.ZERO, rowIndex);
+            getModel().setValue(FIELD_PRICE, BigDecimal.ZERO, rowIndex);
+            getModel().setValue(FIELD_TAX_RATE, BigDecimal.ZERO, rowIndex);
+            getModel().setValue(FIELD_AMOUNT, BigDecimal.ZERO, rowIndex);
+            getModel().setValue(FIELD_TAX_AMOUNT, BigDecimal.ZERO, rowIndex);
+            getModel().endInit();
+            recalcEntrySummary();
+        }
+    }
+
+    // --- 删除分录后触发重算 ---
+    @Override
+    public void afterDeleteRow(AfterDeleteRowEventArgs e) {
+        super.afterDeleteRow(e);
+        if (ENTRY_KEY.equals(e.getEntryProp().getName())) {
+            recalcEntrySummary();
+        }
+    }
+
+    private boolean isCalcField(String fieldKey) {
+        return FIELD_QTY.equals(fieldKey)
+                || FIELD_PRICE.equals(fieldKey)
+                || FIELD_TAX_RATE.equals(fieldKey);
+    }
+
+    // --- 当前行金额、税额联动 ---
+    private void recalcEntryRow(int rowIndex) {
+        BigDecimal qty = BigDecimalUtils.nullToZero((BigDecimal) getModel().getValue(FIELD_QTY, rowIndex));
+        BigDecimal price = BigDecimalUtils.nullToZero((BigDecimal) getModel().getValue(FIELD_PRICE, rowIndex));
+        BigDecimal taxRate = BigDecimalUtils.nullToZero((BigDecimal) getModel().getValue(FIELD_TAX_RATE, rowIndex));
+
+        BigDecimal amount = BigDecimalUtils.multiply(qty, price).setScale(2, RoundingMode.HALF_UP);
+        BigDecimal taxAmount = BigDecimalUtils.divide(
+                BigDecimalUtils.multiply(amount, taxRate),
+                BigDecimalUtils.valueOf(100),
+                2,
+                RoundingMode.HALF_UP
+        );
+
+        getModel().beginInit();
+        getModel().setValue(FIELD_AMOUNT, amount, rowIndex);
+        getModel().setValue(FIELD_TAX_AMOUNT, taxAmount, rowIndex);
+        getModel().endInit();
+    }
+
+    // --- 表头汇总 ---
+    private void recalcEntrySummary() {
+        DynamicObjectCollection entryRows = getModel().getEntryEntity(ENTRY_KEY);
+
+        BigDecimal totalQty = DynamicObjectUtils.sumOf(entryRows, FIELD_QTY);
+        BigDecimal totalAmount = DynamicObjectUtils.sumOf(entryRows, FIELD_AMOUNT);
+        BigDecimal totalTaxAmount = DynamicObjectUtils.sumOf(entryRows, FIELD_TAX_AMOUNT);
+
+        getModel().setValue(FIELD_TOTAL_QTY, totalQty);
+        getModel().setValue(FIELD_TOTAL_AMOUNT, totalAmount);
+        getModel().setValue(FIELD_TOTAL_TAX_AMOUNT, totalTaxAmount);
+    }
+}

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

@@ -0,0 +1,134 @@
+/**
+ * F7（基础资料选择控件）过滤条件示例。
+ * <p>
+ * 适用插件：表单插件、单据插件
+ * 优先封装：DynamicObjectUtils、EntityUtils
+ * 原生兜底：BeforeF7SelectEvent、ListShowParameter、QFilter
+ * 相关 lint 规则：SCENE-005、STYLE-013
+ * <p>
+ * 使用场景：
+ * 1. 打开 F7 前，按当前组织、行物料、启用/审核状态动态过滤可选数据；
+ * 2. 按当前体系切换特殊 F7 页面，并注入模型/维度 customParams；
+ * 3. 回显当前已选数据、控制是否展示未审核数据、是否开启多选；
+ * 4. 个别字段需要关闭系统默认 QFilter；
+ * 5. 区分表头字段 F7 与分录字段 F7 的过滤来源。
+ */
+package kd.cd.common.snippets.form;
+
+import kd.bos.dataentity.entity.DynamicObject;
+import kd.bos.dataentity.resource.ResManager;
+import kd.bos.form.FormShowParameter;
+import kd.bos.form.field.events.BeforeF7SelectEvent;
+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.plugin.AbstractFormPluginExt;
+import kd.cd.common.util.DynamicObjectUtils;
+
+import java.util.EventObject;
+import java.util.List;
+
+public class F7FilterSample extends AbstractFormPluginExt {
+    private static final String FIELD_ORG = "org";
+    private static final String FIELD_MATERIAL = "material";
+    private static final String FIELD_SUPPLIER = "supplier";
+    private static final String FIELD_MODEL = "kdcd_model";
+    private static final String FIELD_YEAR = "kdcd_year";
+    private static final String FIELD_PERIOD = "kdcd_period";
+    private static final String SPECIAL_MEMBER_F7_FORM_ID = "bcm_mulmemberf7base_tem";
+    private static final String FIELD_ENABLE = "enable";
+    private static final String FIELD_STATUS = "status";
+    private static final String FIELD_CREATE_ORG_ID = "createorg.id";
+    private static final String FIELD_MATERIAL_MASTER_ID = "masterid.id";
+    private static final String RES_APP_ID = "kd-cd-common-snippets";
+
+    // --- 在 registerListener 中注册 F7 监听 ---
+    @Override
+    public void registerListener(EventObject e) {
+        super.registerListener(e);
+        addBeforeF7SelectListeners(FIELD_MATERIAL, FIELD_SUPPLIER, FIELD_MODEL, FIELD_YEAR, FIELD_PERIOD);
+    }
+
+    // --- 打开 F7 前按业务条件加过滤 ---
+    @Override
+    public void beforeF7Select(BeforeF7SelectEvent e) {
+        super.beforeF7Select(e);
+        String fieldKey = e.getProperty().getName();
+        if (FIELD_MATERIAL.equals(fieldKey)) {
+            Object orgId = resolveOrgId();
+            if (EntityUtils.isEmptyPk(orgId)) {
+                e.setCancel(true);
+                getView().showTipNotification(ResManager.loadKDString("请先选择组织", "F7FilterSample_0", RES_APP_ID));
+                return;
+            }
+
+            List<QFilter> filters = e.getCustomQFilters();
+            appendEnabledApprovedFilters(filters);
+            filters.add(new QFilter(FIELD_CREATE_ORG_ID, QCP.equals, orgId));
+
+            ListShowParameter showParameter = (ListShowParameter) e.getFormShowParameter();
+            configureShowParameter(showParameter, false);
+            return;
+        }
+
+        if (FIELD_SUPPLIER.equals(fieldKey)) {
+            int rowIndex = e.getRow();
+            DynamicObject material = (DynamicObject) getModel().getValue(FIELD_MATERIAL, rowIndex);
+            Object materialMasterId = DynamicObjectUtils.nullSafeGet(material, FIELD_MATERIAL_MASTER_ID);
+            if (EntityUtils.isEmptyPk(materialMasterId)) {
+                e.setCancel(true);
+                getView().showTipNotification(ResManager.loadKDString("请先选择当前行物料", "F7FilterSample_1", RES_APP_ID));
+                return;
+            }
+
+            Object orgId = resolveOrgId();
+
+            ListShowParameter showParameter = (ListShowParameter) e.getFormShowParameter();
+            List<QFilter> filters = showParameter.getListFilterParameter().getQFilters();
+            filters.add(new QFilter(FIELD_ENABLE, QCP.equals, true));
+            filters.add(new QFilter("forbidstatus", QCP.not_equals, "B"));
+            filters.add(new QFilter("suppliermaterial.material.masterid.id", QCP.equals, materialMasterId));
+            if (!EntityUtils.isEmptyPk(orgId)) {
+                filters.add(new QFilter(FIELD_CREATE_ORG_ID, QCP.equals, orgId));
+            }
+            configureShowParameter(showParameter, true);
+
+            Object supplierId = DynamicObjectUtils.nullSafeGet((DynamicObject) getModel().getValue(FIELD_SUPPLIER, rowIndex), "id");
+            if (EntityUtils.isNotEmptyPk(supplierId)) {
+                showParameter.setSelectedRow(supplierId);
+                showParameter.setSelectedRows(new Object[]{supplierId});
+            }
+            return;
+        }
+
+        if (FIELD_MODEL.equals(fieldKey)) {
+            FormShowParameter formShowParameter = e.getFormShowParameter();
+            formShowParameter.setFormId(SPECIAL_MEMBER_F7_FORM_ID);
+            formShowParameter.setCustomParam("noNeedDefaultQFilter", true);
+            formShowParameter.setCustomParam("mutilentity", "[]");
+            formShowParameter.setCustomParam("sign", FIELD_MODEL);
+            return;
+        }
+
+        if (FIELD_YEAR.equals(fieldKey) || FIELD_PERIOD.equals(fieldKey)) {
+            ListShowParameter showParameter = (ListShowParameter) e.getFormShowParameter();
+            appendEnabledApprovedFilters(showParameter.getListFilterParameter().getQFilters());
+            configureShowParameter(showParameter, false);
+        }
+    }
+
+    private void appendEnabledApprovedFilters(List<QFilter> filters) {
+        filters.add(new QFilter(FIELD_ENABLE, QCP.equals, true));
+        filters.add(new QFilter(FIELD_STATUS, QCP.equals, "C"));
+    }
+
+    private Object resolveOrgId() {
+        return DynamicObjectUtils.nullSafeGet(getValue(FIELD_ORG), "id");
+    }
+
+    private void configureShowParameter(ListShowParameter showParameter, boolean multiSelect) {
+        showParameter.setShowApproved(false);
+        showParameter.setMultiSelect(multiSelect);
+    }
+}

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

@@ -0,0 +1,176 @@
+/**
+ * 表单模型取值/赋值示例。
+ * <p>
+ * 适用插件：表单插件、单据插件
+ * 优先封装：DynamicObjectUtils
+ * 原生兜底：IDataModel、BusinessDataServiceHelper
+ * 相关 lint 规则：SCENE-008、STYLE-006
+ * <p>
+ * 使用场景：
+ * 1. 表头 / 单据体 / 子单据体按行读取
+ * 2. 基础资料属性值、多选基础资料读取
+ * 3. 基础资料按对象、按 ID、按编码回写
+ * 4. 批量造行、子单据体造行、静默初始化
+ */
+package kd.cd.common.snippets.form;
+
+import kd.bos.context.RequestContext;
+import kd.bos.dataentity.entity.DynamicObject;
+import kd.bos.dataentity.entity.DynamicObjectCollection;
+import kd.bos.dataentity.entity.MulBasedataDynamicObjectCollection;
+import kd.bos.servicehelper.BusinessDataServiceHelper;
+import kd.cd.common.entity.EntityUtils;
+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 java.math.BigDecimal;
+
+public class GetAndSetValueSample extends AbstractFormPluginExt {
+    private static final String BOS_USER = "bos_user";
+    private static final String FIELD_REMARK = "kdtest_remark";
+    private static final String FIELD_REGISTRANT = "kdtest_registrant";
+    private static final String FIELD_REGISTRANT_BIRTHDAY = "birthday";
+    private static final String FIELD_APPROVERS = "kdtest_approvers";
+    private static final String ENTRY_KEY = "kdtest_reqentryentity";
+    private static final String FIELD_QTY = "kdtest_qtyfield";
+    private static final String FIELD_MATERIAL = "kdtest_materielfield";
+    private static final String SUBENTRY_KEY = "kdtest_subentryentity";
+    private static final String FIELD_SUB_DESC = "kdtest_subdesc";
+
+    // ==================== 场景1：表单读值 ====================
+
+    public void readHeaderEntryAndSubEntryValues() {
+        String remark = (String) getModel().getValue(FIELD_REMARK);
+
+        DynamicObject registrant = (DynamicObject) getModel().getValue(FIELD_REGISTRANT);
+        Object registrantId = DynamicObjectUtils.nullSafeGet(registrant, FIELD_REGISTRANT + ".id");
+        String registrantName = DynamicObjectUtils.nullSafeGet(registrant, FIELD_REGISTRANT + ".name");
+
+        int rowCount = getModel().getEntryRowCount(ENTRY_KEY);
+        for (int rowIndex = 0; rowIndex < rowCount; rowIndex++) {
+            BigDecimal qty = (BigDecimal) getModel().getValue(FIELD_QTY, rowIndex);
+            DynamicObject material = (DynamicObject) getModel().getValue(FIELD_MATERIAL, rowIndex);
+        }
+
+        DynamicObjectCollection entryRows = getModel().getEntryEntity(ENTRY_KEY);
+        for (DynamicObject row : entryRows) {
+            BigDecimal qty = row.getBigDecimal(FIELD_QTY);
+            DynamicObjectCollection subRows = row.getDynamicObjectCollection(SUBENTRY_KEY);
+            for (DynamicObject subRow : subRows) {
+                String subDesc = subRow.getString(FIELD_SUB_DESC);
+            }
+        }
+    }
+
+    public String loadRegistrantBirthday() {
+        DynamicObject registrant = (DynamicObject) getModel().getValue(FIELD_REGISTRANT);
+        if (EntityUtils.isEmptyPk(registrant)) {
+            return null;
+        }
+
+        DynamicObject user = BusinessDataServiceHelper.loadSingleFromCache(
+                registrant.getPkValue(),
+                BOS_USER,
+                FIELD_REGISTRANT_BIRTHDAY
+        );
+        return DynamicObjectUtils.nullSafeGet(user, FIELD_REGISTRANT_BIRTHDAY);
+    }
+
+    public int countSelectedApprovers() {
+        MulBasedataDynamicObjectCollection approvers =
+                (MulBasedataDynamicObjectCollection) getModel().getValue(FIELD_APPROVERS);
+        return CollectionUtils.isEmpty(approvers) ? 0 : approvers.size();
+    }
+
+    // ==================== 场景2：表头 / 基础资料赋值 ====================
+
+    public void fillDefaultHeaderAndBaseData() {
+        getModel().setValue(FIELD_REMARK, "备注字段默认值");
+
+        DynamicObject currentUser = BusinessDataServiceHelper.loadSingleFromCache(
+                RequestContext.get().getCurrUserId(),
+                BOS_USER,
+                "id,number,name"
+        );
+        if (currentUser != null) {
+            getModel().setValue(FIELD_REGISTRANT, currentUser);
+        }
+
+        getModel().setItemValueByID(FIELD_REGISTRANT, RequestContext.get().getCurrUserId());
+        getModel().setItemValueByNumber(FIELD_REGISTRANT, "ID-000002");
+    }
+
+    // ==================== 场景3：批量造行 ====================
+
+    public void rebuildEntryRowsByTemplate() {
+        getModel().deleteEntryData(ENTRY_KEY);
+
+        DynamicObjectCollection entryRows = getModel().getEntryEntity(ENTRY_KEY);
+        DynamicObject template = new DynamicObject(entryRows.getDynamicObjectType());
+        template.set(FIELD_QTY, BigDecimal.ZERO);
+        int[] rowIndexes = getModel().batchCreateNewEntryRow(ENTRY_KEY, template, 2);
+        for (int i = 0; i < rowIndexes.length; i++) {
+            int rowIndex = rowIndexes[i];
+            getModel().setValue(
+                    FIELD_QTY,
+                    BigDecimalUtils.multiply(BigDecimalUtils.valueOf(10), BigDecimalUtils.valueOf(i + 1L)),
+                    rowIndex
+            );
+            getModel().setItemValueByNumber(FIELD_MATERIAL, "M000" + (i + 1), rowIndex);
+        }
+    }
+
+    public void appendEntryRowByObject() {
+        DynamicObjectCollection entryRows = getModel().getEntryEntity(ENTRY_KEY);
+        DynamicObject row = entryRows.addNew();
+        row.set(FIELD_QTY, BigDecimalUtils.valueOf(1));
+        // 基础资料赋值方式1：从缓存加载基础资料对象后再 set
+        DynamicObject supplier = BusinessDataServiceHelper.loadSingleFromCache(10001L, "bd_supplier", "id");
+        if (supplier != null) {
+            row.set("kdtest_supplier", supplier);
+        }
+        // 基础资料赋值方式2：可直接 set "字段标识_id" 进行 ID 赋值
+        row.set("kdtest_supplier_id", 10001L);
+        int rowIndex = getModel().createNewEntryRow(ENTRY_KEY, row);
+        getModel().setItemValueByNumber(FIELD_MATERIAL, "M0001", rowIndex);
+    }
+
+    public void appendSubEntryRow(int parentRowIndex) {
+        getModel().setEntryCurrentRowIndex(ENTRY_KEY, parentRowIndex);
+        int rowIndex = getModel().createNewEntryRow(SUBENTRY_KEY);
+        getModel().setValue(FIELD_SUB_DESC, "子单据体默认值", rowIndex);
+    }
+
+    public void appendApprover(Object userId) {
+        MulBasedataDynamicObjectCollection approvers = (MulBasedataDynamicObjectCollection) getModel().getValue(FIELD_APPROVERS);
+        if (CollectionUtils.isEmpty(approvers) || EntityUtils.isEmptyPk(userId)) {
+            return;
+        }
+
+        DynamicObject row = approvers.addNew();
+        DynamicObject user = DynamicObjectUtils.newDynamicObject(BOS_USER);
+        user.set("id", userId);
+        row.set("fbasedataid", user);
+        getModel().setValue(FIELD_APPROVERS, approvers);
+    }
+
+    // ==================== 场景4：静默初始化 / 直接改数据包 ====================
+
+    public void silentSetRemark(String remark) {
+        getModel().beginInit();
+        getModel().setValue(FIELD_REMARK, remark);
+        getModel().endInit();
+    }
+
+    /**
+     * 直接改数据包不会触发 propertyChanged，适合导入回填、批量矫正、静默初始化。
+     */
+    public void appendEntryRowSilently() {
+        DynamicObjectCollection entryRows = getModel().getDataEntity(true).getDynamicObjectCollection(ENTRY_KEY);
+        DynamicObject newRow = entryRows.addNew();
+        newRow.set(FIELD_QTY, BigDecimalUtils.valueOf(30));
+        getView().updateView(ENTRY_KEY);
+    }
+}

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

@@ -0,0 +1,124 @@
+/**
+ * 超链接点击跳转示例（分录 + 列表）。
+ * <p>
+ * 适用插件：表单插件、报表插件
+ * 优先封装：ShowParameterUtils
+ * 原生兜底：EntryGrid.addHyperClickListener、ReportList.addHyperClickListener、HyperLinkClickListener
+ * 相关 lint 规则：STYLE-015
+ * <p>
+ * 使用场景：
+ * 1. 分录字段配置为超链接，点击跳转到关联单据；
+ * 2. 报表/列表字段配置为超链接，点击查看详情单据。
+ */
+package kd.cd.common.snippets.form;
+
+import kd.bos.bill.BillShowParameter;
+import kd.bos.bill.OperationStatus;
+import kd.bos.dataentity.entity.DynamicObject;
+import kd.bos.report.ReportList;
+import kd.bos.form.ShowType;
+import kd.bos.form.control.EntryGrid;
+import kd.bos.form.events.HyperLinkClickEvent;
+import kd.bos.form.events.HyperLinkClickListener;
+import kd.bos.orm.query.QCP;
+import kd.bos.orm.query.QFilter;
+import kd.bos.report.plugin.AbstractReportFormPlugin;
+import kd.bos.servicehelper.QueryServiceHelper;
+import kd.cd.common.form.ShowParameterUtils;
+import kd.cd.common.plugin.AbstractFormPluginExt;
+
+import java.util.EventObject;
+
+public class HyperlinkJumpSample {
+
+    /**
+     * 分录超链接点击：在 EntryGrid 上注册超链接事件。
+     * 控件/字段 key 请替换为你的实际配置。
+     */
+    public static class EntryHyperlinkFormPlugin extends AbstractFormPluginExt implements HyperLinkClickListener {
+        private static final String ENTRY_KEY = "entryentity";
+        private static final String ENTRY_LINK_FIELD = "billno";
+        private static final String ENTRY_BASEDATA_FIELD_ID = "supplier_id";
+        private static final String TARGET_FORM_ID = "your_bill_form_id";
+
+        @Override
+        public void registerListener(EventObject e) {
+            super.registerListener(e);
+            this.addHyperClickListeners(ENTRY_KEY);
+        }
+
+        @Override
+        public void hyperLinkClick(HyperLinkClickEvent event) {
+            if (!ENTRY_LINK_FIELD.equals(event.getFieldName())) {
+                return;
+            }
+            DynamicObject row = this.getModel().getEntryRowEntity(ENTRY_KEY, event.getRowIndex());
+            if (row == null) {
+                return;
+            }
+            String billNo = row.getString(ENTRY_LINK_FIELD);
+            DynamicObject target = QueryServiceHelper.queryOne(
+                    TARGET_FORM_ID,
+                    "id",
+                    new QFilter[]{new QFilter("billno", QCP.equals, billNo)}
+            );
+            if (target == null) {
+                return;
+            }
+            BillShowParameter showParameter = ShowParameterUtils.getBill(
+                    TARGET_FORM_ID,
+                    target.getLong("id"),
+                    OperationStatus.VIEW,
+                    ShowType.Modal
+            );
+            this.getView().showForm(showParameter);
+        }
+    }
+
+    /**
+     * 报表/列表超链接点击：在 ReportList 上注册超链接事件。
+     * 控件/字段 key 请替换为你的实际配置。
+     */
+    public static class ReportHyperlinkFormPlugin extends AbstractReportFormPlugin implements HyperLinkClickListener {
+        private static final String REPORT_LIST_KEY = "reportlistap";
+        private static final String REPORT_LINK_FIELD = "billno";
+        private static final String TARGET_FORM_ID = "your_bill_form_id";
+
+        @Override
+        public void registerListener(EventObject e) {
+            super.registerListener(e);
+            ReportList reportList = this.getView().getControl(REPORT_LIST_KEY);
+            if (reportList != null) {
+                reportList.addHyperClickListener(this);
+            }
+        }
+
+        @Override
+        public void hyperLinkClick(HyperLinkClickEvent event) {
+            if (!REPORT_LINK_FIELD.equals(event.getFieldName())) {
+                return;
+            }
+            int rowIndex = event.getRowIndex();
+            ReportList reportList = this.getView().getControl(REPORT_LIST_KEY);
+            Object billNo = reportList.getReportModel().getRowData(rowIndex).get(REPORT_LINK_FIELD);
+            if (billNo == null) {
+                return;
+            }
+            DynamicObject target = QueryServiceHelper.queryOne(
+                    TARGET_FORM_ID,
+                    "id",
+                    new QFilter[]{new QFilter("billno", QCP.equals, billNo)}
+            );
+            if (target == null) {
+                return;
+            }
+            BillShowParameter showParameter = ShowParameterUtils.getBill(
+                    TARGET_FORM_ID,
+                    target.getLong("id"),
+                    OperationStatus.VIEW,
+                    ShowType.MainNewTabPage
+            );
+            this.getView().showForm(showParameter);
+        }
+    }
+}