Truy xuất và Cập nhật Thông tin Bản trình chiếu trong Java

Trang này nói về điều gì

Khám phá slide, cấu trúc và siêu dữ liệu trong các bản trình chiếu PowerPoint và OpenDocument bằng Java để có được những hiểu biết nhanh hơn và kiểm toán nội dung thông minh hơn.

Tổng quan

Aspose.Slides có thể xác định định dạng của một bản trình chiếu và đọc siêu dữ liệu tài liệu mà không cần tạo mô hình đối tượng bản trình chiếu đầy đủ. Điều này hữu ích khi bạn cần phân loại tệp, xây dựng một danh mục, hoặc kiểm tra các thuộc tính trước khi quyết định có tải và xử lý nội dung bản trình chiếu hay không.

Bài viết này trình bày cách kiểm tra nhẹ bằng PresentationFactory và IPresentationInfo, cũng như cách cập nhật có mục tiêu thông qua IDocumentProperties.

Kiểm tra định dạng bản trình chiếu

Sử dụng PresentationFactory.getPresentationInfo để kiểm tra tệp mà không tạo một đối tượng Presentation nào. Phương thức IPresentationInfo.getLoadFormat báo cáo định dạng đã phát hiện, chẳng hạn PPTX, PPT hoặc ODP.

import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.LoadFormat;
import com.aspose.slides.PresentationFactory;

String[] fileNames = { "pres.pptx", "pres.ppt", "pres.odp" };

for (String fileName : fileNames) {
    IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(fileName);
    int loadFormat = presentationInfo.getLoadFormat();
    String formatName = "Other (" + loadFormat + ")";

    if (loadFormat == LoadFormat.Pptx) {
        formatName = "PPTX";
    } else if (loadFormat == LoadFormat.Ppt) {
        formatName = "PPT";
    } else if (loadFormat == LoadFormat.Odp) {
        formatName = "ODP";
    }

    System.out.println(fileName + ": " + formatName);
}

Xây dựng danh mục bản trình chiếu nhẹ

Khi bạn xử lý nhiều tệp bản trình chiếu, bạn có thể cần một danh mục gọn gàng cho việc xác thực, lập chỉ mục, hoặc hệ thống quản lý tài liệu. Trong trường hợp này, sử dụng PresentationFactory.getPresentationInfo để nhận một đối tượng IPresentationInfo, sau đó gọi IPresentationInfo.readDocumentProperties để đọc siêu dữ liệu tài liệu. Cách tiếp cận này không tạo một đối tượng Presentation và cũng không yêu cầu bạn phải duyệt toàn bộ mô hình đối tượng bản trình chiếu.

Các thuộc tính mở rộng được cung cấp bởi IDocumentProperties cung cấp các giá trị kiểm kê sau:

Phương thức	Giá trị kiểm kê
getSlides	Tổng số slide.
getHiddenSlides	Số slide ẩn.
getNotes	Số slide có ghi chú.
getParagraphs	Tổng số đoạn văn, nếu có.
getWords	Tổng số từ.
getMultimediaClips	Tổng số đoạn video và âm thanh.

Ví dụ dưới đây đọc các giá trị này mà không tạo đối tượng Presentation và in ra một danh mục gọn. Nó cũng kết hợp getHeadingPairs với getTitlesOfParts để hiển thị các nhóm nội dung như phông chữ, chủ đề và tiêu đề slide.

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.IHeadingPair;
import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.LoadFormat;
import com.aspose.slides.PresentationFactory;
import java.nio.file.Paths;

String filePath = "sample.pptx";
IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(filePath);
IDocumentProperties documentProperties = presentationInfo.readDocumentProperties();

int loadFormat = presentationInfo.getLoadFormat();
String formatName = "Other (" + loadFormat + ")";

if (loadFormat == LoadFormat.Pptx) {
    formatName = "PPTX";
} else if (loadFormat == LoadFormat.Ppt) {
    formatName = "PPT";
} else if (loadFormat == LoadFormat.Odp) {
    formatName = "ODP";
}

