Workiva 支援中心

想要連接 Workiva 預建 Premium 連接器以外的第三方應用程式？您可以透過利用 HTTP 請求連接器命令 與 REST API 互動來實現此目的。 

注意： 雖然這標記為 HTTP 要求，但它支援（且建議使用）HTTPS（安全 HTTP）。

在此連接/串連學習流程中，我們將更新我們的 Chains（自動化工作流程）以使用 Runtime Inputs，其中我們可以指定我們想要擷取的試算表。

第 1 級距：複製並修改 Chains（自動化工作流程）。

1. 巡覽至鏈結產生器並找到鏈結 CLP | HTTP 要求清單試算表。
2. 按一下垂直橢圓形以 復制 鏈結。
3. 按一下鉛筆圖示編輯 Chains（自動化工作流程）。
4. 按一下右上角的 「鏈結設定」(Chain Settings) ，然後將鏈結重新命名： CLP | HTTP 要求取得單一試算表。
5. （可選）輸入 說明：「此鏈結會產生新的 Workiva API 存取權杖。您必須在下面的變數值中提供上一步/上一個有效的 Client ID 與先前產生的 API 授權中的 Client Secret。執行 Chains（自動化工作流程）時，會提示使用者輸入試算表 ID。 Chains（自動化工作流程）將擷取試算表"。
6. 儲存 鏈結。

步驟 2：運行時輸入

使用 執行階段輸入鏈結事件 啟動鏈結。
這可讓我們指定想要取得的試算表的試算表 ID。閱讀更多關於 Runtime Inputs 的資訊。

1. 將 POST - Retrieve a Token 命令移出起始節點。
2. 將 鏈結觸發事件 中的 執行階段輸入 鏈結事件新增至開始節點。
3. 按兩下將聯結 執行階段輸入 與 「取得 - 列出試算表」 命令的連結，然後 刪除 連結。
4. 將 執行階段輸入 連結至 POST - Retrieve a Token 命令。

5. 將 POST - Retrieve a Token 命令連接至 GET - List Spreadsheets 命令。

   

6. 按兩下「 執行階段輸入 鏈結事件」以進行配置。
7. 按一下 「新增輸入」(Add Input) 並設定以下欄位：
   • 類型： 文字欄位
   • 顯示名稱： 試算表 ID - 請查看 此文件 以獲取尋找 ID 的說明
   • 必要： 勾選此核取方塊
8. （可選）輸入 說明：「此命令允許使用者指定所需的執行階段輸入值。」
9. 儲存 命令。

步驟 3：更新 Get 指令

我們將更新 HTTP Request Get 命令，以提供單一試算表的詳細資訊，而非列出工作區中的所有試算表。

1. 按兩下「 取得 - 試算表清單」 命令以進行設定。
   1. 將命令命名為： Get - Retrieve a Single Spreadsheet。

   2. 使用 URL 欄位中來自執行階段輸入的 「試算表 ID」 變數，以指定要擷取的試算表。
      若要這樣做，請按一下 URL 欄位，然後在 /spreadsheets 後新增「/< Spreadsheet ID >」，取代
      <Spreadsheet ID> 使用來自 執行階段輸入的 變數，如下所示：

      

      1. 在左側面板中，展開 「觸發程序」 下拉式清單。
      2. 展開 Runtime Inputs 下拉式選單。
      3. 選取 Spreadsheet ID 變數。

2. （可選）輸入 說明：「此命令傳回一個單一試算表。有關更多資訊，請參閱開發人員說明文件，網址為 https://developers.workiva.com/2026-01-01/getspreadsheetbyid.html。」
3. 儲存 命令。

步驟 4：測試練習

現在 Chain 已經完成，我們可以測試結果。

1. 發布 鏈結。
2. 按一下 「執行」(Execute)，然後 按一下「使用輸入執行」(Run with Inputs)。
3. 尋找 試算表 ID，導覽至 Workiva 平台中的試算表。 確保授權用戶擁有此試算表的權限。
4. 按一下 「開始」(Start)。
5. 鏈結完成執行後，您可以在 「輸出」(Outputs) 索引標籤 - 取得 命令的 「回應」(Response Body)中看到已產生試算表詳細資訊。