变更记录

1 简介

1.1功能介绍

选择一个基础资料作为基础数据宏的数据来源，基础数据宏的数据查询范围受字段权限、数据规则、特殊数据权限、基础数据管控策略共同控制。

报表设计人员可以在数据集和报表中引用基础数据宏，控制报表的数据权限，使得报表查看者在报表中只能看到其有权限查看的基础资料数据。

1.2应用场景

• 在数据集设计器的查询语句中引用，实现条件取数。

• 在数据集设计器的参数控件设置中引用，设置参数控件的备选值和默认值，实现类似基础资料F7的功能。

• 在报表单元格表达式中引用

1.3系统路径

【数据服务云】→【轻报表】→【宏定义】

2 定义基础数据宏

2.1进入“宏定义“页面

分配了“宏定义”功能权限的用户，点击轻报表应用菜单中的“宏定义“，即可进入“宏定义“页面，新建和编辑基础数据宏。”宏定义“功能授权方式请参考文档https://q.kdcloud.com/support/index.html?version=1.0&docId=Tlyrdynmp 的2.2小节。

2.2新建基础数据宏

步骤1：在“宏定义“页面左上角点击【新建→基础数据宏】，打开“新建基础数据宏”弹窗。

步骤2：在“新建基础数据宏”弹窗中填写“编码”、“名称”、“描述”，并选择“基础资料”和“返回字段”。

• 编码：编码必须由小写字母、数字或下划线组成，且创建后无法更改。为了避免在报表中引用基础数据宏时，宏编码与报表单元格名称冲突，请不要使用只有“字母+数字”的组合来作为宏编码，如：a12、xb3等。

• 名称：基础数据宏的名称。

• 基础资料：点击后打开“选择基础资料”弹窗，选择当前系统中的一个基础资料，如下图所示。

• 返回字段：点击后打开“选择字段”弹窗，选择当前基础资料中要返回的字段。其中PK字段是基础数据宏的取值字段，默认勾选且不允许取消勾选，如下图所示。

• 预览：点击【预览】按钮，弹出“预览”弹窗，可查看当前“基础数据宏”返回的数据，如下图所示。

2.3编辑基础数据宏

当需要对已经创建完成的基础数据宏进行修改时（如：基础数据宏需要返回更多的字段信息或基础数据宏发生了异常无法使用），可以在“宏定义”页面，选择基础数据宏，再在顶部工具栏点击“编辑”，打开“编辑基础数据宏”弹窗，对基础数据宏进行编辑。

“编辑基础数据宏”弹窗中各设置项的设置方法与“新建基础数据宏”弹窗中一致，这里不再赘述。

Tips：当基础数据宏发生异常时，“宏定义”页面相应的基础数据宏编码前会有提示，鼠标移入，会显示异常原因。打开该基础数据宏的编辑弹窗，也会有相应的错误提示。

3使用基础数据宏

3.1在数据集设计器的参考控件中使用

基础数据宏可以用于定义参数控件的备选值和默认值。

3.2在数据集设计器的查询语句中使用

在查询语句中引用基础数据宏的语法为：$宏编码，可以取到该基础数据宏对应的基础资料的PK值。

3.3在报表设计器的单元格表达式中使用

在报表设计器的公式编辑器中引用基础数据宏的语法为：$宏编码，可以取到该基础数据宏对应的基础资料的PK值。