报表设计通过 Excel 模板的方式来建立,其原理是预先设置 Excel 的格式,并将变化的部分通过“占位符”来取代,系统会在生成报表时自动替换“占位符”内容。模板配置完成后可以在记录视图中使用(针对单条数据),或在数据列表中使用(列表模板)。
占位符是以 {}
包裹的内容,例如 {createdOn}
(创建时间),仅需将其填写在相应的单元格上。对于 Excel 格式(如字体大小、背景色等)可根据自身需求随意调整,仅需遵循占位符规则即可。下图展示一个 Excel 报表模板内容。
其中 {orderNumber}
{ctratedOn}
等都是占位符,占位符为字段的内部标识,可以进入实体的“字段管理”中查看。如果字段是“引用”类型,还可以通过 点连接 的方式跨表使用。例如订单中有 AccountId
引用字段(引用自客户),那么可以使用 AccountId.AccountName
来获取客户名称。
? 报表模板暂不支持媒体类字段,如图片、附件、二维码等
如果实体有明细实体,也支持一并导出(支持多条明细记录),仅需在占位符的基础上多加一个 .
符号即可,如 {.productName}
。但请注意,明细字段仅支持横向的排列方式,即所有明细字段排列在同一行。
RB 同时支持审批流程导出,与明细实体类似,审批流程通常包含多条审批节点(记录)。仅需在占位符的基础上多加一个 .approval
符号即可,其可用字段如下。
字段 | 说明 |
---|---|
.approval.approver |
审批人 |
.approval.approvedTime |
审批时间 |
.approval.remark |
批注 |
.approval.state |
审批状态(通过/驳回) |
以下示例包含了主记录、明细记录、审批流程。
当报表模板设计好以后,管理员需要将其上传至 RB 才能被其他用户使用。进入管理中心 - 报表模板,点击右上角 [添加] 按钮。
填写好以后点击 [确定] 即可,如有多个报表请依次添加。
当管理员为某实体添加了报表模板后,用户便可以在记录视图页中使用此报表模板,如下图所示。
从 V2.6 版本开始,RB 支持为列表导出配置模板,模板编写规则与上文中提到的 明细实体 类似,即占位符中多加一个 .
符号,且横向的排列在同一行。
对于复杂的报表需求可以购买我们的 商业服务 进行定制。