二. 前置條件

在開始操作之前，請確保滿足以下條件：

1. 已安裝 SSIS 設計器（可從 Microsoft 官網 下載）
2. 熟悉 SSIS 的基本操作，能夠開發 SSIS 包
3. 已安裝 ZappySys SSIS PowerPack
4. （可選）計劃將包部署到服務器并定期執行，可提前閱讀相關部署文檔

三. 在 SSIS 中驗證 ServiceDesk REST API（使用 OAuth 2.0）

調用 ServiceDesk API 的第一步是注冊 Zoho OAuth 應用。雖然 ServiceDesk 屬于 ManageEngine，但 ManageEngine 實際上是 Zoho 子公司，因此 API 調用需要通過 Zoho OAuth 認證。本文僅涉及 ServiceDesk 云版本。

注冊 Zoho OAuth 應用并獲取 ClientID/Secret

參考 Zoho 官方文檔 完成 OAuth 應用注冊，并獲取 Client ID 和 Client Secret，用于后續 API 認證。

在 SSIS 中創建 ServiceDesk API 連接

完成 OAuth 應用注冊后，可在 SSIS 中創建 OAuth 連接，用于數據提取和寫入操作。

四. 通過 SSIS JSON 源從 ServiceDesk API 讀取數據

本節介紹如何通過 SSIS JSON 源 從 ServiceDesk API 讀取數據。

配置 JSON 源

1. 在 SSIS 中雙擊 JSON 源組件
2. 輸入 ServiceDesk API URL
3. 選擇 OAuth 認證方式
4. 配置請求頭和參數，確保成功連接 API

ServiceDesk API 分頁（讀取所有請求）

ServiceDesk API 使用分頁機制返回數據。配置分頁邏輯如下：

1. 雙擊 JSON 源組件
2. 設置分頁參數（如 page 或 offset）
3. 配置檢測最后一頁的條件

完成配置后，API 將自動返回所有記錄，直到讀取完整數據集。

五. 使用 OAuth 2.0 向 ServiceDesk 寫入數據

向 ServiceDesk 寫入數據，需要通過 JSON 生成器或模板 構建 POST 請求 Body，并在 Web API 目標組件 中使用。基本流程如下：

1. 構建 POST 請求 Body 數據
2. 在 Web API 目標組件中配置請求 URL 和認證方式
3. 執行 SSIS 包，將數據推送到 ServiceDesk

六. 使用 SSIS 將 SQL Server 表數據寫入 ServiceDesk

完成數據讀取后，可將 SQL Server 表中的數據寫入 ServiceDesk。通常使用以下組件：

1. JSON 生成器：構建 POST 請求 Body
2. Web API 目標：發送 POST 請求
3. 錯誤處理組件：捕獲并處理寫入過程中的錯誤

七. 常見錯誤及解決方法

1. 截斷相關錯誤

當源數據長度超過設計時預期長度，可能出現截斷錯誤。解決方法：

• 調整 SSIS 包中的元數據配置
• 參考 如何處理 SSIS 錯誤（截斷、元數據問題）

2. 認證相關錯誤

認證錯誤常發生在將 SSIS 包部署到其他機器運行時。解決方法：

• 正確配置 OAuth 憑據
• 驗證目標機器的網絡連接

八. 異常處理：錯誤處理與調試

錯誤處理

• 將錯誤行重定向到日志文件或數據庫表
• 便于后續分析和處理

調試 HTTP 請求

使用 Fiddler 等工具檢查 HTTP 請求：

1. 打開 Fiddler → 工具 → 選項 → HTTPS
2. 勾選“解密 HTTPS 請求”
3. 重新運行 SSIS 包，查看請求頭、請求體和響應內容

九. 總結

本文介紹了如何在 SSIS 中實現 ManageEngine ServiceDesk 數據的讀寫：

1. 配置 Zoho OAuth 并創建 API 連接
2. 通過 JSON 源讀取數據
3. 配置分頁，獲取完整數據集
4. 使用 Web API 目標寫入數據
5. 錯誤處理與 HTTP 調試

SSIS 提供強大工具支持，結合 Zoho API，可高效完成 ServiceDesk 數據集成任務。

原文鏈接: https://zappysys.com/blog/read-write-manageengine-servicedesk-data-ssis-zoho-api/