Workiva 支援中心

使用Chains ，您可以自動執行例行任務，並輕鬆整合以跨多個記錄系統擷取或傳送資料。例如，您可以創建一個鏈，將財務資訊從資料來源自動提取到表格中，然後將該資料推送到另一個系統以生成報告。在Chain Builder 中，您可以安排和連接任務或命令- 一個鏈應執行的任務。

注意： 只有工作區所有者或鏈所有者 可以訪問Chain Builder 。從 Wdata，按一下Chains ，然後按一下Open Chain Builder 。

透過Get started with tables 和Get started with queries 中的練習，您可以建立類似用於財務報告的表格和查詢。在本練習中，讓我們建立一個鏈來執行該查詢，並將其結果匯出到 Spreadsheets。 

步驟 1.取得查詢的 ID 和參數

如果您還沒有，下載範例資料 並執行開始使用表格 和開始使用查詢 練習，因為您會在鏈中使用查詢。請注意查詢的 ID，這是您在查詢鏈中識別查詢的方式。

注意: 當您在 Wdata 中開啟查詢，其 ID 會出現在 URL 中/queries/ 之後。

如果您使用參數而非靜態值來建立查詢的篩選條件，請同時記下參數的名稱。例如：

• PY或Previous_Year
• CY 或 Current_Year
• Current_Period

步驟 2.建立試算表

在您建立連鎖之前，建立電子表格 ，將查詢結果匯出至此。

為避免試算表被誤用，請在其名稱中清楚辨識其教育目的。

建立試算表後，記下其 URL；您將使用它來確定匯出查詢結果的位置。 

步驟 3. 建立鏈結

現在是建立鏈的時候了！最後，它將包含執行查詢和匯出最新結果至 Spreadsheets 的指令。

在建立連鎖之前，請確認您已設定核心 Workiva 連接器 用於執行其指令。雖然此鏈只需要一個連接器，但鏈可以使用多個連接器在您的不同記錄系統中準備和傳輸資料。

連接器設置完成後，您可以在Chain Builder 中添加鏈：

1. 在 Wdata 中，單擊Chains ,Chain Builder 。
2. 按一下建立,Chains, 然後按一下加入,在右下角建立 Chain。
   

3. 輸入獨特的名稱和描述，以協助識別鏈。

   注意： 鏈結會顯示在 鏈結產生器 中，供工作區中的每個人使用；命名，以便成員清楚了解其用途。有關命名的更多資訊，請參閱 領先實踐：鏈結及其物件的命名約定 。

4. 按一下「儲存」(Save)。

步驟 4.以運行時輸入觸發事件開始

要使鏈在開始時要求其命令所需的變量，添加一個Runtime Inputs 觸發事件 。

提示： 除了運行時輸入，您還可以為鏈或工作區 添加變量。使用變數，您可以擴展鏈的使用，例如使用任何 查詢或試算表，而不是僅使用特定的查詢或試算表。

1. 點選觸發事件 play_for_work ，移至Runtime inputs touch_app 至Start ，並點選Edit 建立 。
2. 在「基本資訊」(Basic Info) 下，輸入唯一的名稱和描述以識別事件。
   

3. 在變數 下 ，為以下項目新增變數：

   • 查詢 ID
   • 任何查詢參數值
   • 電子表格 URL

   提示： 針對每個變數，按一下新增輸入 ，選擇TextField ，並輸入其名稱、描述和預設值。

4. 按一下「儲存」(Save)。

步驟 5.新增執行查詢的指令

接下來，新增Run query 指令，讓連鎖每次執行時取得最新結果。您將使用執行時輸入來識別查詢的 ID 和參數值。

1. 在可用連線 下，選擇Workiva ，然後將執行查詢 拖曳到畫布。

2. 從啟動 拖曳連結到執行查詢 ，然後按一下命令的編輯 。

   注意： 請務必將命令連結至啟動 ，以便它可以使用執行時輸入。

   

3. 在「基本資訊」(Basic Info) 下，輸入唯一的名稱和描述以識別命令。
4. 在命令屬性 下，選擇Workiva 連接器來執行命令。
5. 對於查詢 ID ，在觸發器 下選擇查詢 ID 的執行時間輸入。

6. 如果查詢篩選器使用參數值，請按一下在參數 下新增 (+) ，並輸入它們的 key/value 對：

   關鍵	價值
   PY或Previous_Year	在觸發器 下 ，選擇前一年的運行時間輸入。
   CY 或 Current_Year	在觸發器 下 ，選擇當年的運行時間輸入。
   Current_Period	在觸發器 下 ，選擇當前期間的運行時間輸入。

7. 按一下「儲存」(Save)。

步驟 6.新增匯出結果的指令

現在，新增匯出查詢結果至 Spreadsheets 的指令：

1. 在可用連線器 下，選擇Workiva ，並將Export query result 拖曳到畫布。
2. 從執行查詢 拖曳連結至匯出查詢結果 ，並按一下Edit以取得後者。
   
3. 在「基本資訊」(Basic Info) 下，輸入唯一的名稱和描述以識別命令。
4. 在命令屬性 下 ，選擇與相同的Workiva 連結器 執行查詢 。
5. 對於查詢結果 ID, 選擇ID 以獲得查詢結果 下的輸出執行查詢.
6. 對於試算表網址 ，選擇試算表網址下的運行時間輸入觸發 。
7. 按一下「儲存」(Save)。

步驟 7.運行鏈

執行鏈結：

1. 按一下 發布，然後再次按一下 發布 。
2. 按一下 執行 ，然後按一下 使用輸入執行。
3. 輸入運行時輸入的值，然後按一下Start 。
4. 若要驗證連鎖成功，請檢查查詢結果的試算表。

如果連鎖失敗，請按一下執行歷程中的指令，檢視其記錄中的訊息，以協助排除錯誤。