跳到主要內容 跳至補充內容

建立報告的發佈清單

建立報告任務之前,您必須為作為報告基礎的 Qlik Sense 應用程式定義發佈清單。發佈清單包含可以是應用程式報告任務接收者的所有收件者和收件者群組。

使用發佈清單設定作為報告傳送對象的個人。設定報告任務時,您可以從將會接收該特定報告任務輸出的發佈清單選取收件者和群組。

發佈清單提供下列詳細資訊:

  • 從應用程式產生的所有表格式報告的收件者,包括其名稱、電子郵件地址、套用至他們的篩選條件,以及他們屬於哪些群組。

  • 可以接收從應用程式產生的報告的所有群組 (一個或多個收件者的集合)。

若您上傳來源檔案作為發佈清單,這會顯示在應用程式報告區段內的收件者群組索引標籤。

收件者群組索引標籤

應用程式報告區段中的「收件者」和「群組」索引標籤

只有一個來源檔案可新增至應用程式。若您需要對來源檔案進行變更,請編輯您原本上傳的檔案 (或資料來源) 並重新上傳。若您改用資料連線定義發佈清單,請根據需要對指令碼進行編輯。請注意,若您這麼做,必須根據需要對報告任務設定和篩選條件進行同等變更。

我可以向誰傳送表格式報告?

您可以在應用程式的發佈清單中納入內部和外部收件者。下表描述每種類型的收件者,以及您可以預期他們會在報告中看見的內容。

應用程式報告任務輸出的電子郵件的可能收件者
收件者類型 描述 行為
內部

Qlik Cloud 租用戶中的使用者。

若要瞭解如何將使用者新增至 Qlik Cloud 租用戶,請根據訂閱類型,參閱 將使用者新增至 Qlik Cloud將使用者新增至 Qlik Cloud

除非應用程式使用區段存取,否則此收件者報告包含的資料將會根據報告任務擁有者對應用程式所擁有的存取權限。

關於區段存取行為,請參閱 表格式報告和區段存取

外部 不屬於 Qlik Cloud 租用戶的使用者。 報告中包含的資料永遠根據報告任務擁有者的資料存取權限。

若您改為透過發佈資料夾 (Microsoft SharePoint) 發佈報告,可存取對應連線指定之位置的任何人都能存取報告。您仍然必須定義應用程式的發佈清單,以開始產生報告輸出,並決定每次報告任務執行時會產生多少報告輸出版本 (每個個別收件者篩選條件一個檔案)。如需更多關於將報告儲存至發佈資料夾的資訊,請參閱 將表格式報告傳遞至發佈資料夾

Qlik Sense 應用程式使用區段存取,重要的是應注意這會如何影響報告接收者。請參閱 表格式報告和區段存取

發佈清單、收件者篩選條件和任務輸出

發佈清單控制分別套用至每個收件者的報告篩選條件。將發佈清單新增至應用程式時,會為套用的每個篩選條件建立獨立收件者。設定報告任務時,您會新增每個收件者,作為對應至單一篩選條件的使用者與篩選條件配對。

例如,若您將篩選條件 A 和 B 套用至名稱為 User1 的收件者,會有兩個收件者新增至該應用程式,即具有篩選條件 A 的 User1 和具有篩選條件 B 的 User1。

如需更多關於如何設定報告任務以產生所需輸出的資訊,請參閱:

載入排程擁有權考慮事項

發佈清單透過對應用程式載入指令碼的自動或手動修改來運作。進行下列任何動作時,您可能會成為應用程式載入排程的新擁有者:

  • 上傳來源檔案作為發佈清單

  • 刪除發佈清單

  • 對載入指令碼進行任何手動編輯

注意這些情境很重要,因為按照排程載入時,排程擁有者對於應用程式及其資料來源必須有所需的存取權限。否則,應用程式將會無法載入。

如需詳細資訊,請參閱載入排程的擁有權

新增發佈清單

使用以下兩個方法之一新增發佈清單:

  • 上傳來源檔案

  • 在載入指令碼中手動定義收件者和群組

下面區段會說明每個方法。

上傳來源檔案以新增發佈清單

您可以上傳包含所需資訊的來源檔案,以定義發佈清單。此檔案必須包含特定格式和結構。建立來源檔案最簡單的方式是下載範例檔案,並使用您的收件者和群組資訊修改。

上傳來源檔案作為發佈清單會取代現有的來源檔案 (如有)。只有一個來源檔案可套用至應用程式。若您上傳來源檔案,此檔案會取代之前上傳至應用程式的來源檔案 (如有)。若舊檔案和新檔案之間有不相符的情況,這會造成現有的報告任務失敗。

若您上傳來源檔案以新增發佈清單,會在應用程式的載入指令碼中自動產生新的區段 (Distribution List),且應用程式會載入。此指令碼區段列出應用程式的收件者和群組。然後就能在應用程式的資料模型中存取發佈檔案中的詳細資訊。

若您上傳來源檔案作為發佈清單,也會將檔案作為資料檔案新增至包含應用程式的空間。Distribution List 指令碼區段會參考此檔案作為空間內的項目。

