CLP - 建立和讀取控制表 – 支援中心

使用控制表是儲存單一工作流程中使用的不同變數的最有效方法。控制表非常有用，它允許最終用戶指定 Chain 的輸入，而無需編輯 Chain 本身。要使用控制表，我們首先需要瞭解如何構建控制表以及如何從控制表中讀取資料。在此 Connected Learning Path 中，我們將設定一個控制表，並使用 Workiva Command 從控制表中擷取資料。

主要業務使用個案	從集中位置協調報表工作流程簡化終端使用者的工作流程管理
主要學習目標	了解如何使用 Chains 結構控制表並從控制表中擷取資料
必要條件	設定Workiva Connector 完成CLP \| 上載資料至資料表路徑完成CLP \| 更新連接清單為相關 Workiva API 授權使用者提供試算表權限
支援範本	CLP \| 從控制表讀取

步驟 1：建立控制表

我們將在建立一個控制表，用來儲存上傳資料到 Wdata Table 的變數，然後為該資料刷新連線。與其在每次 Chain 運行時將這些變數指定為Runtime Inputs ，我們不如將變數添加到控制表中，Chain 會在整個運行過程中讀取和使用這些變數。

雖然此控制表示範將多個檔案上傳至單一 Wdata 表，並在單一試算表上刷新連線，但只需將表或試算表的唯一 ID 添加至控制表，即可將此流程擴展至包含多個表和試算表。

導航至 Workiva 平台以建立新的試算表
按一下建立並選擇試算表
命名試算表：CLP 控制工作表
- 命名第一個工作表：主要控制工作表
在主要控制工作表中，建立下列標頭
- ActiveFlag
  - 此列指定工作流程是否需要針對控制工作表中的該行執行
- 檔案名稱
  - 這一列表示資料集的名稱，因為它會顯示在 Wdata 表中
- 表 ID
  - Wdata 中將上載資料的表的 ID
- SpreadsheetID
  - 將刷新資料的試算表 ID
- FileLocation
  - 下載檔案的位置
在工作表中填入下列值，在<TableID> 列 中填入 CLP Employee Detail Table 的ID，在<SpreadsheetID> 列 中填入 CLP Employee Overview Spreadsheet 的ID ，這些 ID 是在以前的 Connected Learning Paths 中建立的，請參閱先決條件，查看所需的 Connected Learning Paths。

請參閱此文件以協助尋找 ID

ActiveFlag,FileName,TableID,FileLocation
TRUE,EmployeeDetailsP01,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P01.csv
TRUE,EmployeeDetailsP02,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P02.csv
TRUE,EmployeeDetailsP03,<TableID>,<SpreadsheetID>,, https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P03.csv

步驟 2：更新試算表權限

為確保 Workiva 指令與試算表之間的有效溝通，所產生的API 授權必須與擁有試算表擁有者或編輯權限的使用者相關聯。

從CLP 控制表 試算表，按一下上方功能區中的檔案。
按一下Permissions ，然後按試算表
- 在 Workiva 連接中，為與配置的 API 授權相關聯的 Workiva 用戶提供訪問權限。

image (7).png

步驟 3：建立一個 Chain

要使用在控制工作表中建立的變數，我們將建立一個 Chain 來讀取它。由於我們會一直使用相同的試算表和工作表，因此我們會設定 Chain 變數來儲存這些詳細資料，以便一致存取。

導覽至 Chain Builder
建立新的連鎖
- 命名鏈： CLP | 從控制表讀取
在連鎖變數下，按兩下正符號，以建立兩個連鎖變數，並將其設定如下：
- 變數 1：
  - 類型：鏈式可變 (cv)
  - 名稱：cv-控制試算表 ID
  - 值：輸入 CLP 控制試算表的ID
    - 若要尋找試算表 ID，請導航至CLP 控制清單試算表
      - 在 URL 中，選擇「試算表 ID」，該 ID 位於「試算表/」之後、「/試算表」之前
      - 例如，試算表 ID 在此以粗體標示： app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
- 變數 2：
  - 類型：鏈式可變 (cv)
  - 名稱:cv-控制表名稱
  - 值：主要控制表
儲存連鎖

步驟 4：取得工作表資料

我們使用 Get Sheet Data 指令啟動 Chain。這可讓我們從控制工作表擷取資訊，並輸入至 Chain。

從Workiva Connector 新增Get Sheet Data 指令至 Chain 啟始區域。
按兩下指令進行設定
- 按一下試算表 ID 欄位
  - 在Select a Variable 面板內，按一下向下箭頭以展開Chain
  - 選擇cv-Control 試算表 ID 鍊變數
- 按一下工作表 ID/名稱欄位
  - 在Select a Variable 面板內，按一下向下箭頭以展開Chain
  - 選擇cv-Control Sheet Name Chain 變數
- 區域：可隨意指定一個區域。如果保留為":"，該命令將擷取整個試算表中的資料。
儲存指令