建立 On-demand template 應用程式
On-demand template 應用程式是一項常規 Qlik Sense 應用程式,但具有一項重大差異:其載入指令碼包含用於闡明其對資料來源之查詢的繫結運算式。On-demand 應用程式產生時會使用這些資料繫結運算式來從 selection 應用程式的選取狀態讀取值,並將其繫結至 template 應用程式指令碼,以便產生的應用程式載入使用者控制的資料子集。
template 應用程式通常連接至與 selection 應用程式相同的資料來源。Selection 應用程式的載入指令碼通常會載入彙總後的資料以減少資料量,同時仍提供重要維度和量值的互動性視覺化。Template 應用程式的載入指令碼使用查詢來載入更細微資料的控制子集。
Template 應用程式必須將工作表設為公開,讓其他使用者產生 on-demand 應用程式。如需詳細資訊,請參閱授予工作表、工作表群組、書籤和故事的存取權限。
Template 應用程式的結構
Template 應用程式使用 On-demand 應用程式導覽連結連結至 selection 應用程式。應用程式導覽連結包含的屬性,可在 On-demand 應用程式載入資料時控制查詢的記錄數。Template 應用程式的載入指令碼包含資料繫結運算式,這些運算式將指定來自 selection 應用程式的哪些欄位資料用於闡明載入資料到 On-demand 應用程式時發出的查詢。
June 2020 中採用了新的資料繫結運算式語法。先前的語法和前置詞 od_、ods_、odo_、odso_ 和 odb_ 的作用與之前相同,包括數量限制式 _n suffix 和格式規格。若應用程式在早於 June 2020 的 Qlik Sense 版本上運作,請使用舊語法。關於舊語法,請參閱建立 On-demand template 應用程式 (舊版)。
使用新的前置詞時不支援 _n suffix。
基本資料繫結運算式具有以下形式:
$(odag_FIELDNAME)
odag_ 前置詞用來將 selection 應用程式的選取狀態繫結到 on-demand 應用程式的載入指令碼,其建立方式是複製 template 應用程式。遵循 odag 前置詞的部分資料繫結運算式必須是符合 selection 應用程式中欄位的名稱。產生 on-demand 應用程式時,selection 應用程式的目前選取狀態會用來取得所需值,以繫結每個欄位。在新建立的 on-demand 應用程式的載入指令碼中,$(odag_FIELDNAME) 運算式的每個出現項目均取代為針對 selection 應用程式選取狀態中對應欄位選取的值清單。
可以使用其他用於更特別之資料繫結的前置詞。若要進一步瞭解為特殊案例量身打造和最佳化 load 陳述式,請參閱 On-Demand template 應用程式中的繫結運算式。
On-demand 繫結可直接插入載入指令碼中的 SELECT 和 WHERE 陳述式。將繫結直接新增至 WHERE 陳述式時,與陳述式中的其他條件合併十分簡單。
製作載入指令碼時,您可以新增預留位置變數 $(odagActive)。這可讓您將樣本資料載入 template 應用程式,以便在沒有載入所有資料的情況下建立用於動態檢視的主要圖表。
如果變更範本應用程式的指令碼並插入新的繫結變數,則必須建立新的隨選應用程式導覽連結,以替換任何現有的應用程式導覽連結。如果不這樣做,則不會為使用該範本應用程式的現有隨選應用程式傳送對應欄位的選項。
下列範例說明樣本 on-demand template 載入指令碼。
範例: 新增一些樣本資料
此範例新增樣本值,即使在沒有完成繫結時也能載入應用程式。
IF '$(odagActive)'='' THEN
trace ODAG variables not inserted! Loading sample data.;
SET 'odag_Origin Code' = '''LAX''';
SET 'odag_Destination Code' = '''JFK''';
SET odagn_Year = 2015;
SET odag_Quarter = '''1''';
SET 'odag_Ticket Carrier Code' = '''CA''';
SET 'odag_Fare Class' = '''X''';
END IF;
範例: 在 template 應用程式中載入資料
以下是用於載入樣本資料和透過產生的 odag_FIELDNAME 繫結所篩選的樣本載入指令碼。odagn_<Field Name> 繫結以雙值選取數字並依預設沒有使用任何引號。
SQL SELECT *
FROM FlightDB.Flights
WHERE "Origin Code" IN ($(odag_Origin Code))
AND "Destination Code" IN ($(odag_Destination Code))
AND "Year" IN ($(odagn_Year))
AND "Quarter" IN ($(odag_Quarter))
AND "Ticket Carrier Code" IN ($(odag_Ticket Carrier Code))
AND "Fare Class" IN ($(odag_Fare Class));
單一登入 (SSO)
On-demand 應用程式可透過支援 SSO 的資料來源使用 單一登入 (SSO)。引擎和資料來源必須設定為允許 SSO。
引擎和資料來源設定了 SSO 後,template 應用程式必須將下列語法新增至 template 應用程式指令碼,以啟用 SSO:
///!ODAG_SSO
On-Demand 應用程式服務 在產生 on-demand 應用程式以及每次載入時剖析指令碼。
on-demand 應用程式透過 SSO 載入時,使用者的身分識別會傳送至資料來源。使用者必須能夠存取用於 template 應用程式資料連線的來源。在這些來源中,只能載入使用者能夠存取的資料,即使選取了較大的資料集仍是如此。