Workiva 支援中心

使用 Workiva 連接器，您可以在鏈中使用命令 與 Workiva 平台互動，包括其他 Wdata 功能、Spreadsheets 和 GraphDB。例如，使用此連接器，您可以

• 建立和管理資料表、查詢和檢視
• 列出表的資料集或匯入錯誤
• 建立和管理試算表或其工作表
• 管理記錄和報告

要求

要與 Workiva 平台互動，連接器使用the Workiva REST APIs 。要設定連接器，您需要：：

• 具有 OAuth2 授權 [] 的專用 Workiva 整合使用者。

  注意： 此整合使用者需要連接器執行命令的適當權限，例如與之互動的試算表或工作區的擁有者。

• 整合使用者的 OAuth2 授權 ID 和密碼。
• 若要在測試環境中執行鏈結，請使用 URL 覆寫 API 的主機和基準路徑。

注意： 雖然工作區的擁有者可以存取使用連接器的鏈，但連接器本身需要專用的整合使用者才能執行其指令。使用專用的整合使用者，而非合作者的使用者帳戶，可讓您追蹤連接器的活動，並限制其存取權限，僅限於執行指令所需的權限。

設定 Workiva 連接器

1. 從Chains（自動化工作流程）建立器 ，按一下Connections compare_arrows ，然後按右上方的Create 。
2. 在Create Connection 下 ，選擇Workiva 和預設 CloudRunner。
   
3. 在Basic Info 下，輸入唯一的名稱和描述以協助識別連線器。

4. 在 Resources下，選取要與此連線關聯的資源。
   此部分提供連接器運作所需的任何檔案 (指令碼、安全性權杖、憑證等) 的安全位置，例如身份驗證或環境要求。儲存連結時，這些檔案會自動進行 AES-256 加密。有關更多資訊，請參閱 Workiva 鏈結產生器安全性架構 支援頁面。

   優點：

   • 安全儲存： 因為這些檔案在儲存時已加密並儲存在連線層級，因此它們非常適合用於不應硬編碼至鏈結本身的敏感或靜態配置資料。
   • 可移植性： 如果您將鏈結從「測試」工作區移至「生產」工作區，資源將與連線設定保持綁定，這意味著您不必重寫鏈結節點中的文件路徑。
   • 協助工具： 將檔案儲存在這裡，即可供 Runner (執行工作的代理程式) 使用，而無需手動將檔案置於 Runner 的實體主機上。

   缺點：

   • 由於已加密，因此無法直接編輯；您必須刪除檔案並上傳變更後的版本。

5. 在「屬性」(Properties) 下，輸入連結的詳細資料：
   

   摘要資訊	詳細資料
   ID	輸入整合使用者 OAuth 授權的 ID。
   密碼	輸入ID 屬性的秘密。
   Cerebral Host Override	若要覆寫的 Wdata 端點 的 URL 主機和基本路徑，例如用於測試環境，請輸入要替代使用的 URL。
   試算表主機覆寫	要覆寫Spreadsheets 端點 的 URL 主機和基本路徑，例如測試環境，請輸入要使用的 URL。
   覆寫 IAM 主機	要覆寫識別和存取管理 (IAM) 端點 的 URL 主機和基本路徑，例如用於測試環境，請輸入要替代使用的 URL。
   管理主機覆寫	若要覆寫管理端點 的 URL 主機和基本路徑，例如測試環境，請輸入要取代使用的 URL。
   覆寫 GraphDB 主機	要覆寫 GraphDB 端點的 URL 主機和基本路徑，例如用於測試環境，請輸入要使用的 URL。
   平台 API 主機覆寫	要覆寫的 URL 主機和基本路徑，Workiva 平台端點 ，如用於測試環境，請輸入要替代使用的 URL。

   注意： 所有敏感認證都會自動使用 AES-256 加密進行加密和儲存。

6. 請選取要使用連結的環境，然後按一下「儲存」(Save)。
7. 若要測試連線，使用連接器的List Files 指令 建立並執行連線 ，並驗證它是否傳回有效的輸出。

URL 覆寫

根據您生產環境的區域，可能需要覆寫 URL。  您可以比較登入 Wdesk 使用的 URL 來驗證。  如果 URL 包含EU 或APAC ，則需要覆寫。

備註： 美國地區資訊已列出，以供參考。

疑難排解

如果與 Workiva 平台的連線失敗：

• 驗證連接器的應用程式 OAuth 認證是否存在、正確且有效。OAuth 認證有定義的到期日，而憑證可能已過期。如果是這種情況，您需要建立新的憑證，並在 Connector 中輸入新的用戶端秘密。 
• 確保整合使用者擁有執行中指令的適當權限。
• 如果使用主機覆寫，請檢查為連接器輸入的 URL 是否正確。

• 驗證互動的 Workiva 檔案（例如表格、查詢或試算表）的 ID 是否正確。

  註： 在 Workiva 中開啟時，檔案的 ID 會出現在其 URL 中。例如，電子表格的 ID 會出現在其 URL 中spreadsheet/ 之後；表格的 ID 會出現在tables/ 之後。