Workiva Chains 连接器为工作空间、环境和链提供常用命令。這包括用於檢索屬性、鏈運行詳情、登入活動事件等的 list 和 get 命令。
如需完整的相容命令清單,請參閱Workiva Chains 命令 文章。
要求
使用連接器之前:
- 組織安全管理員必須透過 Configurations 畫面啟用 Workiva Chains 連結器 。
- 要在測試環境中執行連鎖,您需要 URL 來覆寫 API 的主機和基本路徑。
- 您必須在您的軟體中建立專屬的整合使用者 與及 OAuth2 授權 。
- 要查找您的鏈 ID,請查看在 Workiva 中查找 ID 這篇文章 。
整合使用者的其他需求
雖然所有工作區擁有者都可以存取使用連接器的鏈,但連接器本身需要專用的整合使用者才能執行其指令。使用專用的整合使用者,而非合作者的使用者帳戶,可讓您追蹤連接器的活動,並限制其存取權限,僅限於執行指令所需的權限。
設定整合使用者時必須注意以下事項:
- 您必須知道整合使用者的 OAuth2 授權 ID 和密碼。
- 您必須為集成用戶提供適當的權限,以執行連接器將執行的每個命令;例如,他們可能是電子表格或連接器互動工作區的擁有者。
- 集成用戶在執行任何命令之前必須登錄 Chain Builder。這是建立使用者帳戶的必要步驟。
連線設定
要設定 Workiva Chains 連接器:
- 在「鏈結產生器」中,按一下「連線」,然後按一下右上角的「建立」。
- 在Connector Connection 下 ,選擇Workiva Chains 和預設 CloudRunner。
- 在Basic Info 下 ,輸入唯一的名稱和描述,以協助識別連線器。
- 在「屬性」(Properties) 下,輸入連結的詳細資料:
摘要資訊 詳細資料 基底 URL 基本 URL;預設為 https://h.app.wdesk.com/s/wdata/oc/api/ ID 輸入整合使用者 OAuth 授權的 ID。 密碼 輸入ID 屬性的秘密。 IAM 主機覆寫 要覆寫識別和存取管理 (IAM) 端點 的 URL 主機和基本路徑,例如用於測試環境,請輸入要替代使用的 URL。 - 請選取要使用連結的環境,然後按一下「儲存」(Save)。
URL 覆寫
根據您生產環境的區域,可能需要覆寫 URL。 您可以比較登入 Wdesk 使用的 URL 來驗證。 如果 URL 包含EU 或APAC ,則需要覆寫。
備註: 美國地區資訊已列出,以供參考。
| 欄位 | 價值 |
|---|---|
| Cerebral Host Override | https://h.app.wdesk.com/s/cerebral |
| 試算表主機覆寫 | https://api.app.wdesk.com/spreadsheets/v1/ |
| IAM 主機覆寫 | https://api.app.wdesk.com/iam/v1/oauth2/token |
| 管理主機覆寫 | https://api.app.wdesk.com/admin/v1 |
| Graph DB 主機覆寫 | https://api.app.wdesk.com/graphdb/v1/ |
| 平台 API 主機覆寫 | https://api.app.wdesk.com/platform/v1 |
| 欄位 | 價值 |
|---|---|
| Cerebral Host Override | https://h.eu.wdesk.com/s/cerebral |
| 試算表主機覆寫 | https://api.eu.wdesk.com/spreadsheets/v1/ |
| IAM 主機覆寫 | https://api.eu.wdesk.com/iam/v1/oauth2/token |
| 管理主機覆寫 | https://api.eu.wdesk.com/admin/v1 |
| 圖形資料庫主機覆寫 | https://api.eu.wdesk.com/graphdb/v1/ |
| 平台 API 主機覆寫 | https://api.eu.wdesk.com/platform/v1 |
| 欄位 | 價值 |
|---|---|
| Cerebral Host Override | https://h.apac.wdesk.com/s/cerebral |
| 試算表主機覆寫 | https://api.apac.wdesk.com/spreadsheets/v1/ |
| IAM 主機覆寫 | https://api.apac.wdesk.com/iam/v1/oauth2/token |
| 管理主機覆寫 | https://api.apac.wdesk.com/admin/v1 |
| Graph DB 主機覆寫 | https://api.apac.wdesk.com/graphdb/v1/ |
| 平台 API 主機覆寫 | https://api.apac.wdesk.com/platform/v1 |