On-Demand template 應用程式中的繫結運算式
範本應用程式中的資料繫結可指定來自對應 selection 應用程式的哪些資料用於闡明載入資料到 On-demand 應用程式時發出的查詢。
繫結運算式的基本格式--$(odag_FIELDNAME)--不是唯一可用於繫結運算式的方法。其他前置詞可用來調整選項並確保範本應用程式正確載入資料。
可用繫結前置詞
一般前置詞格式為 odag[s|o][n][cnt],其中:
- s - 僅包括所選值
- o - 僅包括可選值
- n - 選取數字版本,依預設沒有引號
- cnt - 插入值的數量,而非實際值
下列表格提供可用繫結前置詞的所有版本清單。範例假定一個名為 MyField 的欄位,其中 1、2、3 作為所選值 (綠色值),而 4 作為選用值 (白色值)。
前置詞 | 描述 | 範例 | 取代成 |
---|---|---|---|
odag_ | 以所選 (綠色) 和可選 (白色) 值取代。選取文字版本的值。 這是字串值的標準前置詞。 | $(odag_MyField) | '1','2','3','4' |
odagcnt_ | 在對應的 odag_ 繫結中以值的數量取代。 此前置詞用於查詢最佳化。 | $(odagcnt_MyField) | 4 |
odagn_ |
以所選 (綠色) 和可選 (白色) 值取代。選取數字版本的值。 這是數值的標準前置詞。 資訊備註
若資料模型可以沒有任何所選或可選的欄位值,則必須在運算式中指定 noValue。例如 $(odagn_MyField){"noValue":"-99999"}。 如需詳細資訊,請參閱變更值的引號和分隔符號字元。 |
$(odagn_MyField) | 1,2,3,4 |
odagncnt_ | 在對應的 odagn_ 繫結中以值的數量取代。 這用於查詢最佳化。 | $(odagncnt_MyField) | 4 |
odago_ |
以可選 (白色) 值取代。選取文字版本的值。 這用於查詢最佳化。 |
$(odago_MyField) | '4' |
odagocnt_ | 在對應的 odago_ 繫結中以值的數量取代。 這用於查詢最佳化。 | $(odagocnt_MyField) | 1 |
odagon_ |
以可選 (白色) 值取代。選取數字版本的值。 這用於查詢最佳化。 |
$(odagon_MyField) | 4 |
odagoncnt_ | 在對應的 odagon_ 繫結中以值的數量取代。 這用於查詢最佳化。 | $(odagoncnt_MyField) | 1 |
odags_ |
以所選 (綠色) 值取代。選取文字版本的值。 這用於查詢最佳化。 |
$(odags_MyField) | '1','2','3' |
odagscnt_ | 在對應的 odags_ 繫結中以值的數量取代。 這用於查詢最佳化。 | $(odagscnt_MyField) | 3 |
odagsn_ |
以所選 (綠色) 值取代。選取數字版本的值。 這用於查詢最佳化。 |
$(odagsn_MyField) | 1,2,3 |
odagsncnt_ | 在對應的 odagsn_ 繫結中以值的數量取代。 這用於查詢最佳化。 | $(odagsncnt_MyField) | 3 |
文字版本會篩選掉空的值。數字版本會篩選掉非數字和 NaN 值。
為大型資料庫最佳化
odags_ 和 odagsn_ 前置詞的用途為查詢最佳化。若繫結欄位中沒有選項,則 odag_ 包括所有值,而 odags_ 則不包括任何值。在某些情況下,使用 odags_ 和 odagscnt_ 前置詞更有效率。這可讓您測試值的集合是否為空。例如,若在 MyField 中沒有進行任何選取,則比起測試 odag_MyField 中的所有值,下列方式更有效率。
若在不是 on-demand 欄位的 selection 應用程式中,有要選取的替代欄位,則無法使用 odags_。例如,若使用者在 CountryName 中進行選取,但繫結運算式位於關聯欄位 CountryCode,則無法使用 odags_。在這些情況下,可以改用 odago_。若 odago_ 繫結中沒有任何值,可以表示應納入所有值,或者不應納入任何值。
繫結數值
當要繫結至 On-demand app (On-demand 應用程式) 的資料包含數字而非字串時,停用數值欄位的引號括住行為非常實用。例如,如果銷售記錄包含數值 DAY_OF_WEEK 資料行,且您想要 selection 應用程式的使用者選擇 DAY_OF_WEEK 的任意組合,則您可以增加用於載入 selection 應用程式的彙總查詢,以便將 DAY_OF_WEEK 同時包含在選取清單和組成群組依據清單中。選取 DAY_OF_WEEK 值時,如果其用引號括住,且資料庫不支援自動從字串類型轉換為數值,則會導致執行時間查詢錯誤。
若要處理此情況,可以使用數字版本的繫結運算式後置詞。這迫使欄位繫結使用來自 selection 應用程式的數值,而非字串值。下列數字版本可供使用:
- odagn_
- odagon_
- odagsn_
透過使用數字版本,會從儲存所選值之雙值的數字部分選取值,依照預設,值不會加上引號。
需要特定數目的選取項目
在某些情況下,可能必須要求 On-demand 應用程式查詢包含特定欄位的特定數目或範圍的值。例如,如果 On-demand 應用程式的查詢包含 BETWEEN 子句,以便取得開始和結束日期之間的所有銷售,則 YEARQUARTER 欄位的繫結運算式可以採用後置詞語法 [2],這表示將需要針對 YEARQUARTER 正好選取兩個值,亦即:
只要不是正好選取兩個 YEARQUARTER 值,selection 應用程式上的 On-demand 應用程式導覽點將保持停用。將顯示一則訊息,指出必須正好選取兩個 YEARQUARTER 值。
選取數量限制可在 selection app (選取應用程式) 和 On-demand app (On-demand 應用程式) 之間建立必要連結。這不同於不使用數量限制式的繫結運算式。例如,template app (範本應用程式) 的指令碼包含沒有數量限制的繫結運算式時,亦即:
不需要 selection 應用程式包含名為 MYFIELD 的欄位,也不需要該欄位有任何選定的值 (如果不存在)。如果 selection 應用程式未包含名為 MYFIELD 的欄位,或者使用者只是忘記做出任何選擇,則當做出其他選擇以滿足記錄限制值條件時,On-demand 應用程式導覽點仍可以變為啟用狀態。
如果是另一種情況,則繫結運算式:
現在對 selection app (選取應用程式) 設定了兩項需求:
- Selection 應用程式必須包含名為 MYFIELD 的欄位。
- 使用者必須針對 MYFIELD 至少選取一個值。
此類型的繫結運算式必須謹慎使用,因為這會限制哪些 selection 應用程式可以搭配範本應用程式使用。您不應在範本應用程式的繫結上使用此數量限制式,除非您確定要強制執行連結至該範本應用程式的所有 selection 應用程式上的選項數量需求。
若要執行資料繫結程序,On-demand 應用程式服務會使用對指令碼中的註解不起作用的字串替代方式。這表示您不應在註解中使用繫結運算式,除非您希望這些註解包含應用程式產生後的繫結值清單。
可以設定其他數量限制。下表概述了不同的選取數量限制組合。
限制模式 | 選取需求 |
---|---|
$(odag_YEARQUARTER)[2] | 必須選取正好 2 個 YEARQUARTER 值。 |
$(odag_YEARQUARTER)[2-4] | 必須選取 2 到 4 個 YEARQUARTER 值。 |
$(odag_YEARQUARTER)[2+] | 必須至少選取 2 個 YEARQUARTER 值。 |
$(odag_YEARQUARTER)[2-] | 最多可選取 2 個 YEARQUARTER 值。 |
變更值的引號和分隔符號字元
將 selection 應用程式中選定欄位中的值清單插入 template 應用程式的指令碼中時,值會以單引號括住並以逗號分隔。這些是引號和分隔符號的預設字元。在附加到每個欄位之繫結陳述式的語法中,這些值可以變更。例如︰
隨後可在制訂從 selection 應用程式取用的繫結值清單時使用這些新的值。例如,若選取的值是該年的前三個月,則清單建構方式如下:
引號和分隔符號的預設值適用於大多數標準 SQL 資料庫。但是,它們可能不適用於某些 SQL 資料庫,且無法用於許多動態資料來源,如 NoSQL 和 REST。針對這些來源,您需要附加此繫結運算式,以變更引號和分隔符號字元。
下列表格概述用於變更引號和分隔符號字元的格式參數。
參數 | 預設值 | 定義 |
---|---|---|
引號 |
' (單引號) 用於文字前置詞 空白用於數字前置詞 |
將新增於每個值之前和之後 |
分隔符號 | , (逗號) | 將新增於所有值之間 |
quoteReplace | '' (雙單引號) |
若值不是空白,且引號不是空白,則值內部出現引號的所有地方將會以指定字串取代。 資訊備註對於 odagn_ 等數字前置詞,quoteReplace 作為參數不受支援。quoteReplace 被數字前置詞忽略。
|
noValue | (空白) |
若沒有對欄位選取任何值,將會改用此值。若選項中可以沒有特定欄位的值,此參數十分實用。 值應設定為不存在於來源資料的值。例如,對於數值,若資料庫中的所有值都是正值,則使用負值。 資訊備註 對於沒有引號的值,若欄位的所選值可以是空集合,則必須指定 noValue。
|
下列表格概述 odag_ 和 odagn_ 的格式規格和產生的值。產生的插入值是根據 VAL1、VAL2 的預設資料值。
格式規格 | 描述 | 產生的插入值 |
---|---|---|
未指定 |
以逗號分隔的值清單,使用 ' 加上引號。 |
'VAL1','VAL2' |
{"quote": "", "delimiter": ""} | 串連值 | VAL1VAL2 |
{"quote": "X", "delimiter": "Y"} |
以 X 加上引號並以 Y 分隔的值。 | XVAL1XYXVAL2X |
{"quote": "XX", "delimiter": "YY"} | 以 XX 加上引號並以 YY 分隔的值。 | XXVAL1XXYYXXVAL2XX |
{"quote": "X"} | 以 X 加上引號並以 , (預設) 分隔的值。 | XVAL1X,XVAL2X |
{"delimiter": "YY"} | 以 ' (預設) 加上引號並以 YY 分隔的值 | 'VAL1'YY'VAL2' |
{"quote": ""} | 以 , 分隔且沒有引號的值。 | VAL1,VAL2 |
{"quote": "A", "quoteReplace": "\\A"} |
以 A 加上引號並以逗號 (預設) 分隔的值。將以 \A 取代欄位內部的 A 值。 資訊備註
在此範例中,需要使用雙 \,因為 \ 在 json 格式中為逸出字元。 |
AV\AL1A,AV\AL2A |
格式規格 | 描述 | 產生的插入值 |
---|---|---|
未指定 |
以逗號分隔且沒有引號的值清單。請注意,將會使用數值。 |
VAL1,VAL2 |
{"delimiter": "YY"} | 以 YY 分隔且沒有引號的值 | VAL1YYVAL2 |
{"quote": "A", "quoteReplace": "\\A"} | 相較於 odag_ 前置詞,將會忽略 quoteReplace 參數。 | AV\AL1A,AV\AL2A |
處理個別值
若需要個別處理欄位值,可以使用內嵌方法,以產生變數 Values 中的值,並透過 Replace 或另一個函數執行任意處理。在以下範例中,Replace 搭配預留位置值使用。