实施指南 › 实施 › 创建交付结果（合同经理） › 如何创建报告 › 自由格式报告

自由格式报告

自由格式报告使用户能够基于 CA Business Service Insight 数据库的 SQL 查询或从可以通过来自 CA Business Service Insight 服务器的连接进行访问的任何其他外部数据源生成报告。 其中还包括可通过 ODBC 访问的任何其他类型的数据源，如 Excel、Access、Lotus Notes、文本文件等。自由格式报告通常用于根据业务逻辑命令 Tools.SaveRecord 和 Tools.SaveFields 创建的数据配置统计报告。

自由格式报告通过连接字符串连接到选定的数据库，并使用查询字符串对数据库执行 SQL 查询。 可向这两个字符串中添加参数，以创建允许用户输入或选择要在查询中包括的特定值的动态报告，如用于连接数据库的用户名和密码。

与使用报告向导生成的报告类似，自由格式报告在“图表”、“数据”和“筛选”选项卡中显示。

注意：只有除第一列之外的所有列都是数字时，自由格式报告才可以包括图表。 第一列中的数据用于 X 轴标题。 列名用于其他标题。

由于自由格式报告直接访问数据库并且使用开放的 SQL 查询，因此维护是个问题。 应格外谨慎，确保不会影响作为自由格式报告的源的基础数据。 在从外部数据源生成报告时，建议设置通知过程，以确保在未事先咨询负责自由格式报告的合同经理的情况下，不会更改这些数据源。

创建自由格式报告时须记住的常规信息。

• 由于国际日期格式问题，通过在业务逻辑中创建自定义公式来为日期指定精确格式通常很有用。 这样每次都可以将日期转换为相同格式的字符串，并避免 US 与 EU 日期格式问题。 应将其用于通过 Tools.SaveFields 或 Tools.SaveRecord 命令写入表 T_SLALOM_OUTPUTS 中的日期。 以下是一个示例公式：

Function FormatDate(DateField)

    If DateField = "" Then
      FormatDate = ""
    Else
      Dim PeriodYear, PeriodMonth, PeriodDay, PeriodHour,
  PeriodMinute, Periodsecond
      PeriodYear    = DatePart("yyyy",DateField)
      PeriodMonth   = DatePart("m",DateField)
      PeriodDay     = DatePart("d",DateField)
      PeriodHour    = DatePart("h",DateField)
      PeriodMinute  = DatePart("n",DateField)
      Periodsecond  = DatePart("s",DateField)
      FormatDate  = PeriodDay&"/"&PeriodMonth&"/"&PeriodYear& _
 " "&PeriodHour&":"&PeriodMinute&":"&Periodsecond
    End If
End Function

• 在使用业务逻辑事件处理程序中的“time”参数或 eventDetails 对象中的任何时间戳时，始终要注意时区偏移的影响。 请注意，写入表的日期可能为 UTC 时间，而不是本地时间。 您可能需要使用 Tools.GetLocaleTime() 函数来更正。
• 还可以使用报告设计器实用工具（在自由格式报告生成图形时）来自定义外观。
• 可以在自由格式设置屏幕上的“报告参数”部分，对自由格式报告的 PDF 导出选项进行自定义。 例如页面布局（横向、纵向）
• 可在报告中嵌入 HTML，以便实现一些不同的功能，如添加超链接或更改列和行的颜色、字体或显示设置。
• 可在 T_SLALOM_OUTPUTS 表中创建数据库视图（Oracle 功能），以简化报告需要的 SQL。
• 指定报告参数时，可通过许多方式进行设置，包括：自由文本、数字（验证）、密码（隐藏的字符 - 用于数据库连接的密码）、日期（使用提供的日期选取器工具）和列表（通过指定 SQL 语句以填充列表来创建）
• 在自由格式报告的 SQL 部分中指定参数值时，需要在参数名前面加上“@”符号来表示。 即 @PARAM1。 如果值是字符串，则需要在此参数值前后加上引号。