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

建立寫入表格

您可以在工作表上建立寫入表格,並視需要新增維度、量值和可編輯的欄。在應用程式中建立寫入表格後,有權存取該應用程式以及寫入表格權限的使用者,將能夠變更可編輯的欄。然後可以將變更匯出到外部系統。

建立寫入表格

您可以隨時將註記表格新增至您的工作表。

  1. 在資產面板中,開啟圖表

  2. 視覺化下方,將註記表格拖曳至工作表。

  3. 按一下新增維度,並選取維度或欄位。

  4. 在屬性面板中,於資料之下,按一下開啟新增資料資產功能表,以新增額外的維度與量值欄。下拉式清單隨即開啟。選取下列任一項:

    • 欄位與主項目:開啟可搜尋且顯示每個欄位和主項目的對話方塊。您可以選擇新增任何項目作為維度或量值。
    • 自訂運算式:開啟可以輸入運算式的對話方塊,或開啟運算式編輯器 開啟運算式編輯器
  5. 在屬性面板中,於資料下方點擊開啟新增資料資產功能表,並選取可編輯欄,以新增可編輯欄

  6. 定義表格的一或多個主索引鍵。在寫入表格中,於可編輯欄內,點擊定義,並選取一或多個維度欄作為主索引鍵。

    如需主索引鍵的詳細資訊,請參閱主要索引鍵

  7. 按一下儲存

建立寫入表格後,允許使用者與其互動,並將變更新增至可編輯欄。您也可以透過設定寫入表格的屬性來自訂其外觀。請參閱 設定註記表格屬性

擷取並使用變更

當使用者在可編輯欄中新增資料時,其變更不會套用至應用程式的資料模型。它們也是暫時性的—變更會儲存在Qlik管理的變更儲存區中 90 天,之後會被刪除。

您可以透過變更儲存 API擷取這些變更。這些變更可以用於多種方式,包括:

  • 將變更載入 QVD 或應用程式,以在 Qlik Cloud 中永久儲存和使用。

  • 擷取變更,並將其新增至外部系統,例如 Excel 試算表或 SQL 資料庫。

  • 將資料動態整合到自動化程序中,例如傳送電子郵件和採購庫存。

  • 建置您自己的應用程式,並將對 變更儲存 API 的呼叫整合到您的營運工作流程中。

必要條件

在您存取變更儲存區中儲存的資料之前,您需要能夠存取 變更儲存 API。若要執行此操作,您需要:

可用於擷取變更的工具

您可以使用下列工具從 變更儲存 API 擷取並使用變更:

  • Qlik Automate

  • 適用於 Qlik 指令碼和資料準備的 REST 連接器。

如需範例和使用案例,請參閱:

概念

本區段概述寫入資料表的基本概念。

可編輯的欄

在寫入表格中,可編輯的欄位允許使用者在分析期間即時輸入資料。透過將變更儲存至可編輯的欄位,使用者會將變更寫入變更儲存區,應用程式開發人員和整合人員可以從中擷取這些變更。

如需有關建立可編輯欄位的詳細資訊,請參閱建立寫入表格

新增可編輯欄位後,您可以進一步自訂它以符合您的需求。

  1. 在屬性面板中,在資料下方,按一下可編輯欄位。

    就會開啟欄屬性。

  2. 您可以變更下列任何屬性:

    • 標題:變更預設欄標題。

    • 顯示內容:變更使用者在表格中編輯資料的方式。您可以選擇:

      • 單一選取:指定使用者在編輯時可為每個儲存格選取的一組值。例如,您可以為訂單狀態新增兩個值:準時延遲。使用者在評論資料記錄時,可以從這些值中進行選擇。

      • 手動使用者輸入:使用者透過手動在儲存格中輸入文字來編輯資料。

    • 顯示欄:切換欄是否可見或隱藏。

    • 欄寬:設定欄的寬度。

變更儲存

變更儲存區是Qlik管理的儲存位置,其中包含使用者從寫入資料表中的可編輯欄新增的變更。變更儲存區是暫時的儲存位置—變更最多儲存 90 天,之後會被刪除。

您的寫入資料表的變更儲存區已為您的租用戶預先設定,並可透過變更儲存 API存取。透過您的變更儲存區 ID,您可以制定 API 請求和自動化,將使用者變更同步到永久位置,例如試算表或資料庫。如需詳細資訊,請參閱擷取並使用變更

您可以透過兩種方式複製變更儲存區 ID:

  • 在您建立寫入表格之後,於工作表編輯模式中。在屬性面板中,於變更儲存區變更儲存區 ID下方,按一下複製

    從屬性面板複製變更儲存區 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,用於識別進行此變更的使用者。

List Current Changes From Change Store 區塊位於 Qlik Automate

此區塊也有一個增量變體 List Current Changes From Change Store Incrementally。此變體運作方式如下:

  • 首次執行時,此區塊會擷取所有記錄。

  • 後續執行時,此區塊只會擷取採用相同記錄格式的新增和更新值。
  • 如果記錄中只有單一值已更新,此區塊只會傳回該值 (以及主索引鍵和 updatedAtupdatedBy 參數)。如果相同儲存格在此區塊的兩次執行之間已更新多次,則此區塊只會傳回最終更新 (「目前」值)。

列出變更儲存歷史記錄

List Change Store History區塊使用 API 端點/changes,並傳回每個儲存格的完整歷史記錄。如果儲存格已更新多次,則此區塊將傳回每個值、userId以及updatedAt時間戳記,針對每次更新。

List Change Store History區塊於Qlik Automate

使用 REST 連接器擷取寫入表格變更於Qlik Cloud

權限

若要建立寫入資料表並與 變更儲存 API 互動,您需要特定權限。如需詳細資訊,請參閱註記表格權限

瞭解更多資訊

此頁面是否對您有幫助?

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