字段值格式化

可以在报表详情视图的 Value formats（值格式） 标签页中为报表输出的字段指定格式。下面是添加格式的表单：

value format

  • Name - 带有报表带区前缀的报表字段名称，例如，Book.year。

  • Format string - 格式化字符串。对于数字值，根据 java.text.DecimalFormat 的规则指定格式，对于日期值 - 根据 java.text.SimpleDateFormat 的规则指定格式。

  • Groovy script 复选框。可以使用 Groovy 脚本来格式化参数。脚本中使用 value 别名访问当前参数值，对其进行格式化或者转换成需要的格式。Groovy 脚本需要返回字符串类型的新值。

    编写 Groovy 脚本时，可以创建能处理 枚举类型 的格式化器。这个格式化器可以使用 消息包 将枚举的 ID 转化为其本地化文本。

    value format groovy

    脚本中可以用 ApplicationContext（org.springframework.context.ApplicationContext）对象访问 Spring bean。

使用格式，可以将图像和 HTML 块插入到文档中。

  • 如需插入图像，将图像 URL 指定为字段值，格式字符串必须是：${image:<Width>x<Height>}，例如 ${image:200x300}。

    如需使用 FileRef，可以使用 ${imageFileId:WxH} 格式，接收 FileRef 实例或文件的 URI 字符串。

  • 如需插入 HTML 段，应该在字段中返回 HTML 标记，并选择 ${html} 作为格式字符串。在输出值中，可以省略 <body> 以上的顶层 HTML 标记。如有必要，将自动添加所有缺少的顶层标记。所有片段都应该用 UTF-8 编码。不支持 CSS 和 style 属性。

也可以指定自定义的格式。直接在控件中输入新的值而不必打开下拉列表，然后敲回车。也可以从下拉列表中选择任何格式，在控件中编辑名称然后敲回车。两种情况都会保存自定义的格式。