如何在 Java 中使用 GroupDocs Viewer 按時間區間渲染專案文件

如果您正在尋找 如何使用 GroupDocs 於聚焦時間窗口中渲染專案排程，您來對地方了。在本教學中，我們將從 Maven 設定到從專案文件產生 HTML 的完整流程一步步說明，讓您能直接在應用程式中嵌入精確的時間線視圖。

使用 GroupDocs.Viewer for Java 按時間區間渲染專案文件

Quick Answers

此功能做什麼？ 它僅渲染 Microsoft Project 檔案中介於開始日期與結束日期之間的部分。
使用哪種輸出格式？ HTML（內嵌資源），非常適合網頁整合。
需要授權嗎？ 免費試用可用於評估；正式環境需購買完整授權。
可以在執行時變更日期範圍嗎？ 可以——只要在渲染選項中調整 setStartDate 與 setEndDate 的值。
支援所有 Java 版本嗎？ 只要使用 GroupDocs.Viewer 25.2 或更新版本，即可在 Java 8 以上運行。

在此情境下「如何使用 GroupDocs」是什麼意思？

GroupDocs Viewer 是一個 Java 函式庫，可將超過 100 種檔案格式轉換為適合網頁顯示的表示形式。當您 如何使用 GroupDocs 於專案檔案時，您即可在不需要客戶端安裝 Microsoft Project 的情況下，提取、視覺化與分享排程資料。

為什麼要以時間區間渲染專案文件？

聚焦分析： 只顯示您關心的階段（例如 2024 年第三季）。
效能： 較小的 HTML 輸出可加快頁面載入速度。
整合性： 可將時間軸視圖嵌入儀表板、報告入口網站或自訂的專案管理工具。

前置條件

GroupDocs.Viewer for Java 版本 25.2 或以上。
Java Development Kit (JDK) 8 或更新版本。
如 IntelliJ IDEA 或 Eclipse 等 IDE。
基本的 Maven 知識。

設定 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 下載頁面下載試用版。
臨時授權 – 透過此連結取得延長測試的臨時授權。
購買 – 若需無限制的正式環境使用，請在 GroupDocs 購買頁面購買授權。

基本 Viewer 初始化

以下程式碼示範如何建立指向 Microsoft Project 檔案（.mpp）的 Viewer 實例：

import com.groupdocs.viewer.Viewer;

public class ViewerSetup {
    public static void main(String[] args) {
        try (Viewer viewer = new Viewer("path/to/your/document.mpp")) {
            // Your rendering code goes here
        }
    }
}

步驟式實作指南

1. 定義輸出目錄

建立一個資料夾，用於保存產生的 HTML 頁面：

import java.nio.file.Path;

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY", "RenderProjectTimeInterval");
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

為什麼？ 將渲染後的檔案妥善組織，可更輕鬆地從 Web 伺服器提供或嵌入 UI 中。

2. 使用您的專案檔案初始化 Viewer

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_MPP")) {
    // Continue with rendering steps
}

為什麼？ 載入文件會初始化內部解析器，並讓專案相關的中繼資料可被存取。

3. 取得專案檔案的檢視資訊

import com.groupdocs.viewer.options.ViewInfoOptions;
import com.groupdocs.viewer.results.ProjectManagementViewInfo;

ViewInfoOptions viewInfoOptions = ViewInfoOptions.forHtmlView();
ProjectManagementViewInfo viewInfo = (ProjectManagementViewInfo) viewer.getViewInfo(viewInfoOptions);

為什麼？ ProjectManagementViewInfo 可提供排程的開始與結束日期，稍後您會使用這些日期來限制渲染範圍。

4. 設定 HTML 渲染選項（從專案產生 HTML）

import com.groupdocs.viewer.options.HtmlViewOptions;

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
viewOptions.getProjectManagementOptions().setStartDate(viewInfo.getStartDate());
viewOptions.getProjectManagementOptions().setEndDate(viewInfo.getEndDate());

為什麼？ 設定 StartDate 與 EndDate 可告訴 GroupDocs 僅在該時間窗口內 從專案產生 HTML。

5. 執行渲染程序

viewer.view(viewOptions);

為什麼？ 此呼叫會產生一系列自包含的 HTML 頁面，呈現您專案排程中選取的時間切片。

常見問題與除錯

檔案路徑錯誤 – 請再次確認來源 .mpp 檔案與輸出目錄皆已存在。
不支援的檔案類型 – 請確保文件為支援的 Project 格式（例如 .mpp、.mpt）。
授權錯誤 – 試用授權可能會限制渲染次數；若需無限制使用，請改為完整授權。

實務應用

專案時間線分析 – 僅向利害關係人展示當前階段。
自動化報告 – 為每週狀態更新產生具時間限制的 HTML 報告。
與儀表板整合 – 將渲染頁面嵌入 BI 工具或自訂入口網站。
存檔 – 保存專案排程的網頁友好快照，以供未來參考。

效能建議

使用 嵌入資源 選項，使每個 HTML 頁面自包含，減少 HTTP 請求。
對於非常龐大的專案，建議分成較小的日期區段渲染，以降低記憶體使用。
在提供完畢後清除暫存檔，以避免磁碟空間膨脹。

結論

現在您已了解 如何使用 GroupDocs Viewer 在特定時間區間內渲染專案文件，並在 Java 中 從專案產生 HTML。此功能簡化時間線視覺化、提升報告效率，且能順利整合至現代 Web 應用程式。

後續步驟

探索其他 Viewer 功能，如浮水印、密碼保護或自訂 CSS 樣式。
將此渲染流程與 REST API 結合，以即時提供時間線視圖。

常見問與答

問：GroupDocs.Viewer 支援哪些檔案格式？
答：GroupDocs.Viewer 支援多種格式，包括 Microsoft Project (MPP)、PDF、Word、Excel、PowerPoint 等等。

問：如何開始使用 GroupDocs.Viewer 的免費試用？
答：您可從此處下載試用版。

問：可以在不嵌入資源的情況下渲染文件嗎？
答：可以，您可以選擇不同的 HTML 檢視選項，改為引用外部資源而非嵌入。

問：如果我的文件太大無法渲染該怎麼辦？
答：可將文件拆分為較小的區段，或僅渲染所需的日期範圍，如上所示。

問：如何處理渲染錯誤？
答：請檢查所有設定、確認授權有效，並參考 GroupDocs 文件以取得錯誤代碼說明。

資源

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