打印      打开 PDF 版本的联机帮助


上一主题

下一主题

关于为嵌入的报表和仪表盘指定筛选器

您可以在定制 Web 小程序和 Web 选项卡中嵌入报表和仪表盘。您还可以配置 Web 链接字段以打开报表或仪表盘。

当您创建“报表”或“仪表板”类型的定制 Web 小程序、Web 选项卡或 Web 链接时,可以指定将在运行时应用的筛选器。对于仪表盘,指定的筛选器将应用于仪表盘中的所有报表。

您在筛选器中指定的每个列还必须在要嵌入的报表中配置了筛选器;如果您嵌入仪表盘,则列必须在仪表盘的每个报表中配置了筛选器。报表中的筛选器可以设置为“提示”或配置运算符和值。如果没有为报表中的列配置筛选器,则在运行报表时,不会应用在 Web 小程序、Web 选项卡或 Web 链接中为该列指定的任何筛选器。有关将筛选器添加到报表中的列的信息,请参阅将筛选器添加到分析中的列

注意:在创建“报表”类型的定制 Web 小程序、Web 选项卡或 Web 链接时,您可根据需要选中“显示报表提示”复选框,以便指定在运行时显示任何为嵌入式报表定义的提示。在运行时显示提示的功能支持用户筛选报表。但是,“显示报表提示”复选框中的设置优先于在“参数”字段中为嵌入的报表和仪表盘定义的任何筛选器。因此,如果为定制 Web 小程序、Web 选项卡或 Web 链接选中“显示报表提示”复选框,则本主题所述的“参数”字段中定义的任何筛选器都会被忽略,即使没有为嵌入式报表定义任何提示也如此。

用于指定筛选器的语法

您可以用以下任一方式为筛选器指定参数:

  • 使用 Pn 参数(称为 Pn 语法)。
  • 使用 opn、coln 和 valn 参数组(称为 opn 语法)。

您不能将两种语法类型混合使用。

使用 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 参数,或者已包含该参数,但将参数值留空,则在渲染仪表盘时会打开仪表盘的第一页。如果您在选择的仪表盘中指定除页面的有效名称以外的值,则在运行时会显示错误。

关于参数中的特殊字符

如果在参数中指定的表名、列名、值或仪表盘页面名称包括以下任何字符,则必须对字符进行编码,如下所示:

  • %(百分比符号)。编码为 %25。
  • & 符号。编码为 %26。
  • [(左中括号)。编码为 %5B。
  • ](右中括号)。编码为 %5D。
  • +(加号)。编码为 %2B。

如果未对这些字符进行编码,则在您尝试保存参数时可能会返回错误,或在运行时结果可能不正确。

参数验证

除 Page 参数以外,在您尝试保存更改时会验证指定的参数。如果检测到任何错误,则必须先修复这些错误,然后才能保存更改。

注意:在版本 40 之前的版本中,在保存筛选器参数之前不会验证这些参数。因此,在版本 40 之前的版本中为嵌入报表或仪表盘指定的筛选器参数可能包含错误。如果在渲染嵌入报表或仪表盘时在筛选器语法中检测到任何错误,则将显示错误消息。此外,如果编辑“报表”或“仪表盘”类型的现有 Web 小程序、Web 选项卡或 Web 链接字段,或对任何字段进行更改,则在您尝试保存更改时,系统会验证包括“参数”字段在内的所有字段。如果检测到任何错误,则必须先修复这些错误。

以下部分介绍构成筛选器的参数。

运算符

下表列出了筛选器中可使用的运算符。

运算符

说明

eq

等于或在范围内

neq

不等于或不在范围内

lt

小于

gt

大于

ge

大于等于

le

小于等于

bwith

开头是

ewith

结束于

cany

包含任意。值参数可以具有多个值,用加号 (+) 分隔每个值。如果使用 Pn 语法,则您必须在值列表开头指定值的数量。如果您使用 opn 语法,则不指定值的数量,否则,Oracle CRM On Demand 将假设指定的数量是另一个值。

例如,要查找客户区域“东部”、“西部”和“中部”(即三个区域):

P0=1&P1=cany&P2="Account"."Account Region"&P3=3+East+West+Central

或:

op1=cany&col1="Account"."Account Region"&val1=East+West+Central

call

