透過 BlackLine® OAuth2 連接器,您可以在連鎖中使用指令 與 BlackLine 進行互動,例如:列出並從 BlackLine 下載報告:
- 列出並從 BlackLine 下載報告
- 匯入和管理 BlackLine 中的資料,包括
- 帳戶
- 餘額
- 貨幣匯率
- 分類帳
- 實體
- 任務
- 使用者
註: 此連接器由 Workiva 建立並連接至第三方系統。雖然我們的支援團隊可協助您在工作區內設定此連接器,但我們無法排除故障或協助解決任何源自 Workiva 平台以外的問題。
先決條件
若要設定連接器,您需要
- 要連線至的 BlackLine 虛擬主機名稱,例如:
sbus2.api.blackline.com - 為 BlackLine 服務帳戶設定的整合使用者的使用者名稱和 API 金鑰
注意: 整合使用者需要 API 授權角色和整合權限,以及連接器將執行的任務所需的角色和範圍。若要在 BlackLine 中建立 API 金鑰,請按一下Generate forAPI Key underUser Information on the integration user's details。
- 僅支援 Blackline API 2.0 版本
- 整合使用者的客戶端憑證和 OAuth 範圍,由您的 BlackLine 整合團隊提供
備註: 如果您需要客戶端 ID、客戶端密碼或範圍,請聯絡您的 BlackLine 代表。
設定 BlackLine OAuth2 連接器
注意:為了使連接器可用於組織的鏈結,組織安全性管理員首先要從組態中啟用它。
- 在「鏈結產生器」中,按一下「連線」,然後按一下右上角的「建立」。
- 在Connector Connection 下 ,選擇BlackLine OAuth2 和預設 CloudRunner。
- 輸入唯一的名稱和描述以協助識別連線。
- 在「屬性」(Properties) 下,輸入連結的詳細資料:
摘要資訊 詳細資料 使用者名稱 輸入 BlackLine 整合使用者的使用者名稱。 密碼 輸入為 BlackLine 整合使用者產生的 API 金鑰。 備註: 若要在 BlackLine 中建立或更新 API 金鑰,請按一下Generate forAPI Key User Information 下的 Integration user's details。這是而非 用於線上登入 BlackLine 的密碼。
用戶端 ID 輸入 BlackLine 整合團隊提供的用戶端 ID。 用戶端密碼 輸入 BlackLine 整合團隊提供的用戶端秘密。 範圍 輸入 BlackLine 整合團隊提供的整合使用者 OAuth 範圍。連接器將使用這些相同的權限。 實例主機名稱 輸入要連接的 BlackLine 實例的主機名稱,,不含 https://。例如,對於預設開發環境,sbus2.api.blackline.com。注意:所有敏感認證都會自動加密並以進階加密標準 (AES)-256 加密方式儲存。
- 請選取要使用連結的環境,然後按一下「儲存」(Save)。
- 若要測試連線,請建立並執行連線 與BlackLine OAuth2 連接器的 List Reports 指令 ,並驗證其是否傳回有效的輸出。
疑難排解
如果與 BlackLine 的連接失敗:
- 驗證 BlackLine 整合團隊提供的用戶端憑證和 OAuth 範圍。如果您需要 OAuth 範圍或用戶端 ID 或密碼,請聯絡您的 BlackLine 代表。
- 確保整合使用者的使用者名稱和 API 金鑰正確無誤。
注意: 整合使用者的 API 金鑰可能會過期。若要在 BlackLine 中刷新 API 金鑰,請按一下Generate forAPI Key 下User Information 上的整合使用者詳細資訊。
- 確認整合使用者擁有 API 授權和適當的角色及範圍,以執行與連線指令相關的任務。
- 確認已為連接器輸入正確的 BlackLine 實例主機名稱。