| 打印 打开 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 | 为 NULL。值参数必须为 0（零），且不能忽略。
nnull | 不为 NULL。值参数必须为 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 小程序、选项卡或链接中为嵌入的报表或仪表盘指定参数的相同方式，在用于“分析”的计划事件上的“发送电子邮件”操作中为报表、仪表盘或仪表盘页面指定参数。但是，无法选择用于在“发送电子邮件”操作中指定为参数值的字段。有关为分析设置计划事件的信息，请参阅为分析创建计划事件。

已发布 8月 2022 | Copyright © 2005, 2022, Oracle和/或其附属公司。Legal Notices.