建立註記表格
您可以在工作表上建立註記表格,並視需要新增維度、量值和可編輯的欄。在應用程式中建立註記表格後,具有該應用程式存取權限以及註記表格權限的使用者將能夠對可編輯的欄進行變更。然後可以將變更匯出到外部系統。
建立註記表格
您可以隨時將註記表格新增至您的工作表。
請執行下列動作:
-
在資產面板中,開啟圖表。
-
在 視覺化 下,將 註記表格 拖曳至工作表。
-
按一下新增維度,並選取維度或欄位。
-
在屬性面板的 資料 下按一下
,以新增額外的維度和量值欄。下拉式選單會開啟。選取下列任一項:
- 欄位與主項目:開啟可搜尋的對話方塊,顯示每個欄位和主項目。您可以選擇將任何項目新增為維度或量值。
- 自訂運算式:開啟對話方塊,您可以在其中輸入運算式,或開啟運算式編輯器
。
-
在屬性面板的 資料 下按一下
,然後選取 可編輯的欄,以新增可編輯的欄。
-
定義表格的一個或多個主索引鍵。在註記表格中,於可編輯的欄內,按一下 定義,然後選取一個或多個維度欄作為主索引鍵。
如需有關主索引鍵的詳細資訊,請參閱 主索引鍵。
-
按一下 儲存。
建立註記表格後,允許使用者與其互動並將變更新增至可編輯的欄。您也可以透過設定其屬性並將其合併到自訂佈景主題中,來自訂註記表格的外觀。請參閱:
擷取並使用變更
當使用者在可編輯的欄中新增資料時,他們的變更不會套用至應用程式的資料模型。這些變更也是暫時的—變更會儲存在由 Qlik 管理的變更存放區中 90 天,之後將被刪除。
您可以透過 變更儲存 API 擷取這些變更。這些變更可以透過多種方式使用,包括:
-
將變更載入 QVD 或應用程式中,以便在 Qlik Cloud 內永久儲存和使用。
-
擷取變更,將其新增至外部系統,例如 Excel 試算表或 SQL 資料庫。
-
將資料動態整合到自動化流程中,例如傳送電子郵件和採購庫存。
-
建置您自己的應用程式,並將對 變更儲存 API 的呼叫整合到您的作業工作流程中。
先決條件
在存取儲存於變更存放區中的資料之前,您需要能夠存取 變更儲存 API。為此,您需要:
-
Qlik Cloud 租用戶的 API 金鑰。請參閱 管理 API 金鑰。
-
使用註記表格所需的權限,由租用戶管理員指派。請參閱:
-
變更存放區 ID。這可以在工作表上建立註記表格後擷取。請參閱 變更存放區。
用於擷取變更的可用工具
您可以使用下列工具從 變更儲存 API 擷取並使用變更:
-
Qlik Automate
-
Qlik 指令碼和資料準備中可用的 REST 連接器。
如需範例和使用案例,請參閱:
概念
本區段提供註記表格基本概念的概述。
可編輯的欄
在註記表格中,可編輯的欄允許使用者在分析期間即時輸入資料。透過將變更儲存至可編輯的欄,使用者會將變更寫入變更存放區,應用程式開發人員和整合者可以從中擷取這些變更。
如需有關在何處建立可編輯的欄的詳細資訊,請參閱 建立註記表格。
新增可編輯的欄後,您可以透過下列方式進一步自訂以符合您的需求:
-
變更 資料 下的互動式設定。請參閱 管理可編輯的欄的互動式設定。
-
在
樣式 面板中設定可編輯的欄的樣式。請參閱 設定可編輯欄的樣式。
管理可編輯的欄的互動式設定
請執行下列動作:
-
在屬性面板的 資料 下,按一下可編輯的欄。
欄屬性會開啟。
-
您可以變更下列任何屬性:
-
標題:變更預設的欄標題。
-
顯示內容:變更使用者在表格中編輯資料的方式。您可以選擇:
-
單一選取:指定一組值,供使用者在編輯時為每個儲存格選取。例如,您可以為訂單狀態新增兩個值:如期 和 延遲。然後,使用者在對資料記錄進行註解時,可以在這些值之間進行選取。
對於單一選取,您可以使用固定值或動態值:
-
固定:透過在輸入方塊中輸入來手動定義值。這些值是靜態的,不會隨著應用程式資料而變更。
-
動態:使用運算式來定義可根據運算式的值而變更的輸入值。例如,您可以將值連結至資料模型欄位,或連結至應用程式變數。您可以指定值和標籤,或僅指定值。
如需有關在視覺化中使用運算式的詳細資訊,請參閱 在視覺化中使用運算式。提示備註語法:
使用 | 分隔值,並使用 ~ 分隔值和標籤,如下所示:value1|value2 或 value1~label1|value2~label2。
資訊備註最多支援 1000 個值。超過限制的值將被忽略。
-
-
手動使用者輸入:使用者透過在儲存格中手動輸入文字來編輯資料。
-
-
顯示欄:切換欄為可見或隱藏。
-
欄寬:設定欄的寬度。
-
變更存放區
變更存放區是由 Qlik 管理的儲存位置,其中包含使用者從註記表格中的可編輯的欄新增的變更。變更存放區是暫時的儲存位置—變更最多儲存 90 天,之後將被刪除。
您的註記表格的變更存放區已為您的租用戶預先設定,並可透過 變更儲存 API 存取。使用您的變更存放區 ID,您可以制定 API 請求和自動化,將使用者變更同步到永久位置,例如試算表或資料庫。如需詳細資訊,請參閱 擷取並使用變更。
您可以透過兩種方式複製變更存放區 ID:
-
在建立註記表格後的工作表編輯模式中。在屬性面板的 變更存放區> 變更存放區 ID 下,按一下
。
從屬性面板複製變更存放區 ID。

