Workiva 支援中心

使用 NetSuite® Token Authentication 連接器，您可以使用連鎖命令 與 NetSuite 互動。例如，透過此連接器，您可以

• 從 NetSuite 下載檔案
• 列出 NetSuite 中已儲存的搜尋
• 擷取標準 NetSuite 記錄或已儲存搜尋的相關資料

註: 此連接器由 Workiva 建立並連接至第三方系統。雖然我們的支援團隊可協助您在工作區內設定此連接器，但我們無法排除故障或協助解決任何源自 Workiva 平台以外的問題。

必要條件

要啟用連接，連接器使用 NetSuite REST API。若要設定連接器，您需要

• NetSuite，啟用基於令牌的驗證 (TBA)
• 要連接到

  的 NetSuite 帳戶的 ID 注意： 要在 NetSuite 中查看您的帳戶 ID，請選擇設置,整合,Web 服務偏好 。ID 通常也會出現在 URL 的第一個字串中，就在app.netsuite.com 之前。

• 在 NetSuite 中為連接器建立的整合記錄 和存取令牌
• 整合記錄的消費者密碼鑰匙

  注意： 如果您沒有消費者密碼或鑰匙，請編輯整合記錄並重設其憑證。

• 存取標記的 ID 和密碼。如果您沒有存取權標的 ID 或密碼，您需要建立新的權標。

注意： 要使用 OAuth 2.0 認證與 NetSuite RESTlet 進行互動，請使用HTTP Request connector 。

在 NetSuite 中啟用整合

要啟用連接器與 NetSuite 互動，它需要基於令牌的驗證 (TBA) 和它自己的整合記錄。

步驟 1.啟用 SOAP 網頁服務和令牌式驗證

為 NetSuite 啟用 SOAP 網頁服務和 TBA：

1. 在 NetSuite 中，選擇Setup,Company,Enable features 。
2. 在SuiteCloud選項卡上，在SuiteScript 下，選擇Client SuiteScript 和Server SuiteScript 。
   
3. 在SuiteTalk (Web Services) 下 ，選 擇SOAP Web services 。
   
4. 在Manage authentication 下 ，選擇Token-based authentication 。
5. 按一下「儲存」(Save)。

步驟 2.建立整合記錄

啟用 TBA 後，為連接器建立整合記錄 ：

1. 在 NetSuite 中，選擇設定,整合,管理整合,新增 。
2. 為幫助識別整合，請輸入唯一的名稱和描述，如 Workiva Integration。
   
3. 在驗證下 ，選擇以 令牌為基礎的驗證 ，並清除TBA：授權流程 。
4. 按一下儲存 ，並從確認頁面中記錄用戶金鑰和密碼。

注意： 用戶金鑰和密碼會出現在，只有 會出現在整合記錄的確認頁面。請務必在連線器的屬性中記錄這些值，並將它們視為密碼。

步驟 3.建立整合角色

為了安全起見，請在 NetSuite 中建立專用角色來管理您的整合：

1. 選擇設定,使用者/角色,管理角色,新增 。
   
2. 在General 下 ，輸入唯一的名稱以協助識別角色，例如 Workiva/NetSuite Integration。
3. 在Authentication 下 ，選擇Web services only role，使該角色僅能連接 NetSuite API，而不能 直接登入 NetSuite。
4. 在Permissions 下 ，添加權限 以啟用整合，如 NetSuite 中所有相關Transactions 、Reports 和Lists 的 Full-level 權限。
5. 在Setup 選項卡下的Permissions ，為以下項目新增完整層級權限：
   
   • SOAP 網路服務
   • 設定公司
   • 基於令牌的驗證：
     • 要啟用角色僅透過存取權限進行驗證，使用存取權限登入
     • 要啟用角色建立和撤銷自己的存取權限，使用者存取權限
       
     
6. 按一下「儲存」(Save)。

步驟 4.將角色指派給整合使用者

建立整合角色後，將其指派給連接器的整合使用者：

1. 在 NetSuite 中，選擇設定,使用者/角色,管理使用者 。
2. 選擇或建立連接器的整合使用者。
   

   注意： 我們建議每個連接器或整合都有獨立的使用者。

3. 在Roles 下 ，為使用者指定整合角色。

步驟 5.建立整合使用者的存取權限

要為整合使用者建立存取權限 ：

1. 在 NetSuite 中，選擇Setup,Users/Roles,Access tokens,New 。
2. 按一下New access token 。
   
3. 在應用程式名稱 中 ，選擇整合記錄。
4. 在User 中 ，選擇整合使用者。
5. 在角色 中 ，選擇整合角色。
6. 按一下「儲存」(Save)。
7. 請注意為標記建立的 ID 和秘密；您需要它們來建立連接器的屬性。

   注意： 為了安全起見，ID 和 Secret 只會在建立存取標記時出現。像處理密碼一樣處理它們。如果您沒有連接器屬性的令牌 ID 或秘密，請為整合使用者建立新的令牌。

設置 NetSuite 令牌驗證連接器

注意：為了使連接器可用於組織的鏈結，組織安全性管理員首先要從組態中啟用它。

1. 在「鏈結產生器」中，按一下「連線」compare_arrows，然後按一下右上角的「建立」。
2. 在Connector Connection ，選擇NetSuite Token Authentication 和預設 CloudRunner。
   
3. 輸入唯一的名稱和描述，以協助識別連線。
4. 在「屬性」(Properties) 下，輸入連結的詳細資料：
   
   

   摘要資訊	詳細資料
   帳戶 ID：	輸入要連接的 NetSuite 帳戶的 ID。
   消費者金鑰	輸入連接器整合記錄的消費者金鑰。
   消費者秘密	輸入Consumer Key 屬性的秘密。
   權杖 ID	輸入連接器存取權限的 ID。
   令牌密碼	輸入令牌 ID 屬性的秘密。
   沙箱	要連接到沙盒 NetSuite 帳戶，請勾選此方塊。

   注意：所有敏感認證都會自動加密並以進階加密標準 (AES)-256 加密方式儲存。

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

疑難排解

自訂欄位

請注意 NetSuite API 無法傳回自訂欄位。作為替代方案，Data Prep 可以建立模擬 Netsuite 自訂欄位邏輯的轉換。

連線

如果與 NetSuite 的連接失敗：

• 檢查為連接器輸入的帳戶 ID。要在 NetSuite 中檢視帳戶 ID，請選擇Setup,Integrations,Web Services Preferences 。ID 通常也會出現在 URL 中app.netsuite.com 之前。
• 驗證連接器整合記錄的消費者金鑰和密碼。如有必要，編輯整合記錄並重設其憑證，以建立新的消費者金鑰和密碼。
• 驗證連接器存取標記的 ID 和密碼。如有必要，為連接器建立新的權限。