System.out.println("File: " + Paths.get(filePath).getFileName());
System.out.println("Format: " + formatName);
System.out.println("Title: " + documentProperties.getTitle());
System.out.println("Author: " + documentProperties.getAuthor());
System.out.println("Statistics:");
System.out.println("  Slides: " + documentProperties.getSlides());
System.out.println("  Hidden slides: " + documentProperties.getHiddenSlides());
System.out.println("  Slides with notes: " + documentProperties.getNotes());
System.out.println("  Paragraphs: " + documentProperties.getParagraphs());
System.out.println("  Words: " + documentProperties.getWords());
System.out.println("  Multimedia clips: " + documentProperties.getMultimediaClips());

IHeadingPair[] headingPairs = documentProperties.getHeadingPairs();
String[] titlesOfParts = documentProperties.getTitlesOfParts();
headingPairs = headingPairs != null ? headingPairs : new IHeadingPair[0];
titlesOfParts = titlesOfParts != null ? titlesOfParts : new String[0];
int partIndex = 0;

if (headingPairs.length == 0 || titlesOfParts.length == 0) {
    System.out.println("Content groups: not available");
} else {
    System.out.println("Content groups:");

    for (IHeadingPair headingPair : headingPairs) {
        System.out.println("  " + headingPair.getName() + " (" + headingPair.getCount() + ")");

        for (int partOffset = 0; partOffset < headingPair.getCount() && partIndex < titlesOfParts.length; partOffset++) {
            System.out.println("    - " + titlesOfParts[partIndex]);
            partIndex++;
        }
    }

    if (partIndex < titlesOfParts.length) {
        System.out.println("  Other parts:");

        while (partIndex < titlesOfParts.length) {
            System.out.println("    - " + titlesOfParts[partIndex]);
            partIndex++;
        }
    }
}

Mỗi IHeadingPair cung cấp một tên nhóm và số mục trong nhóm đó. IDocumentProperties.getTitlesOfParts trả về một mảng phẳng, có thứ tự, vì vậy hãy tiêu thụ số tiêu đề liên tiếp được chỉ định bởi mỗi cặp tiêu đề.

Siêu dữ liệu đã lưu và các giới hạn định dạng

Các thuộc tính kiểm kê trả về bởi IPresentationInfo.readDocumentProperties phản ánh siêu dữ liệu có trong tài liệu nguồn. Aspose.Slides không tải và duyệt mô hình đối tượng bản trình chiếu để tính lại các giá trị này cho lần gọi này. Các thuộc tính thiếu được biểu diễn bằng giá trị mặc định, và các giá trị đã lưu có thể lỗi thời nếu ứng dụng lưu tệp lần cuối không cập nhật các thuộc tính tài liệu.

PPTX: Định dạng cung cấp các thuộc tính tài liệu mở rộng cho số lượng slide, ghi chú, slide ẩn, đoạn văn, từ và đa phương tiện, cũng như cặp tiêu đề và tiêu đề phần. Tính khả dụng phụ thuộc vào các thuộc tính mà nhà tạo tài liệu đã ghi.
PPT: Định dạng nhị phân có thể lưu các thuộc tính tóm tắt tài liệu tương ứng. Nếu một thuộc tính thiếu hoặc không được nhà tạo tài liệu cập nhật, Aspose.Slides sẽ trả về giá trị đã lưu hoặc giá trị mặc định thay vì tính toán lại từ các slide.
ODP: Siêu dữ liệu OpenDocument cung cấp các thống kê chung của tài liệu, chẳng hạn như số trang, đoạn văn và từ, nhưng các giá trị này không tương ứng với mọi thuộc tính mở rộng đặc thù của PowerPoint. Siêu dữ liệu slide ẩn, slide ghi chú, đa phương tiện, cặp tiêu đề và tiêu đề phần có thể không có, và các thuộc tính kiểm kê có thể trả về giá trị mặc định. Không nên coi giá trị 0 hoặc mảng trống là bằng chứng chắc chắn rằng nội dung tương ứng không tồn tại.

Sử dụng cách tiếp cận siêu dữ liệu nhẹ cho các danh mục và kiểm tra sơ bộ. Tải bản trình chiếu và kiểm tra mô hình đối tượng trực tiếp khi kết quả phải phản ánh các thay đổi trong bộ nhớ hoặc khi bạn cần xác minh nội dung thực tế của bản trình chiếu.

Cập nhật thuộc tính bài thuyết trình

