常见问题
基础概念
- 报表是什么？
关于报表的概念，目前还没有比较权威、统一和准确的定义，我们认为报表通常是指使用表格、图形或图表结合等方式来展示数据的工具和形式，目的是让人更容易看到数据和看懂数据，有助于人们基于这些数据，做出准确的判断和正确的决定。
- 报表设计是什么？
报表设计就是定义报表中使用了哪些数据集、基于这些数据集提供了哪些查询方式和展示内容，报表设计的最终成果是以报表模板文件的形式，被保存下来，可以说报表设计就是定义报表模板文件。
- 数据集是什么？
数据集是具有相同属性和性质的数据行的集合，这些数据行来自数据库中的一张表，或多张表的字段拼接而成，是报表中动态数据的来源。
- 查询方式是什么？
查询方式是抽象表述和具体定义数据查询过程，每种查询方式必须命名：能够体现查询的意图和意义；每种查询方式必须定义：有哪些查询参数和这些查询参数的设值方式（即查询界面，也称查询窗口）。
- 展示内容是什么？
展示内容是报表向用户展示的各种内容，各种内容是以各种组件的形式来加载和展示。
- 组件是什么？
组件是加载和展示报表中局部内容的具有相同的外观、属性和特性的控件，当前提供文本、图片、字段、参数、表格、图表、网格、面板等组件。
- 环境变量是什么？
环境变量是随着系统环境变化而变化的变量，用户和时间是影响系统环境变化的核心因素，比如用户不同，区别用户身份的用户编号就不同，当前时间不同，代表昨天、今天、前天的具体日期也就不同。
环境变量
- 时间的环境变量有哪些？
| 环境变量 | 用途说明 | 取值举例 |
|---|---|---|
| v_now_time | 当前时间 | 2024-04-11 23:45:59 |
| v_this_day | 今天周几 | 星期一、星期二、星期三、星期四、星期五、星期六、星期日 |
| v_this_year | 今年 | 2024 |
| v_this_month | 本月 | 2024-04 |
| v_this_date | 今日 | 2024-04-11 |
| v_this_monday | 本周一的日期 | 2024-04-08 |
| v_this_sunday | 本周日的日期 | 2024-04-14 |
| v_last_year | 去年 | 2023 |
| v_last_month | 上月 | 2024-03 |
| v_last_date | 昨日 | 2024-04-10 |
| v_last_monday | 上周一的日期 | 2024-04-01 |
| v_last_sunday | 上周日的日期 | 2024-04-07 |
- 用户的环境变量有哪些？
| 环境变量 | 用途说明 | 取值举例 | 其他说明 |
|---|---|---|---|
| v_user_id | 用户编号 | 1 | |
| v_user_name | 用户名称 | 管理员 | |
| v_person_id | 人员编号 | 001 | |
| v_person_name | 人员姓名 | 李世民 | |
| ... ... | 人员属性 | 部门ID、部门名称 | 使用对接人员功能和调用开放接口来扩展 |
可使用数颜报表浏览器中的对接人员功能和开放接口，定义和扩展用户的人员属性。
人员的原生属性和扩展属性全部都会被数颜报表引擎视作环境变量，可以放心使用。
人员是您的业务系统中的操作人员（或用户），是身份验证和数据授权的主体对象。
人员与数颜报表浏览器中的用户是一对一的关系，通过用户的人员编号建立起关系。
人员编号是业务系统操作人员的唯一标识，也是数颜报表浏览器中用户的人员编号。
- 环境变量有哪些使用场景？
可以使用环境变量作为文本内容、内置参数值或外置参数默认值。
- 环境变量应该如何使用？
把相关属性值设置为‘@环境变量名’：如 @v_this_year 代表引用了环境变量 v_this_year。
- 环境变量命名有何特殊要求？
所有环境变量的命名必须以‘v_’开始，否则不会被数颜报表引擎识别为环境变量。
- 环境变量的定义方式有哪些？
1、使用报表浏览器中的对接人员功能：设置人员的编号、名称，定义其他人员属性。
2、调用报表浏览器中的开放接口：传入当前登录人员的编号、名称和其他人员属性。