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

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

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

面板

目录

创建宏代码库入口：在 公共设置 > 宏代码库 右键菜单中选择 新建宏代码库。

入口1：在“系统导航栏”选择 公共设置，在“资源目录区”的“宏代码库”节点或已创建的宏代码库文件夹的右键菜单中选择

操作入口

入口1：在“系统导航栏”选择 公共设置，展开资源目录区，在“宏代码库”或其节点下文件夹的更多操作Image Added选择 新建 > 宏代码库，进入“新建宏代码库”界面。

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

Image RemovedImage Removed

第一步：创建宏代码库

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

Image Added

操作步骤

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

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

1、在"宏管理"界面的资源目录区中，对刚刚新建的宏代码库，在其右键菜单中选择"编辑宏"，进入宏编辑界面。

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

2、对模块区的"服务端模块"节点，在其右键菜单中选择"新建模块"，弹出模块信息界面，并在"对象"中选择"（通用）"，"事件"中选择"（声明）"。

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

Image RemovedImage Added

1、在“资源目录区”展开“宏代码库”节点，找到已有的宏代码库，在其更多操作Image Added中选择打开，或双击现有宏代码库，打开宏编辑界面。

2、对模块区的“服务端模块”节点，在其更多操作Image Added中选择 新建模块，弹出“新建模块”窗口，输入名称，并在“对象”中选择“（通用）”，“事件”中选择“（声明）”。

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

Image RemovedImage Added

4. 对模块区的"客户端模块"节点，在其右键菜单中选择"新建模块"，弹出模块信息界面，并在"对模块区的“客户端模块”节点，在其更多操作Image Added选择 新建模块 ，弹出“新建模块”窗口，输入名称，并在"对象"中选择"（通用）"，"事件"中选择"（声明）"。

Image RemovedImage Added

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

Image RemovedImage Added

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

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

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

应用方法如下所示：
Image Modified