Các thuộc tính trả về bởi IPresentationInfo.readDocumentProperties cũng có thể được thay đổi mà không tạo một đối tượng Presentation nào. Áp dụng các thay đổi bằng IPresentationInfo.updateDocumentProperties, sau đó ghi bản trình chiếu đã ràng buộc bằng IPresentationInfo.writeBindedPresentation.

Hình ảnh dưới đây hiển thị các thuộc tính tài liệu gốc.

Thuộc tính tài liệu gốc của bản trình chiếu PowerPoint

Ví dụ dưới đây thay đổi tiêu đề và thời gian lưu cuối cùng và ghi kết quả ra một tệp mới:

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.PresentationFactory;
import java.io.FileOutputStream;
import java.io.OutputStream;
import java.util.Date;

String sourceFile = "sample.pptx";
String outputFile = "sample_with_updated_properties.pptx";
IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(sourceFile);
IDocumentProperties documentProperties = presentationInfo.readDocumentProperties();

documentProperties.setTitle("Quarterly sales report");
documentProperties.setLastSavedTime(new Date());

presentationInfo.updateDocumentProperties(documentProperties);
try (OutputStream outputStream = new FileOutputStream(outputFile)) {
    presentationInfo.writeBindedPresentation(outputStream);
}

Hình ảnh dưới đây hiển thị các thuộc tính tài liệu đã được cập nhật.

Thuộc tính tài liệu đã thay đổi của bản trình chiếu PowerPoint

Liên kết hữu ích

Đối với các kiểm tra bảo mật liên quan và cài đặt bảo vệ, xem các bài viết sau:

Câu hỏi thường gặp

Làm thế nào để kiểm tra liệu phông chữ có được nhúng hay không và chúng là những phông nào?

Tải bản trình chiếu và sử dụng Presentation.getFontsManager. Gọi IFontsManager.getEmbeddedFonts để lấy các phông chữ đã nhúng và IFontsManager.getFonts để lấy các phông chữ được bản trình chiếu sử dụng. So sánh hai kết quả để tìm các phông chữ cần để render nhưng chưa được nhúng.

Làm sao tôi có thể nhanh chóng xác định liệu tệp có slide ẩn và có bao nhiêu?

Khi siêu dữ liệu tài liệu đã lưu đủ, đọc IDocumentProperties.getHiddenSlides thông qua PresentationFactory.getPresentationInfo và IPresentationInfo.readDocumentProperties. Cách này thích hợp cho danh mục nhẹ. Nếu bản trình chiếu đã bị sửa đổi trong bộ nhớ, siêu dữ liệu đã lưu có thể thiếu hoặc lỗi thời, hoặc bạn cần xác minh giá trị thực tế, hãy duyệt Presentation.getSlides và kiểm tra phương thức ISlide.getHidden của mỗi slide.

Tôi có thể phát hiện xem có sử dụng kích thước và định hướng slide tùy chỉnh không, và chúng có khác so với mặc định không?

Có. Tải bản trình chiếu và gọi Presentation.getSlideSize. Sử dụng ISlideSize.getType, ISlideSize.getSize, và ISlideSize.getOrientation để so sánh các cài đặt hiện tại với preset và kích thước mặc định.

Có cách nhanh để xem biểu đồ có tham chiếu tới nguồn dữ liệu bên ngoài không?

Có. Tìm mỗi Chart và gọi IChartData.getDataSourceType. Đối với workbook bên ngoài, gọi IChartData.getExternalWorkbookPath. Loại nguồn dữ liệu và đường dẫn xác định một tham chiếu bên ngoài, nhưng kiểm tra tính khả dụng của mục tiêu yêu cầu một bước kiểm tra tài nguyên riêng.

Làm sao tôi có thể đánh giá các slide ‘nặng’ có thể làm chậm việc render hoặc xuất PDF?

Không có thuộc tính độ phức tạp duy nhất. Duyệt Presentation.getSlides và bộ sưu tập IBaseSlide.getShapes của mỗi slide. Sử dụng số lượng shape và sự hiện diện của hình ảnh lớn, hiệu ứng, hoạt ảnh hoặc đa phương tiện như các tín hiệu sàng lọc, và đo một lần render hoặc export đại diện trước khi xác định một slide là nút thắt hiệu suất đã chắc chắn.

Mở Bản Trình Bày trong Java Kết hợp hiệu quả các bản trình bày trong Java