提示備註若您不希望應用程式使用者建立視覺化和報告篩選條件時,可存取已上傳的發佈檔案清單中的欄位,請在指令碼中使用 HidePrefix 系統變數。使用此方式來隱藏欄位,同時保留在資料模型中。如需詳細資訊,請參閱HidePrefix

考慮事項

上傳來源檔案之前,請考慮下列重要的詳細資訊須知:

  • 新的 Distribution List 指令碼區段新增為指令碼的最後一個區段。因此,Distribution List 之前的最後一個區段的任何指令碼格式問題將會造成載入失敗。例如,這會出現要載入的最後一個表格結尾沒有分號之類的情況。

  • 請勿在自動產生的 Distribution List 指令碼區段中修改 SubField 函數運算式。需要這些運算式才能為篩選條件和群組支援以逗號分隔的值。

    SubField([Filters],',') AS [DL_DISTRIBUTION_FILTERS], SubField([Groups],',') AS [DL_DISTRIBUTION_GROUP_NAMES]
  • 由於上傳來源檔案的運作方式是將資料載入到應用程式中,這也會計入 Qlik Cloud 訂閱定義的購買資料載入量 (僅適用於基於容量的訂閱)。請參閱 Qlik Cloud 基於容量的訂閱

下載範例檔案

範例來源檔案是您可以在上傳至應用程式之前修改的 Excel 活頁簿。

  1. 在應用程式的報告區段中開啟收件者群組索引標籤。

  2. 按一下新增收件者和群組

  3. 選取 妙招 下載範例

下載範例發佈清單檔案

按一下收件者索引標籤中的按鈕,以下載範例來源檔案

下載範例檔案後,您可以修改以新增應用程式的收件者和群組。

新增收件者

開啟您剛下載的範例檔案,並確認您有下列開啟的活頁簿:

DL_DISTRIBUTION_SVC_USERS_QCS

接下來,您可以取代工作表內的資料,以新增自己的收件者。請勿變更或移除顯示欄標頭的第一列。

  1. 名稱欄中,新增收件者的名稱。

  2. 電子郵件欄中,新增收件者的電子郵件地址。請注意,此欄會自動格式化為具有電子郵件地址目的地的超連結。

  3. 篩選欄中,在應用程式的報告區段中新增對應至篩選索引標籤新增內容的篩選群組。以逗號分隔篩選群組。

  4. 群組欄中,新增收件者所屬的群組。以逗號分隔每個群組。

新增群組

在來源檔案中,會在使用此標題的工作表中定義群組:

DL_DISTRIBUTION_SVC_GROUPS_QCS

開啟此活頁簿並取代資料,以在發佈清單中建立群組。請勿變更或移除顯示欄標頭的第一列。

  1. 名稱欄中,新增群組名稱。

  2. 描述欄中,新增群組描述。

上傳發佈清單檔案

建立來源檔案後,上傳至應用程式報告區段中的收件者群組索引標籤。若您這麼做,應用程式會載入,且收件者和群組會填入各自的區段。

  1. 開啟收件者群組索引標籤。

  2. 按一下新增收件者和群組

  3. 選取上傳新版本 (.xlsx)

上傳來源檔案

按一下收件者索引標籤中的按鈕,以上傳新建立的來源檔案

在載入指令碼中手動定義發佈清單

透過檔案上傳新增發佈清單會間接修改應用程式的載入指令碼。或者,直接使用載入指令碼以新增收件者和群組。此為適合進階使用者的選項,若您想要使用資料來源連線提供收件者和群組資訊,這尤其有幫助。

例如,若收件者和群組在外部來源檔案中定義,或者位於資料庫或人力資源系統 (例如 Workday),則此選項允許應用程式中的收件者和群組根據連線的來源進行動態更新。

要求

為了可將指令碼中的欄位辨識為屬於應用程式的發佈清單,您必須將標記套用至對應至發佈清單所需元素的每個所需欄位。請參閱下表瞭解更多資訊。

設定報告篩選條件時的選項
需要標記的欄位所需標記範例
收件者名稱DL_DISTRIBUTION_SVC__recipientNametag field [GetSheetValues.Name] with 'DL_DISTRIBUTION_SVC__recipientName'
收件者電子郵件地址DL_DISTRIBUTION_SVC__recipientEmailtag field [GetSheetValues.Email] with 'DL_DISTRIBUTION_SVC__recipientEmail'
收件者篩選條件DL_DISTRIBUTION_SVC__recipientFilterstag field [GetSheetValues.Filters] with 'DL_DISTRIBUTION_SVC__recipientFilters'
群組名稱DL_DISTRIBUTION_SVC__groupsNametag field [GetSheetValues.Groups] with 'DL_DISTRIBUTION_SVC__groupsName'
群組描述DL_DISTRIBUTION_SVC__groupDescriptiontag field [GetSheetValues.GroupDescription] with 'DL_DISTRIBUTION_SVC__groupDescription'

範例指令碼

