![]() |
|
关于为嵌入的报表和仪表盘指定筛选器您可以在定制 Web 小程序和 Web 选项卡中嵌入报表和仪表盘。您还可以配置 Web 链接字段以打开报表或仪表盘。 当您创建“报表”或“仪表板”类型的定制 Web 小程序、Web 选项卡或 Web 链接时,可以指定将在运行时应用的筛选器。对于仪表盘,指定的筛选器将应用于仪表盘中的所有报表。 您在筛选器中指定的每个列还必须在要嵌入的报表中配置了筛选器;如果您嵌入仪表盘,则列必须在仪表盘的每个报表中配置了筛选器。报表中的筛选器可以设置为“提示”或配置运算符和值。如果没有为报表中的列配置筛选器,则在运行报表时,不会应用在 Web 小程序、Web 选项卡或 Web 链接中为该列指定的任何筛选器。有关将筛选器添加到报表中的列的信息,请参阅将筛选器添加到分析中的列。 注意:在创建“报表”类型的定制 Web 小程序、Web 选项卡或 Web 链接时,您可根据需要选中“显示报表提示”复选框,以便指定在运行时显示任何为嵌入式报表定义的提示。在运行时显示提示的功能支持用户筛选报表。但是,“显示报表提示”复选框中的设置优先于在“参数”字段中为嵌入的报表和仪表盘定义的任何筛选器。因此,如果为定制 Web 小程序、Web 选项卡或 Web 链接选中“显示报表提示”复选框,则本主题所述的“参数”字段中定义的任何筛选器都会被忽略,即使没有为嵌入式报表定义任何提示也如此。 用于指定筛选器的语法您可以用以下任一方式为筛选器指定参数:
您不能将两种语法类型混合使用。 使用 Pn 语法,您最多可以指定六个筛选器。在 P0 参数中,指定要设置的筛选器数量。P0 参数的有效值为整数 1 到 6。P0 参数在参数字符串中只能使用一次。每个筛选器使用三个参数以包含运算符、列和值。在参数 P1-P3 中指定第一个筛选器。P1 必须指定运算符,P2 必须指定列,P3 必须指定值。以三个参数为一组指定后续筛选器,即 P4-P6、P7-P9、P10-P12、P13-P15 和 P16-P18。您必须使用 & 符号分隔参数。每个参数在参数字符串中只能使用一次。 对于单一筛选器,语法如下所示,但是可以按任意顺序将参数放在参数字符串中: P0=1&P1=operator&P2=table.column&P3=value 要指定其他筛选器,请添加参数 P4-P6、P7-P9,以此类推,并增大 P0 参数的值以匹配您添加的筛选器数量。因此,对于两个筛选器,语法如下: P0=2&P1=operator&P2=table.column&P3=value&P4=operator&P5=table.column&P6=value 使用 opn 语法,您可以指定的筛选器数量没有限制。每个筛选器使用三个(一组)参数:opn 参数指定运算符,coln 参数指定列,valn 参数指定值。您必须使用 & 符号分隔参数。您必须使用相同数字(大于 0(零)的整数)对筛选器组中的每个参数进行编号,且必须按顺序对参数组进行编号。对于单一筛选器,语法如下所示,但是可以按任意顺序将参数放在参数字符串中: op1=operator&col1=table.column&val1=value 同样,对于两个筛选器,语法如下: op1=operator&col1=table.column&val1=value&op2=operator&col2=table.column&val2=value 注意:在列参数中,如果表名或列名包含空格,则必须用双引号将名称括起来。如果表名或列名不包含空格,则不需要用双引号将名称括起来,但您可以这样做。对于两种语法类型都是如此。 Page 参数嵌入仪表盘时,您也可以选择使用 Page 参数来指定在渲染仪表盘时会打开仪表盘的哪个页面。下面是 Page 参数的语法: Page=page name 其中 page name 是页面显示在仪表盘中的页面名称。不要用双引号将页面名称括起来,即使名称包含一个或多个空格也不例外。您可以独立地或通过其他参数指定 Page 参数。您可以将 Page 参数放在参数字符串的任何位置中,但您必须使用 & 符号将 Page 参数与其前后的任何参数分隔。 在保存参数时,不会验证 Page 参数。如果未包含 Page 参数,或者已包含该参数,但将参数值留空,则在渲染仪表盘时会打开仪表盘的第一页。如果您在选择的仪表盘中指定除页面的有效名称以外的值,则在运行时会显示错误。 关于参数中的特殊字符如果在参数中指定的表名、列名、值或仪表盘页面名称包括以下任何字符,则必须对字符进行编码,如下所示:
如果未对这些字符进行编码,则在您尝试保存参数时可能会返回错误,或在运行时结果可能不正确。 参数验证除 Page 参数以外,在您尝试保存更改时会验证指定的参数。如果检测到任何错误,则必须先修复这些错误,然后才能保存更改。 注意:在版本 40 之前的版本中,在保存筛选器参数之前不会验证这些参数。因此,在版本 40 之前的版本中为嵌入报表或仪表盘指定的筛选器参数可能包含错误。如果在渲染嵌入报表或仪表盘时在筛选器语法中检测到任何错误,则将显示错误消息。此外,如果编辑“报表”或“仪表盘”类型的现有 Web 小程序、Web 选项卡或 Web 链接字段,或对任何字段进行更改,则在您尝试保存更改时,系统会验证包括“参数”字段在内的所有字段。如果检测到任何错误,则必须先修复这些错误。 以下部分介绍构成筛选器的参数。 运算符下表列出了筛选器中可使用的运算符。
列指定列时,请注意以下几点:
值为筛选器指定值时,请注意以下几点:
注意:报表或仪表盘的 URL 在运行时生成。报表或仪表盘的 URL 长度有所不同,具体取决于运行时传递给筛选器的 URL 的值。每个浏览器都有一个最大 URL 长度。如果报表或仪表盘的 URL 超过此长度,则当用户尝试查看该报表或仪表盘时,用户可能会在浏览器上遇到不确定的行为。 注意:您可以按照在 Web 小程序、选项卡或链接中为嵌入的报表或仪表盘指定参数的相同方式,在用于“分析”的计划事件上的“发送电子邮件”操作中为报表、仪表盘或仪表盘页面指定参数。但是,无法选择用于在“发送电子邮件”操作中指定为参数值的字段。有关为分析设置计划事件的信息,请参阅为分析创建计划事件。 |
已发布 3月 2020 | Copyright © 2005, 2020, Oracle. 保留所有权利。Legal Notices. |