3.4. 字段值格式化

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

report formatter
Figure 55. 字段值格式
  • 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 idFileDecriptor 实例本身的链接。

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

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