-
在檢視註記表格時的分析模式中。按一下右下角的
圖示。按一下
以複製變更存放區 ID。
在檢視註記表格時複製變更存放區 ID。

主索引鍵
若要將可編輯的欄新增至註記表格,您需要定義至少一個主索引鍵。
主索引鍵是用於將可編輯的欄的變更連結回資料模型中原始資料的欄位。主索引鍵提供註記表格中的記錄 (代表來自資料模型的資料) 與使用者在可編輯的欄中引入的編輯之間的對應。
主索引鍵可以是單一欄位,也可以是跨越多個欄位的複合索引鍵。
在註記表格中定義主索引鍵後,您可以隨時變更它們。在屬性面板的 變更存放區 > 主索引鍵 下,按一下 修改。
當您從 變更儲存 API 提取變更時,主索引鍵也很重要。
使用 Qlik Cloud 工具從註記表格擷取變更
使用 Qlik Automate 擷取註記表格變更
儲存在變更存放區中的變更可以透過使用 Qlik Automate 中 Qlik Cloud Services 連接器內的 Change Store 區塊來擷取。此連接器會自動連線至自動化擁有者的 Qlik 帳戶,因此不需要額外的步驟來進行驗證。
有關 Qlik Automate 的詳細資訊,請參閱 Qlik Automate。
用於擷取註記表格變更的可用 Qlik Automate 區塊

列出變更存放區的目前變更
List Current Changes From Change Store 區塊使用 API 端點 /changes/tabular-views,並且只會傳回每個儲存格的最新值 (換句話說,它會傳回目前的值)。它會將這些值作為物件清單傳回,其中每個物件都包含主索引鍵和變更值。每筆記錄也會擴充一個 updatedAt 時間戳記 (表示最後一次更新記錄的日期時間) 以及一個 updatedBy 使用者 ID (表示進行此變更的使用者)。
Qlik Automate 中的 List Current Changes From Change Store 區塊

列出變更存放區歷程記錄
List Change Store History 區塊使用 API 端點 /changes,並傳回每個儲存格的完整歷程記錄。如果儲存格已更新多次,則此區塊將傳回每次更新的每個值、userId 和 updatedAt 時間戳記。
Qlik Automate 中的 List Change Store History 區塊

使用範本
如果您要將資料擷取到 MySQL 資料庫,您也可以從自動化範本開始。Insights to Action 下提供下列範本:
-
Extract Change Store Data to a MySQL Database
-
Extract Change Store Data to a MySQL Database in Bulk
這些範本將 Change Store 區塊 (如上所述) 與其他區塊排列在一起,以協助您更快地擷取資料。只需調整區塊參數以連線至您的資源。如需詳細的逐步解說,請參閱這篇社群文章。
權限
若要建立註記表格並與 變更儲存 API 互動,您需要特定權限。如需詳細資訊,請參閱 註記表格權限。