以下是連線至收件者和群組的指令碼區段範例:

LIB CONNECT TO 'My_Sample_Connection'; LOAD Name as [GetSheetValues.Name], Email as [GetSheetValues.Email], SubField([Filters],',')AS [GetSheetValues.Filters], SubField([Groups],',') AS [GetSheetValues.Groups]; SELECT Name, Email, Filters, Groups FROM GetSheetValues WITH PROPERTIES ( spreadsheetKey='abc', range='DL_DISTRIBUTION_SVC_USERS_QCS!A1:D100', valueRenderOption='FORMATTED_VALUE', dateTimeRenderOption='FORMATTED_STRING', generatedNumberedColumns='false', skipRows='' ); tag field [GetSheetValues.Name] with 'DL_DISTRIBUTION_SVC__recipientName'; tag field [GetSheetValues.Email] with 'DL_DISTRIBUTION_SVC__recipientEmail'; tag field [GetSheetValues.Filters] with 'DL_DISTRIBUTION_SVC__recipientFilters'; LOAD GroupName as [GetSheetValues.Groups], GroupDescription as [GetSheetValues.GroupDescription]; SELECT GroupName, GroupDescription FROM GetSheetValues WITH PROPERTIES ( spreadsheetKey='abc’, range='DL_DISTRIBUTION_SVC_GROUPS_QCS!A1:B100', valueRenderOption='FORMATTED_VALUE', dateTimeRenderOption='FORMATTED_STRING', generatedNumberedColumns='false', skipRows='' ); tag field [GetSheetValues.Groups] with 'DL_DISTRIBUTION_SVC__groupsName'; tag field [GetSheetValues.GroupDescription] with 'DL_DISTRIBUTION_SVC__groupDescription';

刪除發佈清單

如有需要,您可以從應用程式移除所有收件者和群組。

  1. 開啟收件者群組索引標籤。

  2. 按一下任何收件者或群組旁的 三點功能表,並選取 垃圾桶 全部刪除

資訊備註只有在您已上傳來源檔案作為發佈清單時,以上程序才有用。若您已定義使用替代指令碼工作流程的收件者和群組,您必須從欄位移除標記,以取消將之識別為與發佈清單有關。

表格式報告和區段存取

套用至報告的資料減少取決於來源應用程式是否使用區段存取

任何內部報告收件者 (Qlik Cloud 租用戶中的使用者) 必須可存取應用程式並針對產生並向他們傳送的報告納入區段存取表格中。此外,仍會在區段存取指令碼中根據為該使用者定義的資料存取限制篩選報告輸出中的資料。

若區段存取表格新增至應用程式或從應用程式移除,會自動停用報告任務。這可讓報告開發人員根據發佈清單中的收件者定義,評估是否要繼續進行報告傳遞。

使用 Section Access 管理資料安全性

受管理空間中的發佈清單

對於受管理空間中的應用程式,無法從應用程式的報告區段編輯發佈清單。將應用程式發佈至受管理空間之前,請先上傳模擬發佈清單檔案,或在指令碼中手動參考所需的遠端來源。建議在載入指令碼中使用具有空間意識的語法。換言之,參考資料來源應指向應用程式所在的目前空間。根據您新增發佈清單的方式,可能會自動使用此語法。

提供發佈清單的資料來源包含的參數名稱 (連線、檔案和欄位的名稱),必須與用於來源應用程式載入指令碼的發佈清單來源相同。

您可將發佈清單的實際資料來源上傳至受管理空間。

如需更多資訊,請參閱下列指南:

發佈清單的權限

Qlik Sense 應用程式內管理發佈清單需要特定角色。權限要求因應用程式所在的空間類型而異。

對共用空間中應用程式的要求

下列要求適用於共用空間中的應用程式:

  • 若要在應用程式的報告區段中檢視發佈清單,您需要空間的可以編輯存取權限。

  • 若要編輯、重新上傳並刪除發佈清單,您在空間中必須有可以編輯應用程式中的資料存取權限。

如需詳細資訊,請參閱在共用空間中管理權限

對受管理空間中應用程式的要求

無法在受管理空間中直接設定發佈清單。載入指令碼參考將用來載入發佈清單的資料來源。若要將這些資料來源新增至空間,您在受管理空間中必須有新增和管理資料來源的所需權限。如需進一步資訊,請參閱 在受管理空間中管理權限

如需關於受管理空間中表格式報告的詳細資訊,請參閱 受管理空間中的表格式報告

對個人空間中應用程式的要求

您必須有租用戶中的 Private Analytics Content Creator 使用者角色,以完全掌控發佈清單。

發佈清單限制

  • 您無法在包含收件者和群組名稱以及收件者電子郵件地址的欄位中使用逗號。此限制適用於上傳發佈清單作為檔案,以及在載入指令碼中手動定義。

  • 您最多可以將 1000 個收件者和 1000 個群組新增至應用程式的發佈清單

此頁面是否對您有幫助?

若您發現此頁面或其內容有任何問題——錯字、遺漏步驟或技術錯誤——請告知我們可以如何改善!