想要連接 Workiva 預建 Premium 連接器以外的第三方應用程式？您可以利用HTTP Request Connector Commands 來與 REST API 進行互動。
附註： 雖然標籤為 HTTP 請求，但支援 HTTPS (安全 HTTP)（並建議使用）。
在此連接/串連學習流程中，我們將更新我們的 Chains（自動化工作流程）以使用 Runtime Inputs，其中我們可以指定我們想要擷取的試算表。
| 主要業務使用個案 | 連接/串連第三方系統 |
| 主要學習目標 | 利用 Workiva 的 HTTP Request Connector Commands 與預建連接器以外的第三方應用程式的 REST API 進行互動。更新 Chains（自動化工作流程）以使用 Runtime Inputs 來指定要使用的試算表。 |
| 次要學習目標 | 使用運行時輸入 |
| 必要條件 | |
| 支援範本 | CLP | HTTP 要求者取得單一試算表 |
第 1 級距：複製並修改 Chains（自動化工作流程）。
- 導航至 Chains（自動化工作流程）建立器，並找到 ChainsCLP | HTTP Request List Spreadsheets 。
- 按一下垂直橢圓以複製 鏈結。
- 按一下鉛筆圖示編輯 Chains（自動化工作流程）。
- 點選右上方Chains 設定 ，重新命名 Chains：CLP | HTTP Request Get a Single Spreadsheet 。
- (選項) 輸入一個描述 ："此鏈結（自動化工作流程）產生一個新的 Workiva API Access Token。您必須在下面的變數值中提供上一步/上一個有效的 Client ID 與先前產生的 API 授權中的 Client Secret。執行 Chains（自動化工作流程）時，會提示使用者輸入試算表 ID。 Chains（自動化工作流程）將擷取試算表"。
- 保存 鏈條。
步驟 2：運行時輸入
使用Runtime Inputs Chains（自動化工作流程）事件 來啟動 Chains。
這可讓我們指定想要取得的試算表的試算表 ID。閱讀更多關於 Runtime Inputs 的資訊。
- 將POST - Retrieve a Token命令移至起始節點之外。
- 從Chain Trigger Events 新增一個Runtime Inputs Chain Event 到 Start Node。
- 雙擊連接Runtime Inputs 到Get - List Spreadsheets 命令的連結，並刪除連結。
- 連接Runtime Inputs 至POST - Retrieve a Token 命令。
-
連接POST - Retrieve a Token 命令到GET - List Spreadsheets 命令。
- 雙擊Runtime Inputs Chains（自動化工作流程）來組態它。
- 點選新增輸入 ，然後組態以下欄位：
- 鍵入類型： 文字欄位
- 顯示名稱： 試算表 ID - 請查閱此文件 以協助尋找 ID
- 必填： 記號此複選框
- (選項) 輸入說明 ：「此命令允許使用者指定所需運行時輸入的值」。
- 儲存指令。
步驟 3：更新 Get 指令
我們將更新 HTTP Request Get 命令，以提供單一試算表的詳細資訊，而非列出工作區中的所有試算表。
- 在Get - List of Spreadsheets 命令上按兩下以進行組態配置。
- 命名命令名稱：Get - 擷取單一試算表 。
-
在 URL 欄位內使用試算表 ID 來自 Runtime Inputs 的變數，指定要擷取的試算表。
為此，點選URL 欄位，並在/spreadsheet 後新增 "/<>",
，取代<Spreadsheet> ，變數來自Runtime Inputs ，如下所示：- 在左側面板中，展開觸發程序 下拉式 (清單)。
- 展開Runtime Inputs 下拉式 (清單)。
- 選擇試算表 ID 變數。
- (選項) 輸入一個描述 ："This command returns a single Spreadsheet.此命令傳回單一試算表。如需詳細資訊，請參閱 https://developers.workiva.com/platform-v1/platform-getspreadsheetbyid/ 的開發人員說明文件"
- 儲存指令。
步驟 4：測試練習
現在 Chain 已經完成，我們可以測試結果。
- 發表鏈結。
- 按一下Execute, 然後按Run with Inputs 。
- 尋找試算表 ID ，方法是在 Workiva 平台中巡 覽至試算表。 確保授權用戶擁有此試算表的權限。
- 按一下啟動 。
- 一旦 Chains（自動化工作流程）執行完成，您可以看到試算表詳細資訊已在Get 指令的Outputs索引標籤 -Response Body 中產生。
To continue to challenge yourself and learn more about using the HTTP Request Connector to connect to a third party API, check out the next exercise CLP Copy a Spreadsheet (add link when document created).
-->