包含所有。值参数可以具有多个值,用加号 (+) 分隔每个值。如果使用 Pn 语法,则您必须在值列表开头指定值的数量。如果您使用 opn 语法,则不指定值的数量,否则,Oracle CRM On Demand 将假设指定的数量是另一个值。

like

类似。值参数必须包含值。值字符串必须以通配符 %(百分比符号)结尾,否则,like 运算符将仅返回此字符串的完全匹配项。百分比符号必须编码为 %25。

例如,要查找与 Acme 类似的客户名称,请使用:

P0=1&P1=like&P2="Account"."Account Name"&P3=Acme%25

或:

op1=like&col1="Account"."Account Name"&val1=Acme%25

top

n 项。例如,要查找排名靠前的 6 个销售收入,请使用:

P0=1&P1=top&P2="Account"."Account Revenue"&P3=6

或:

op1=top&col1="Account"."Account Revenue"&val1=6

bottom

n 项。例如,要查找排名靠后的 4 个销售收入,请使用:

P0=1&P1=bottom&P2="Account"."Account Revenue"&P3=4

或:

op1=bottom&col1="Account"."Account Revenue"&val1=4

bet

介于。值参数必须具有两个值,用加号 (+) 分隔。如果使用 Pn 语法,则您必须在值列表开头指定值的数量 (2)。如果您使用 opn 语法,则不指定值的数量,否则,Oracle CRM On Demand 将假设指定的数量是另一个值。

例如,要筛选介于 100,000 与 500,000 之间的客户收入:

P0=1&P1=bet&P2="Account"."Account Revenue"&P3=2+100000+500000

或:

op1=bet&col1="Account"."Account Revenue"&val1=100000+500000

null

为空。值参数必须为 0(零),且不能忽略。

nnull

不为空。值参数必须为 0(零),且不能忽略。

指定列时,请注意以下几点:

  • 您必须同时指定表名和列名,用句点 (.) 分隔。
  • 如果表名或列名包含空格,则必须用双引号将该名称括起来。如果表名或列名不包含空格,则不需要用双引号将名称括起来,但您可以这样做。对于两种语法类型都是如此。例如,以下所有项有效:

    "Account"."Account Name"

    "Service Request".Area

    Account."Account Name"

  • 必须使用原始列名,而不是显示名称。

为筛选器指定值时,请注意以下几点:

  • 可以直接指定值,也可以指定一个字段作为参数。
  • 如果使用 opn 语法,且直接指定包含空格的值,则必须用双引号将值括起来。如果指定多个值,且任一值包含空格,则必须用双引号将每个指定的值括起来,例如:

    val1="New York"+"Alabama"+"California"

    如果使用 Pn 语法,则您不需要用双引号将包含空格的值括起来。

  • 要在筛选器参数中包含用户或系统字段,请将光标放在“参数”字段中要添加参数的位置,然后从“用户和系统字段”列表中选择要包括的字段。

    有关可在参数中使用的用户和系统字段的信息,请参阅用户和系统字段。

  • (仅限用于记录类型详细信息页面的 Web 小程序以及 Web 链接)要在筛选器参数中包含来自记录类型的字段,请将光标放在“参数”字段中要添加字段的位置,然后从记录类型字段列表中选择字段,其中记录类型是要为其创建小程序的记录类型的名称。

    例如,如果从记录类型字段列表中选择“行 ID”字段,则会插入 %%%Row_Id%%%。运行时,%%%Row_Id%%% 将被当前记录的行 ID 替换。

注意:报表或仪表盘的 URL 在运行时生成。报表或仪表盘的 URL 长度有所不同,具体取决于运行时传递给筛选器的 URL 的值。每个浏览器都有一个最大 URL 长度。如果报表或仪表盘的 URL 超过此长度,则当用户尝试查看该报表或仪表盘时,用户可能会在浏览器上遇到不确定的行为。

注意:您可以按照在 Web 小程序、选项卡或链接中为嵌入的报表或仪表盘指定参数的相同方式,在用于“分析”的计划事件上的“发送电子邮件”操作中为报表、仪表盘或仪表盘页面指定参数。但是,无法选择用于在“发送电子邮件”操作中指定为参数值的字段。有关为分析设置计划事件的信息,请参阅为分析创建计划事件


已发布 3月 2020 Copyright © 2005, 2020, Oracle. 保留所有权利。Legal Notices.