列印      開啟 PDF 版的線上說明


Previous Topic

Next Topic

關於指定嵌入報表與儀表板的篩選

您可以在自訂 Web Applet 與 Web 頁標中嵌入報表與儀表板。還可設定 Web 連結欄位來開啟報表與儀表板。

建立「報表或儀表板」類型的自訂 Web Applet、Web 頁標或 Web 連結時,您可以指定將在執行時間套用的篩選。若為儀表板,您指定的篩選會套用至儀表板中的所有報表。

也必須在您要嵌入的報表中為您在篩選中指定的每個資料欄設定篩選,如果您要嵌入儀表板,則必須在儀表板的每個報表中為資料欄設定篩選。報表中的篩選可以設定為「會提示」或使用運算子與值來設定。如果在報表中未設定資料欄的篩選,則在執行報表時將不會套用您在 Web Applet、Web 頁標或 Web 連結中指定的資料欄篩選。如需有關將篩選新增至報表的資料欄資訊,請參閱將篩選新增至分析的資料欄

附註:當您建立「報表」類型的自訂 Web Applet、Web 頁標或 Web 連結時,可以視需要選取「顯示報表提示」核取方塊,以指定在執行階段顯示針對嵌入式報表定義的任何提示。在執行階段顯示提示可讓使用者篩選報表。不過,「顯示報表提示」核取方塊中的設定優先順序會高於嵌入式報表或儀表板之「參數」欄位中定義的任何篩選。因此,如果您針對自訂 Web Applet、Web 頁標或 Web 連結勾選「顯示報表提示」核取方塊,即使並未針對嵌入式報表定義任何提示,系統也會忽略如本主題所述「參數」欄位中定義的任何篩選。

指定篩選的語法

您可以透過下列其中一種方式指定篩選的參數:

  • 使用 Pn 參數,稱為 Pn 語法。
  • 使用 opn、coln 以及 valn 參數的群組,稱為 opn 語法。

您不能混合使用這兩種語法類型。

使用 Pn 語法,您最多可指定 6 個篩選。在 P0 參數中,您可指定要設定的篩選數量。P0 參數的有效值為整數 1 到 6。P0 參數只能在參數字串中使用一次。每個篩選均使用三種參數來包含運算子、資料欄及值。您要指定參數 P1-P3 中的第一個篩選。P1 必須指定運算子,P2 必須指定資料欄,而 P3 必須指定值。您要在不同的三種參數集合中指定後續篩選,也就是 P4-P6、P7-P9、P10-P12、P13-P15 及 P16-P18。您必須使用 & 符號來分隔參數。每個參數只能在參數字串中使用一次。

若為單一篩選,其語法如下所示,但參數字串中的參數順序可以任意放置:

P0=1&P1=運算子&P2=表格.資料欄&P3=

若要指定其他篩選,可新增參數 P4-P6、P7-P9 等,並提高 P0 參數的值來符合新增篩選的數量。因此,若為兩個篩選,則語法如下所示:

P0=2&P1=運算子&P2=表格.資料欄&P3=&P4=運算子&P5=表格.資料欄&P6=

使用 opn 語法,您可以指定的篩選數量沒有限制。每個篩選均使用三個為一組的參數:opn 參數指定運算子,coln 參數指定資料欄,而 valn 參數指定值。您必須使用 & 符號來分隔參數。您必須對具有相同編號之篩選群組中的每個參數編號,必須是大於 0 (零) 的整數,且必須對參數群組連續編號。若為單一篩選,其語法如下所示,但參數字串中的參數順序可以任意放置:

op1=運算子&col1=表格.資料欄&val1=

同理,若為兩個篩選,則語法如下所示:

op1=運算子&col1=表格.資料欄&val1=&op2=運算子&col2=表格.資料欄&val2=

附註:在資料欄參數中,如果表格名稱或資料欄名稱內含空格,則須以雙引號括住名稱。如果表格名稱或資料欄名稱不包含空格,則您不需要以雙括號括住名稱,但如有需要,也可以這麼做。這兩種語法類型都是如此。

Page 參數

嵌入儀表板時,您也可以視需要使用 Page 參數,以指定呈現儀表板時要開啟的儀表板頁面。Page 參數的語法為:

Page=頁面名稱

其中頁面名稱是儀表板中顯示的頁面名稱。請勿以雙括號括住頁面名稱,即使名稱內含一個以上的空格也一樣。您可以單獨指定 Page 參數或與其他參數搭配使用。Page 參數可以放置在參數字串中的任意位置,但必須使用 & 符號分隔任何參數之前或之後的 Page 參數。

儲存參數時,不會驗證 Page 參數。如果您沒有使用 Page 參數,或是使用的 Page 參數值為空白,則呈現儀表板時會開啟儀表板的第一頁。如果您在選取的儀表板中指定的頁面名稱不是有效值,則會在執行階段顯示錯誤。

關於參數中的特殊字元

如果您在參數中指定的表格名稱、資料欄名稱、值或儀表板頁面名稱內含任何以下字元,則字元必須被編碼,如下所示:

  • % (百分比符號)。編碼為 %25。
  • & 符號。編碼為 %26。
  • [ (左方括號)。編碼為 %5B。
  • ] (右方括號)。編碼為 %5D。
  • + (加號)。編碼為 %2B。

如果這些字元未編碼,則在您嘗試儲存參數時可能會傳回錯誤,或者執行階段的結果可能不正確。

參數驗證

除了 Page 參數之外,在您嘗試儲存變更時,將會驗證指定的其他參數。如果偵測到任何錯誤,則必須先修正這些錯誤,才能儲存變更。

附註:在第 40 版之前的版次中,儲存篩選參數之前,不會驗證篩選參數。因此,在第 40 版之前的版次中針對嵌入式報表或儀表板指定的篩選參數可能包含錯誤。呈現嵌入式報表或儀表板時,如果在篩選語法中偵測到錯誤,則會顯示錯誤訊息。此外,如果您編輯「報表」或「儀表板」類型的現有 Web Applet、Web 頁標或 Web 連結欄位並在任何欄位進行變更,當您嘗試儲存變更時,會驗證所有欄位 (包含「參數」欄位)。如果偵測到任何錯誤,則必須修正錯誤。

以下各節說明組成篩選的參數。

運算子

下表列出您可以在篩選中使用的運算子。

運算子

描述

eq

等於或位於

neq

不等於或不位於

lt

小於

gt

大於

ge

大於或等於

le

小於或等於

bwith

開頭是

ewith

Ends with

cany

包含任何。值參數可擁有多重值,彼此以加號 (+) 分隔。如果使用 Pn 語法,則您必須在值清單的開頭處指定值的數目。如果使用 opn 語法,則請勿指定值數目,否則,Oracle CRM On Demand 將會假設指定的數目是另一個值。

例如,若要尋找 East、West 及 Central 等客戶地區 (亦即,共有三個地區):

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 Applet,以及 Web 連結) 若要在篩選器參數中包含來自記錄類型的欄位,請將游標移至「參數」欄位中要新增欄位的位置,然後從記錄類型「欄位」清單選取該欄位,其中記錄類型是指為其建立 Applet 之記錄類型的名稱。

    例如,若從記錄類型「欄位」清單選取「資料列 ID」欄位,就會插入 %%%Row_Id%%%。%%%Row_Id%%% 將在執行階段取代成目前記錄的資料列 ID。

附註:報表或儀表板的 URL 是在執行階段產生。報表或儀表板的 URL 長度會因時而異,視執行階段傳給篩選 URL 的值而定。每個瀏覽器都具有 URL 長度上限。如果報表或儀表板的 URL 超過此長度,則當使用者嘗試檢視報表或儀表板時,瀏覽器可能會出現不確定的行為。

附註:您可以指定嵌入式報表的參數或 Web Applet、頁標或連結中之儀表板的相同方式,來指定報表的參數、儀表板或「分析」排定事件的「傳送電子郵件」中的儀表板頁面。不過,您無法選取欄位以指定作為「傳送電子郵件」動作中的參數值。如需有關「分析」的設定排定事件資訊,請參閱建立分析的排定事件


2021年8月 Copyright © 2005, 2021, Oracle 和 (或) 其關係企業。 Legal Notices.