管理和分享在 Microsoft Project (MPP) 中建立的專案計畫可能具有挑戰性,尤其是當利害關係人無法存取 MS Project 等專業軟體時。因此,將 MPP 檔案轉換為 HTML 提供了一個實用的解決方案,使專案資料可以透過任何 Web 瀏覽器進行普遍存取。本文詳細介紹如何使用 .NET REST API 開發 MS Project 檢視器。
用於操作 MS 專案文件的 REST API
GroupDocs.Conversion Cloud SDK for .NET 提供了一種透過將 MPP 轉換為 HTML 格式來建立基於 Web 的 MS Project 檢視器的高效且簡單的方法。 SDK 保留所有關鍵項目詳細信息,例如任務、時間表、資源和依賴項,確保輸出與原始文件保持一致。現在,為了使用 SDK,首先我們需要透過在 NuGet 套件管理器中搜尋 GroupDocs.Conversion-Cloud 來安裝它,然後點擊「安裝」按鈕。另一種選擇是在套件管理器控制台中執行以下命令。
NuGet\Install-Package GroupDocs.Conversion-Cloud -Version 24.2.0
安裝完成後,請取得您的個人化 API 憑證(即客戶端 ID 和用戶端金鑰)。您可以存取這個簡短的教程,其中解釋瞭如何取得 API 憑證的詳細資訊。
C# .NET 中的 MS 專案檢視器
讓我們詳細探討如何將 MPP 到 HTML 轉換功能直接整合到我們的 .NET 應用程式中,從而實現即時轉換並建立互動式專案檢視器。
- 建立「Configuration」類別的實例,我們在其中傳遞客戶端憑證作為參數。
var configurations = new Configuration(clientId, clientSecret1);
- 初始化
ConvertApi
,我們將 Configuration 物件作為輸入參數傳遞。
var apiInstance = new ConvertApi(configurations);
- 將輸入的 MS Project 檔案上傳到雲端儲存。
fileUpload.UploadFile(new UploadFileRequest("Home move plan.mpp", stream));
- 建立一個實例“ConvertSettings”,其中我們指定輸入 MPP 的名稱、結果格式“html”以及結果 HTML 檔案的名稱作為參數。
var settings = new ConvertSettings{...}
- 呼叫ConvertDocumentRequest介面將MPP轉換為HTML並將結果儲存到雲端儲存。
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
// 更多範例請參閱 https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet
// 取得您的 API 憑證
string clientId = "XXXXXX-XXXXXXXXX-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "XXXXXXXXXXXXXXXXXXXX";
// 建立配置類別的實例並使用客戶端 ID 和客戶端金鑰對其進行初始化。
var configurations = new Configuration(clientId, clientSecret1);
// 定義 ApiBaseUrl 的值以設定 MPP 到 HTML 轉換 API 的基本 url。
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
// 使用 Configuration 類別的物件初始化 ConvertApi 類別的實例。
var apiInstance = new ConvertApi(configurations);
// 從本機磁碟機載入輸入 MPP
using (var stream = System.IO.File.OpenRead("Home move plan.mpp"))
{
// 建立 FileApi 的實例
var fileUpload = new FileApi(configurations);
// 將輸入的MPP上傳到雲端存儲
fileUpload.UploadFile(new UploadFileRequest("input.mpp", stream));
// 建立 ConvertSettings,在其中指定輸入 MPP 的名稱和產生的 HTML 檔案的名稱
var settings = new ConvertSettings
{
StorageName = "default",
FilePath = "input.mpp",
Format = "html",
OutputPath = "resultant.xps"
};
// 呼叫 ConvertDocument 方法進行 MPP 到 HTML 的轉換操作。
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
if (response != null && response.Equals("OK"))
{
// 列印成功訊息
Console.WriteLine("MPP to HTML conversion completed successfully !");
}
}
上例中產生的 PowerPoint 簡報可以從 Home move plan.mpp 下載。
使用 cURL 指令的 Microsoft Project Reader
對於尋求簡單且自動化解決方案的人來說,使用 GroupDocs.Conversion Cloud 和 cURL 命令將 MPP 檔案轉換為 HTML 是一種理想的方法。透過使用 cURL,您可以輕鬆地將 API 請求傳送至 GroupDocs.Conversion Cloud,讓您能夠將 Microsoft Project (MPP) 檔案轉換為 HTML 格式,而無需進行大量編碼。
此方法的第一步是產生 JWT 存取權令牌,然後執行以下 cURL 命令,透過將 MPP 轉換為 HTML 格式來在線上開發 Microsoft Project Viewer。成功轉換後,產生的 HTML 儲存在雲端儲存中。
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"default\", \"FilePath\": \"{inputMPP}\", \"Format\": \"html\", \"OutputPath\": \"{resultantFile}\"}"
請將「inputMPP」替換為輸入 MS 專案檔案的名稱,將「resultantFile」替換為產生的 HTML 檔案的名稱,將「accessToken」替換為個人化 JWT 存取權令牌。
- 請執行下列 cURL 指令將產生的 HTML 儲存在本機磁碟機上。
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"default\", \"FilePath\": \"{inputMPP}\", \"Format\": \"html\"}" \
-o "myConverted.html"
MPP 到 HTML 轉換應用程式
為了體驗GroupDocs.Conversion Cloud REST API的功能,您可以考慮使用我們的免費HTML to PowerPoint Converter應用程式。這個輕量且超高效的應用程序,使您能夠在網頁瀏覽器中體驗 REST API 的驚人功能。
有用的連結
結論
對於需要靈活的、基於 Web 的方法來共享專案資料的組織來說,將 MPP 檔案轉換為 HTML 格式是一種實用的解決方案。無論您選擇全面的 GroupDocs.Conversion Cloud SDK for .NET 還是簡單且自動化的 cURL 命令方法,這兩種方法都可以輕鬆將 Microsoft Project 檔案轉換為可在任何瀏覽器中查看的可存取格式。我們鼓勵您探索這些解決方案,透過使專案資訊更易於存取和共享來增強您的專案管理和協作工作。
推薦文章
我們強烈建議訪問以下連結以了解更多資訊: