页面树结构

版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。

宏代码库(您可以认为等同于工具类的作用)主要用来定义一些公共的宏方法。将一些使用频率较高的方法定义为公共的方法,便于代码重用,消除重复。

  • 宏代码库中声明的公共方法不通过事件触发,因此需要通过报表宏或跳转规则引用宏代码库来调用这些公共方法。
  • 系统默认内置的工具宏为:system > utils,分别针对服务端模块和客户端模块定义了一些常用的公共方法。
  • 使用时用use(完整的路径),譬如var jmUtils = use("system.utils.JMClientUtils"),这样JMClientUtils中的所有方法都可以jmUtils.方法名引用。


系统中的宏代码库主要包括两项内容:

  • 目录:用来存储不同的宏代码文件。如内置的system就是一个目录。
  • 宏代码库:等同于一个代码文件,文件中定义了许多公共的方法。如内置的utils就是一个宏代码库。
面板
borderColor#BBBBBB
bgColor#F0F0F0
borderWidth1
borderStylesolid

目录

入口1:在“系统导航栏”选择 公共设置,展开目录资源区,在“宏代码库”节点或已创建的宏代码库文件夹的右键菜单中选择 ,展开目录资源区,在“宏代码库”或其节点下文件夹的更多操作选择 新建 > 宏代码库,进入“新建宏代码库”界面。

入口2:在“公共设置”界面主菜单 入口2:在“公共设置”界面主菜单选择 常用设置 > 宏代码库。

第一步:创建宏代码库

在"宏管理"界面的主界面区,直接点击"新建工具宏代码库"快捷方式,就会弹出"新建宏代码库"设置界面,输入"名称"为"utils"。

按照上方“创建宏代码库入口”操作,进入“新建宏代码库”设置界面,输入"名称"为"utils"。

第二步:给宏代码库定义公共方法

1、在“资源目录区”展开“宏代码库”节点,找到已有的宏代码库,在其右键菜单中选择 打开,或双击现有宏代码库,打开宏编辑界面。

2、对模块区的“客户端模块”节点,在其右键菜单中选择 新建模块,弹出”新建模块“界面,输入名称,并在“对象”中选择“(通用)”,“事件”中选择“(声明)”。

3. 在编辑区中,编写对应的宏代码。

4. 对模块区的"客户端模块"节点,在其右键菜单中选择"新建模块",弹出模块信息界面,并在"对象"中选择"(通用)","事件"中选择"(声明)"。

5. 在编辑区中,编写对应的宏代码。

第三步:调用工具宏定义的公共方法

工具宏定义的公共方法按照如下方式被调用:
例如:系统中有utils工具宏,该路径为"工具宏>system>utils"。在该工具宏中定义了JMClientUtils宏模块,模块中实现了headerMemberAliasEquals(cell, memberName, value)方法。

  • 在宏代码中通过"var jmUtils = use("system.utils.JMClientUtils")"声明调用文件的路径。
  • 在具体的宏代码中通过"变量名.方法"的方式,如"jmUtils.dataCellMemberAliasEquals(cell,"[Measures]","Profit")",来调用相应的方法。

应用方法如下所示: