如何在 Java 中使用 GroupDocs.Viewer 從 MS Project 檔案產生專案報告

介紹

從 MS Project 檔案產生專案報告是專案經理與開發人員常見的需求。在本教學中，您將看到 GroupDocs.Viewer for Java 如何快速且安全地 產生專案報告 資料與 檢視 MS Project 檔案 詳情。我們將逐步說明設定、程式碼片段與實務案例，讓您立即開始打造洞察力十足的儀表板。

完成本指南後，您將能夠：

• 在 Maven 專案中設定 GroupDocs.Viewer for Java。
• 取得構成專案報告骨幹的檢視資訊。
• 為受密碼保護的檔案設定載入選項。

讓我們一起深入探索，改變您處理 MS Project 資料的方式吧！

快速解答

• 「產生專案報告」在此指的是什麼？ 提取關鍵的專案中繼資料（日期、任務數量等），供報告工具使用。
• 需要哪個函式庫？ GroupDocs.Viewer for Java（v25.2 或更新版本）。
• 可以在沒有授權的情況下檢視 MS Project 檔案嗎？ 可使用免費試用版進行評估，但正式上線需購買授權。
• 如何處理受密碼保護的檔案？ 在建立 Viewer 時使用 LoadOptions 提供密碼。
• 支援哪個 Java 版本？ JDK 8 或更新版本。

什麼是使用 GroupDocs.Viewer 「產生專案報告」？

產生專案報告意味著從 MS Project 文件中提取結構化資訊——例如開始/結束日期、任務數量與資源分配等。GroupDocs.Viewer 會提供一個 ProjectManagementViewInfo 物件，內含所有這些細節，讓您輕鬆將資料匯入報告儀表板或匯出至其他格式。

為什麼要使用 GroupDocs.Viewer 檢視 MS Project 檔案細節？

• 速度： 無需安裝 Microsoft Project，即可渲染與提取資料。
• 安全性： 載入選項允許安全開啟受密碼保護的檔案。
• 跨平台： 可在任何相容 Java 的環境中執行，從桌面到雲端皆適用。

前置條件

在開始之前，請確保您已具備：

1. 函式庫與相依性

   • GroupDocs.Viewer Java 函式庫（版本 25.2 或更新）。
   • 已安裝 Maven 以管理相依性。

2. 環境設定

   • IntelliJ IDEA、Eclipse 等 IDE。
   • JDK 8 或更高版本。

3. 知識前置

   • 基本的 Java 與 Maven 技能。
   • 了解 MS Project 檔案格式（有助於使用但非必須）。

設定 GroupDocs.Viewer for Java

透過 Maven 安裝

將儲存庫與相依性加入您的 pom.xml：

<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/viewer/java/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-viewer</artifactId>
        <version>25.2</version>
    </dependency>
</dependencies>

取得授權

若要解鎖全部功能，請考慮以下授權方式：

• 免費試用 – 無需信用卡即可測試全部功能。
• 暫時授權 – 延長評估期間的存取權。
• 正式授權 – 生產環境使用，享有無限制支援。

如需一步步的授權說明，請前往 GroupDocs purchase page。

基本初始化

完成相依性設定後，您即可透過傳入 MS Project 檔案路徑來建立 Viewer 實例。

實作指南

取得 MS Project 文件的檢視資訊

此功能會提取您 產生專案報告 所需的核心資料。

步驟 1：定義文件路徑

指定您的 MS Project 檔案所在位置：

String documentPath = "YOUR_DOCUMENT_DIRECTORY/SAMPLE_MPP";

步驟 2：初始化 ViewInfoOptions

設定選項以請求 HTML 風格的檢視資訊：

ViewInfoOptions viewInfoOptions = ViewInfoOptions.forHtmlView();

步驟 3：取得並輸出專案細節

建立 Viewer、取得 ProjectManagementViewInfo，並印出構成典型專案報告的關鍵欄位：

try (Viewer viewer = new Viewer(documentPath)) {
    ProjectManagementViewInfo info = (ProjectManagementViewInfo) viewer.getViewInfo(viewInfoOptions);

    System.out.println("Document type: " + info.getFileType());
    System.out.println("Pages count: " + info.getPages().size());
    System.out.println("Project start date: " + info.getStartDate());
    System.out.println("Project end date: " + info.getEndDate());
}

說明

• getViewInfo(viewInfoOptions) 會根據提供的選項擷取中繼資料。
• 回傳的 info 物件包含檔案類型、頁數以及關鍵日期——正是您 產生專案報告 所需的資料。

GroupDocs.Viewer 設定

如果您的 MS Project 檔案受密碼保護，必須透過載入選項提供密碼。

步驟 1：設定 Load Options

LoadOptions loadOptions = new LoadOptions();
loadOptions.setPassword("your_password_if_needed");

步驟 2：使用 Load Options 初始化 Viewer

在建構 Viewer 時傳入 loadOptions：

try (Viewer viewer = new Viewer(documentPath, loadOptions)) {
    // Viewer is now ready for use with the specified document and options.
}

說明
LoadOptions 讓您定義額外參數（如密碼），確保安全存取受保護的檔案。

實務應用

1. 專案管理儀表板 – 將提取的日期與任務數量匯入即時儀表板，供利害關係人參考。
2. 自動化報告 – 迭代多個 .mpp 檔案，產生彙總報告並自動寄送。
3. CRM 整合 – 結合專案時程與客戶資料，提升交付預測的準確度。

效能考量

• 記憶體管理 – 如範例所示使用 try‑with‑resources，確保 Viewer 能即時關閉。
• 快取 – 將常用的檢視資訊存入快取，避免重複讀檔。
• 監控 – 處理大型專案時監測 JVM 記憶體使用情況，並適時調整堆積大小。

常見問題與解決方案

常見問答

Q: 什麼是 GroupDocs.Viewer Java？
A: 這是一套 Java 函式庫，可渲染與提取超過 100 種檔案格式的資訊，包含 MS Project 文件。

Q: 如何處理受密碼保護的 MS Project 檔案？
A: 在建立 Viewer 前，使用 LoadOptions 類別設定密碼即可。

Q: 可以在商業專案中使用 GroupDocs.Viewer 嗎？
A: 可以，只要取得正式授權即可。

Q: 取得檢視資訊時常見的陷阱是什麼？
A: 檔案路徑錯誤、使用過舊的函式庫版本，或嘗試讀取不受支援的 MS Project 功能。

Q: 如何提升大型 MS Project 檔案的效能？
A: 實作快取、在安全的前提下重複使用 Viewer 實例，並調整 JVM 記憶體設定。

資源

• GroupDocs Viewer Documentation
• API Reference
• Download GroupDocs.Viewer for Java
• Purchase License
• Free Trial Version
• Temporary License Application
• GroupDocs Support Forum

最後更新： 2026-02-26
測試環境： GroupDocs.Viewer 25.2 for Java
作者： GroupDocs