用户指南 › 报告 › 报告类型 › 自由格式报告 › 自由格式报告参数

自由格式报告参数

在“自由格式报告详细信息”页面的“连接字符串”和“查询”字段中输入的两个字符串足以生成自由格式报告。 但是，通过将“参数”字段中包含的参数添加到默认 XML 文件中，可以显著提高报告的灵活性和效用。 定义完所有参数后，将显示用于在生成报告时输入这些参数值的弹出窗口。

默认 XML 文件如下所示：

<custom>
     <connection>
          <params>
               <!--<param name='@UID' disp_name='User id' type='TEXT' size='10'><value>user id</value></param>- > 
               <!--<param name='@PWD' disp_name='Password' type='PASSWORD' size='10'><value>password</value></param>- > 
          </params>
     </connection>
     <query>
          <params>
               <!--<param name='@PRM1' disp_name='PARAM 1' type='TEXT' size='10'><value>param1 value</value></param>- > 
               <!--<param name='@PRM2' disp_name='PARAM 2' type='LIST'><value>value 1</value><list><item><value>value 1</value><text>text 1</text></item><item><value>value 2</value><text>text 2</text></item></list></param>- > 
               <!--<param name="@PRM3" disp_name="PARAM 3" type="LIST">
                    <value>value</value>
                    <list>
                         <list_query>select customer_id value, customer_name text from t_customers</list_query>
                    </list>
               </param>- > 
          </params>
     </query>
     <pdf>
          <!--<option><name>pameter name</name><value>parameter value</value></option>- > 
     </pdf>
     <chart>
          <!--<precision>Numeric value from 0 to 5</precision>- > 
     </chart>
     <!--<ContainsHTML>0/1</ContainsHTML>- > 
     <!--<headstyle>
          <titlerow bgcolor="value or color name"></titlerow>
          <firstcolumn bgcolor="value or color name"></firstcolumn>
     </headstyle>
</custom>

该 XML 文件包含以下几个主要部分：

• <connection>：包含要查询的数据库的连接信息
• <query>：包含 SQL 查询
• <pdf>：包含用于输出的 PDF 打印选项，如纸张大小、方向等

<connection> 和 <query> 中的每个参数都有自己的 <param> 节点，其中包括以下属性：

• name：参数的名称。
• disp_name：在弹出窗口中显示的参数名称。
• type：参数类型，可以为以下值之一：
• TEXT：文本输入
• PASSWORD：显示为星号的文本
• DATE：“日历”字段
• LIST：包含多个选项的下拉列表
• list_query：包含多个选项而且允许动态值列表的下拉列表。 例如：

  <list>

  <list_query>select some_value value, some_text text from some_table</list_query>

  </list>

  注意：Select 语句应总是包含两列，一列用于存储值，一列用于存储显示文本。

• size：输入字段中允许的最多字符数。

<pdf> 中的参数具有以下属性：

• name：参数的名称
• value：参数的值