受管理空間中的應用程式內報告
您可以為需要嚴格資料控管的應用程式設定應用程式內報告。透過用於開發應用程式資料模型以用於受管理空間的相同原則,您可以為應用程式內報告功能準備應用程式。這可以在載入指令碼中使用具有空間意識的語法來達成。
開發準備發佈至受管理空間的應用程式時,請考慮下列事項:
可以在發佈應用程式之前或之後開發範本。若您在發佈之前建立範本,請在發佈後變更已連線應用程式。
發佈清單必須在發佈應用程式之前新增至應用程式。在開發期間,這可能包括模擬資料來源,而非實際資料來源。會在載入指令碼中參考發佈清單中的來源,因此必須使用具有空間意識的語法寫入指令碼,以準備發佈。若您上傳發佈清單作為來源檔案,依照預設會自動使用此語法。
發佈後,可以根據已發佈應用程式的報告使用案例,按照需求重新建立報告資產:範本、篩選和報告任務。用於發佈清單的實際資料來源應新增至受管理空間。
現有的報告設定
若您已在 2024 年 3 月 26 日之前建立報告設定和發佈清單,您需要注意發佈清單檔案上傳流程的變更事項。
對於 2024 年 3 月 26 日之前建立的應用程式,報告區段中上傳的發佈清單來源檔案會自動重新命名並新增至空間。然後,對此重新命名之檔案的參考會自動新增至載入指令碼。現在不再於新增至空間時重新命名上傳的來源檔案。
若要在發佈這些應用程式時繼續使用現有報告設定,請根據發佈清單來源,按照以下對應區段操作。或者,使用此頁面之後顯示的指南,從頭重新建立報告設定。
若您已上傳來源檔案
開啟 資料載入編輯器 並查看發佈清單指令碼區段中的檔案名稱參考。調整語法,以便使用具有空間意識且指向目前空間的參考,而非指向任何特定空間。例如,檔案參考可能如下所示:
FROM "lib://DataFiles/reporting_source_your_app_ID.xlsx"
將此變更為:
FROM "lib://:DataFiles/reporting_source_your_app_ID.xlsx"
您可以看見檔案名稱中包含來源應用程式的應用程式 ID。若您希望此確切指令碼在發佈應用程式時執行,請使用此確切名稱,將實際發佈清單檔案新增至受管理空間。
或者,您可以在開發空間中重新命名來源檔案、更新載入指令碼,然後發佈。最後,使用更新後的名稱,新增實際發佈清單檔案。
若您已在指令碼中手動使用遠端資料來源
若您改為手動設定載入指令碼,以依賴發佈清單的其他資料來源,您只需要調整載入指令碼,以包含相關、具有空間意識的資料來源參考 (若這尚未進行)。
如需更多資訊和具體範例,請參閱 受管理空間中的應用程式資料來源。
工作流程
按照以下順序在受管理空間中使用應用程式內報告。
應用程式開發
在開發空間 (個人或共用空間) 中開發應用程式,如您平常做的事情,以準備發佈至受管理空間。
開發範本和篩選條件
如有需要,您可以在發佈應用程式之前建置報告範本和篩選條件。這作為應用程式開發過程中的一個階段可能很實用,但不會在已發佈的副本保留新增至來源應用程式的範本和篩選條件。
若您在發佈之前建立範本,並想要用於已發佈的應用程式,請變更範本的已連線 Qlik Sense 應用程式。 您可以在增益集中執行此動作。或者,當您將範本上傳到已發佈的應用程式時,請在 Qlik Sense 應用程式中執行此動作。請參閱 變更連線的 Qlik Sense 應用程式。
準備發佈清單參考
將發佈清單新增至應用程式時,會變更應用程式的載入指令碼。無法在已發佈的應用程式中存取應用程式的載入指令碼。因此,您需要在發佈之前將發佈清單新增至應用程式。
在此階段,發佈清單只需要是實際檔案的預留位置或您將在受管理空間中用於發佈清單的其他來源。
根據發佈清單是來源檔案或是在指令碼中手動新增的遠端資料來源,程序稍有不同。不過,基礎概念都相同。如需概述如何在載入指令碼中使用具有空間意識之語法的完整指南,請參閱 受管理空間中的應用程式資料來源。
選項 1:直接上傳來源檔案
按照上傳來源檔案作為發佈清單的一般程序:上傳來源檔案以新增發佈清單。
您可以插入任何所需的預留位置,而非新增最終收件者詳細資訊。此處的重要事項是,您上傳檔案,然後此檔案會自動新增至開發空間並在指令碼中參考。
您可以確認載入指令碼中的 Distribution List 區段包含具有空間意識的檔案參考,且不會直接參考任何特定空間。在應用程式的報告區段中上傳來源檔案作為發佈清單時,這會自動進行。這應如下所示:
FROM "lib://:DataFiles/My_App_Distribution_List.xlsx"
此範例是具有空間意識並指向應用程式目前所在空間的參考。DataFiles 之前的額外冒號提供所需的相對參考。
之後,若您將應用程式發佈至受管理空間,請將實際發佈清單檔案上傳至受管理空間。實際發佈清單必須有與指令碼中參考的檔案相同的檔案名稱。
選項 2:在指令碼中手動參考資料來源
按照在指令碼中手動連線至遠端發佈清單來源的一般程序:在載入指令碼中手動定義發佈清單。
寫入指令碼以連線至發佈清單的所需資料來源時,您可以根據需要使用對檔案和連線的模擬參考。在指令碼中,資料來源的名稱只需要與受管理空間中的名稱相同,而對這些來源的參考需要使用具有空間意識的相對語法。
發佈應用程式
準備載入指令碼和發佈清單後,應用程式就準備好發佈至受管理空間。如需更多關於發佈應用程式的資訊,請參閱 發佈應用程式。
變更連線的 Qlik Sense 應用程式
若您已在發佈應用程式之前建立報告範本,您需要更新範本,以參考正確的應用程式 ID。已發佈的應用程式副本將有與來源應用程式不同的應用程式 ID。
此流程可以在上傳範本時在 Qlik Sense 中完成。對於 Excel 報告範本,這也可以在 Microsoft Excel 的 Qlik 增益集中進行。開始之前,您可以建立獨立的範本副本,以辨別來源應用程式的範本。
如需完整說明,請參閱:
從 Qlik Sense: 變更連線的 Qlik Sense 應用程式
從 Microsoft Excel 的 Qlik 增益集: 變更連線的 Qlik Sense 應用程式
隨時可以直接在受管理空間中開發和更新範本。
新增實際發佈清單來源
在受管理空間中,建立載入發佈清單時所需要的必需檔案和連線,如載入指令碼中的參考。此步驟可隨時完成。
提供發佈清單的資料來源包含的參數名稱 (連線、檔案和欄位的名稱),必須與用於來源應用程式載入指令碼的發佈清單來源相同。
連線的來源新增至空間時,您應能夠載入應用程式。
建立新的報告資產
您現在可以將報告資產新增至應用程式。這可以包括範本、篩選和報告任務。
權限
在受管理空間中具有下列任何角色的使用者可以對應用程式使用應用程式內報告:
擁有者
可以管理
可以操作 (僅 專業或 Full User 權限)
如需詳細資訊,請參閱在受管理空間中管理權限。
限制
應用程式內報告無法用於已從 Client-Managed Qlik Sense (包括多雲端部署) 發佈至 Qlik Cloud 的應用程式。若要搭配這些應用程式使用應用程式內報告,請使用遷移工具將應用程式遷移至 Qlik Cloud (請參閱設定 Qlik Cloud 遷移工具),或手動匯出應用程式並重新上傳到 Qlik Cloud 中。
如需詳細資訊,請參閱具有已匯出或已遷移應用程式的應用程式內報告。