鏈結具有三種不同的 NetSuite 連接器,每種連接器的運作方式都不同。它們不像其他平台那麼直接或靈活,因此了解差異以便為您的業務和解決方案做出正確決策是非常重要的。
先決條件和要求
在設定任何 NetSuite 整合之前,請確保您已準備好以下元件。遺漏這些是連線失敗的最常見原因。
- SuiteAnalytics Connect: 如果使用 JDBC 或 Analytics 連接器,則必須在您的 NetSuite 帳戶中啟用此功能。請注意,這通常是付費附加模組;檢查您的 NetSuite 合約。
- SuiteTalk REST Web 服務: 現代化 NetSuite Analytics 連接器和 SuiteQL 作業所必需的。
- 專用整合使用者: Workiva 強烈建議您在 NetSuite 中建立特定的「整合角色」和「整合使用者」,而不是使用個人登入。這有助於防止在員工的存取權發生變更時鏈結中斷。
NetSuite® Analytics (推薦)
此建議方法使用 SuiteAnalytics (特別是 `NetSuite2.com` 資料來源)和 SuiteQL。這是現代化的方法,可提供更具永續性與效能的解決方案。您將需要安排要在 SuiteAnalytics 中使用的資料,這樣做是值得投資的,可以避免舊版連接器出現的效能問題。
典型匯出使用方式
使用 執行 SuiteQL 查詢 命令執行 SuiteQL 查詢並從 NetSuite 擷取記錄。
其他使用方式
NetSuite® 權杖驗證 (舊版)
權杖身份驗證連接器目前使用最新版本的 NetSuite SOAP Web Services。雖然這可確保目前的穩定性,但 NetSuite 正在逐步淘汰 SOAP,轉而採用更新的協議。
路線圖更新: Workiva 正計劃在 2026 年遷移此連接器以使用 REST API 版本,以與 NetSuite 的棄用時間表保持一致。在此之前,最新的 SOAP 版本仍然完全支援連接器,但通常建議您盡可能對新專案使用 NetSuite Analytics 連接器。
典型匯出使用方式
- 檔案櫃方法: 在 NetSuite 中,自動將您的檔案傳輸到檔案櫃,然後在鏈結中使用 Get file 命令來擷取它們。
- 儲存的搜尋方法: 在 NetSuite 中建立任何需要的儲存搜尋,然後在鏈結中使用 列出儲存的搜尋 命令來取得所有可用搜尋的清單,接著使用 取得儲存的搜尋資料 命令以擷取資料。
注意: NetSuite API 不支援從包含摘要結果(分組)的已儲存搜尋中取得資料。
其他使用方式
您還可以 依類型或 ID 搜尋記錄,並 擷取標準記錄的 JSON 資料。
NetSuite® JDBC
此連接器需要 NetSuite 中的 SuiteAnalytics Connect 並支援 JDBC 連線,使您能夠使用標準 SQL 查詢資料庫。通常建議使用更新的 NetSuite 分析連接器(使用 SuiteQL),因為管理 JDBC 驅動程序和連接字串可能會更複雜。
連接器比較
| 連接器 | 基礎技術 | 最佳使用案例 |
|---|---|---|
| NetSuite 分析 | SuiteQL / REST | 大多數情況。乾淨利索地查詢大型資料集的現代標準。 |
| 權杖驗證 | SOAP (舊版) | 僅舊版支援。如果您有尚無法移轉至 SuiteQL 的現有儲存搜尋條件,請使用此選項。 |
| NetSuite JDBC | Java Database Connectivity | 如果您的團隊更喜歡編寫原始 SQL 查詢而不是標準 API 互動。需要「連接」模組。 |