前言：写本篇原因。从已知目前，所有文档中没有找到一个可以说明怎么做的。都是含糊其词，或者版本太老没有参考意义。本篇适合基础薄弱人。

以单据自定义项1为例。给自定义项1添加自定义参照

1.创建前端js ，上级目录也是新建
前端参照弹窗是由异步请后端，读取数据并返回给前端渲染。以表型自定义参照为例，解析前后端绑定关系。

image.png

2.向bd_refinfo表中插入自定义参照，插入后需重启后端环境，前端模板才可以参照
插入数据说明(关键字段)：
refclass：代表后端Java类路径，若只加轻量端参照此处可以为空；
refpath：代表NCC参照前端js路径;
mobilerefpath：代表移动端参照的前端js路径;
istreelazyload：树形参照和树表形参照默认”Y”，表型参照默认“N”;

image.png

客户化配置-->模板设置-集团-->找到模板-->对应字段

image.png

找到自己插入的自定义参照

image.png

注意:前端打开节点时NC获取参照是读取数据库中插入的js路径进行加载js文件。如果bd_refinfo维护错误，会导致控件消失

3.编写后端java参照
java文件为新建文件，继承类型为DefaultGridRefAction（表型参照）
方法说明:
getRefMeta()方法中设置RefMeta对象各属性对应的String值，即sql语句中我们需要查询的字段，以 及设置要查询的表名。
getExtraSql()方法会拼接Sql语句中where 后的条件语句（对应NC中getClassWherePart、getEnvWherePart方法）。
getOrderSql()方法设置sql语句中的order by内容

image.png

4.写第一步创建的js逻辑
前端参照弹窗是由异步请后端，读取数据并返回给前端渲染。以自定义表型参照为例，解析前后端绑定关系。

image.png

5.修改config.action下的xml与config.authorize下的xml
通过以上queryTreeUrl、queryGridUrl访问路径，在向导生成的配置文件中找到对应的配置信息，并触发对应的工具类。配置文件如下所示：

image.png

image.png

6.重启后端、重启前端、尽量浏览器关闭重新打开。

7.前后端 配置对照 更新时间（截图非前六步对应，只是说明几个配置之间的关系）

image.png