4.4. 字段值格式化

可以在报表编辑界面的 Parameters and Formats 标签页中为报表输出的任何字段指定格式。下面是添加格式的表单：

report formatter
Figure 56. 字段值格式

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

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

  • Groovy script - 复选框。可以使用 Groovy 脚本来格式化参数。使用 value 别名，会将当前参数值传递给脚本，可以用来格式化或者转换成需要的格式。Groovy 脚本需要返回字符串类型的新值。

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

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

    要使用 FileDescriptor，可以使用 ${imageFileId:WxH} 格式，它接受 FileDescriptor id 和 FileDecriptor 实例本身的链接。

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

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