Zarządzanie właściwościami prezentacji w Javie

Wprowadzenie

Aspose.Slides for Java obsługuje wbudowane i niestandardowe właściwości dokumentu. Użyj tych właściwości do odczytu i aktualizacji metadanych prezentacji, takich jak autor, tytuł i wartości definiowane przez użytkownika.

Aspose.Slides pozwala pracować z właściwościami dokumentu prezentacji za pośrednictwem interfejsu IDocumentProperties. Instancja tego interfejsu jest zwracana przez IPresentation.getDocumentProperties. Poniższe przykłady pokazują, jak odczytywać, modyfikować i zarządzać tymi właściwościami.

Zarządzanie właściwościami prezentacji

Właściwości dokumentu przechowują opisowe informacje razem z zawartością prezentacji. Dzielą się na dwie kategorie:

  • Wbudowane właściwości zawierają standardowe metadane, takie jak tytuł, autor i statystyki dokumentu.
  • Niestandardowe właściwości przechowują pary nazw/wartości definiowane przez użytkownika.

Aspose.Slides for Java zapewnia dostęp do obu kategorii. W programie PowerPoint wybierz Plik → Informacje → Właściwości → Zaawansowane właściwości, aby sprawdzić metadane dokumentu. Okno dialogowe grupuje informacje w zakładkach, takich jak Podsumowanie, Statystyki, Zawartość i Niestandardowe. Użyj zakładki Niestandardowe, aby zarządzać właściwościami definiowanymi przez użytkownika.

Odczyt publicznych właściwości z zaszyfrowanej prezentacji

Hasło otwierające zazwyczaj chroni zarówno zawartość prezentacji, jak i właściwości dokumentu. Gdy prezentacja jest szyfrowana po wywołaniu IProtectionManager.setEncryptDocumentProperties z wartością false, jej właściwości dokumentu pozostają publiczne. Aplikacja może wtedy wywołać LoadOptions.setOnlyLoadDocumentProperties z wartością true i odczytać publiczne metadane bez podawania hasła otwierającego.

LoadOptions.setOnlyLoadDocumentProperties kontroluje, co Aspose.Slides ładuje; nie odszyfrowuje niczego. Jeśli właściwości zostały objęte szyfrowaniem, ich załadowanie bez hasła kończy się niepowodzeniem. Jeśli prezentacja nie jest szyfrowana, opcja jest ignorowana i ładowana zostaje cała prezentacja.

Przykład wymaga zaszyfrowanej prezentacji, której właściwości dokumentu zostały pozostawione publiczne. Weryfikuje tryb ładowania za pomocą IProtectionManager.isOnlyDocumentPropertiesLoaded i następnie odczytuje wbudowane właściwości poprzez IPresentation.getDocumentProperties:

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.LoadOptions;
import com.aspose.slides.Presentation;

LoadOptions loadOptions = new LoadOptions();
loadOptions.setOnlyLoadDocumentProperties(true);

Presentation presentation = new Presentation("public-properties-encrypted.pptx", loadOptions);
try {
    if (presentation.getProtectionManager().isOnlyDocumentPropertiesLoaded()) {
        IDocumentProperties documentProperties = presentation.getDocumentProperties();

        System.out.println("Author: " + documentProperties.getAuthor());
        System.out.println("Title: " + documentProperties.getTitle());
        System.out.println("Keywords: " + documentProperties.getKeywords());
    } else {
        System.out.println("The presentation was not loaded in document-properties-only mode.");
    }
} finally {
    presentation.dispose();
}

W tym trybie zawartość slajdów nie jest ładowana. Slajdy, wzorce, układy, kształty, multimedia i inne obiekty prezentacji są niedostępne. Aplikacje powinny zawsze sprawdzać IProtectionManager.isOnlyDocumentPropertiesLoaded przed wykonaniem operacji, która wymaga pełnego modelu obiektowego prezentacji.

Aktualizacja właściwości zaszyfrowanej prezentacji

Dla zaszyfrowanego pliku PPTX prezentacja załadowana po wywołaniu LoadOptions.setOnlyLoadDocumentProperties z true jest przeznaczona do odczytu publicznych metadanych. Aspose.Slides nie może zapisać zmienionych właściwości z tego obiektu zawierającego wyłącznie metadane, ponieważ publiczne właściwości muszą pozostać zgodne z odpowiadającymi danymi wewnątrz zaszyfrowanej prezentacji. Dlatego ich aktualizacja wymaga prawidłowego hasła otwierającego i pełnego załadowania.

Przykład wymaga zaszyfrowanej prezentacji PPTX z publicznymi właściwościami dokumentu oraz znanego hasła otwierającego. Otwiera pełną prezentację przy użyciu LoadOptions.setPassword, aktualizuje publiczne wbudowane właściwości i zapisuje wynik. Następnie używa IPresentationInfo.isEncrypted do weryfikacji, że szyfrowanie zostało zachowane, i ponownie otwiera publiczne metadane bez hasła, aby sprawdzić nowe wartości:

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.LoadOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.PresentationFactory;
import com.aspose.slides.SaveFormat;

final String inputPath = "public-properties-encrypted.pptx";
final String outputPath = "updated-public-properties-encrypted.pptx";

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

Presentation presentation = new Presentation(inputPath, loadOptions);
try {
    IDocumentProperties documentProperties = presentation.getDocumentProperties();
    documentProperties.setTitle("Updated Product Roadmap");
    documentProperties.setKeywords("roadmap, planning, indexed");

    presentation.save(outputPath, SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(outputPath);
System.out.println("The presentation is encrypted: " + presentationInfo.isEncrypted());

LoadOptions metadataLoadOptions = new LoadOptions();
metadataLoadOptions.setOnlyLoadDocumentProperties(true);

Presentation metadataPresentation = new Presentation(outputPath, metadataLoadOptions);
try {
    if (metadataPresentation.getProtectionManager().isOnlyDocumentPropertiesLoaded()) {
        System.out.println("Title: " + metadataPresentation.getDocumentProperties().getTitle());
        System.out.println("Keywords: " + metadataPresentation.getDocumentProperties().getKeywords());
    } else {
        System.out.println("The presentation was not loaded in document-properties-only mode.");
    }
} finally {
    metadataPresentation.dispose();
}

Jeśli aplikacja nie ma zezwolenia na odszyfrowanie lub załadowanie zawartości prezentacji, musi traktować publiczne właściwości zaszyfrowanego pliku PPTX jako tylko do odczytu.

Dostęp do wbudowanych właściwości

Interfejs IDocumentProperties udostępnia wbudowane metadane poprzez metody pobierające, w tym getAuthor, getTitle, oraz getCreatedTime. Ten przykład otwiera istniejącą prezentację i wypisuje jej zapisane metadane w konsoli. Wartości zależą od wejściowej prezentacji; niektóre pola mogą być puste.

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.Presentation;

Presentation presentation = new Presentation("AccessBuiltInProperties.pptx");
try {
    IDocumentProperties documentProperties = presentation.getDocumentProperties();

    System.out.println("Category: " + documentProperties.getCategory());
    System.out.println("Content status: " + documentProperties.getContentStatus());
    System.out.println("Creation date: " + documentProperties.getCreatedTime());
    System.out.println("Author: " + documentProperties.getAuthor());
    System.out.println("Comments: " + documentProperties.getComments());
    System.out.println("Keywords: " + documentProperties.getKeywords());
    System.out.println("Last modified by: " + documentProperties.getLastSavedBy());
    System.out.println("Manager: " + documentProperties.getManager());
    System.out.println("Modified date: " + documentProperties.getLastSavedTime());
    System.out.println("Presentation format: " + documentProperties.getPresentationFormat());
    System.out.println("Last print date: " + documentProperties.getLastPrinted());
    System.out.println("Is shared between producers: " + documentProperties.getSharedDoc());
    System.out.println("Subject: " + documentProperties.getSubject());
    System.out.println("Title: " + documentProperties.getTitle());
} finally {
    presentation.dispose();
}

Modyfikowanie wbudowanych właściwości

Aby zaktualizować wbudowane metadane, użyj metod ustawiających na obiekcie zwróconym przez IPresentation.getDocumentProperties. Ten przykład otwiera istniejącą prezentację, wywołuje setAuthor, setTitle, setSubject, setComments, oraz setManager, a następnie zapisuje zaktualizowaną prezentację przy użyciu Presentation.save. Zapisany plik PPTX zawiera nowe metadane.

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("ModifyBuiltInProperties.pptx");
try {
    IDocumentProperties documentProperties = presentation.getDocumentProperties();

    documentProperties.setAuthor("Aspose.Slides for Java");
    documentProperties.setTitle("Manage PowerPoint Presentation Properties");
    documentProperties.setSubject("Modify Built-in Properties");
    documentProperties.setComments("Aspose description");
    documentProperties.setManager("Aspose manager");

    presentation.save("DocumentProperties_output.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Zarządzanie bazą hiperlinków

IDocumentProperties.getHyperlinkBase zwraca bazowy adres dokumentu dla względnych hiperlinków. Użyj IDocumentProperties.setHyperlinkBase aby zmienić go lub wyczyścić. Jest to przydatne przy przenoszeniu prezentacji i powiązanych plików w inne miejsce. Nie ma to wpływu na indywidualny hiperlink uzyskany przez IHyperlink.getExternalUrl: zmiana bazy nie przepisuje zapisanych adresów linków ani nie zmienia ich bezwzględnych docelowych lokalizacji.

Przykład wymaga prezentacji zawierającej zarówno względny link, np. target.html, jak i bezwzględny link, np. https://example.org/absolute.html. Odczytuje istniejącą bazę, przypisuje nowy adres bazowy, zapisuje i ponownie otwiera prezentację, aby sprawdzić wartość. Następnie czyści bazę, podając pusty ciąg znaków, i weryfikuje pustą wartość w osobnym zapisanym pliku. Zamień przykładowy adres bazowy na lokalizację swoich powiązanych plików.

import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("hyperlinks.pptx");
try {
    System.out.println("Original base: " + presentation.getDocumentProperties().getHyperlinkBase());

    final String newBase = "https://example.com/new/";
    presentation.getDocumentProperties().setHyperlinkBase(newBase);
    presentation.save("hyperlinks-updated.pptx", SaveFormat.Pptx);

    Presentation updatedPresentation = new Presentation("hyperlinks-updated.pptx");
    try {
        System.out.println("Base preserved: " + newBase.equals(updatedPresentation.getDocumentProperties().getHyperlinkBase()));

        updatedPresentation.getDocumentProperties().setHyperlinkBase("");
        updatedPresentation.save("hyperlinks-cleared.pptx", SaveFormat.Pptx);

        Presentation clearedPresentation = new Presentation("hyperlinks-cleared.pptx");
        try {
            System.out.println("Base cleared: " + "".equals(clearedPresentation.getDocumentProperties().getHyperlinkBase()));
        } finally {
            clearedPresentation.dispose();
        }
    } finally {
        updatedPresentation.dispose();
    }
} finally {
    presentation.dispose();
}

Oba komunikaty weryfikacyjne powinny wypisać true. Czyszczenie bazy nie zmienia adresów poszczególnych hiperlinków.

Względny link do target.pptx otwierał old/target.pptx, gdy baza wskazywała na folder old. Po zmianie bazy na folder new, zapisaniu i ponownym otwarciu prezentacji ten sam link otwierał new/target.pptx. Link bezwzględny nadal otwierał ten sam plik. Przetestuj swoje względne linki w PowerPoint przed i po przeniesieniu prezentacji lub zmianie jej bazy.

Dodawanie niestandardowych właściwości prezentacji

Niestandardowe właściwości przechowują metadane, które nie mają odpowiadającego pola wbudowanego. Metoda IDocumentProperties.set_Item umożliwia przypisanie wartości według nazwy właściwości. Ten przykład tworzy prezentację, dodaje dwie wartości tekstowe oraz wartość wersji całkowitej i zapisuje prezentację przy użyciu Presentation.save. Przypisanie wartości do istniejącej nazwy zastępuje wartość tej właściwości.

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation();
try {
    IDocumentProperties documentProperties = presentation.getDocumentProperties();

    documentProperties.set_Item("Reviewed by", "John Smith");
    documentProperties.set_Item("Confidentiality level", "Internal");
    documentProperties.set_Item("Document version", 2);

    presentation.save("CustomDocumentProperties_output.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Dostęp i modyfikacja niestandardowych właściwości

Ten przykład otwiera prezentację zawierającą niestandardowe właściwości i używa getCountOfCustomProperties do iteracji po nich. getCustomPropertyName przyjmuje indeks zerowy i zwraca nazwę używaną przez IDocumentProperties.set_Item. Przykład wypisuje każdą oryginalną nazwę i wartość, zastępuje każdą wartość numerowanym łańcuchem niezależnie od pierwotnego typu i zapisuje zmiany. Jeśli nie ma niestandardowych właściwości, pętla nie wprowadza zmian.

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("AccessAndModifyProperties.pptx");
try {
    IDocumentProperties documentProperties = presentation.getDocumentProperties();

    for (int i = 0; i < documentProperties.getCountOfCustomProperties(); i++) {
        String propertyName = documentProperties.getCustomPropertyName(i);
        Object propertyValue = documentProperties.get_Item(propertyName);

        System.out.println("Custom property name: " + propertyName);
        System.out.println("Custom property value: " + propertyValue);

        documentProperties.set_Item(propertyName, "New Value " + (i + 1));
    }

    presentation.save("CustomProperties_output.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Przykład na żywo

Wypróbuj aplikację online Przeglądaj i edytuj metadane PowerPoint, aby zobaczyć, jak pracować z właściwościami dokumentu przy użyciu API Aspose.Slides:

Przeglądaj i edytuj metadane PowerPoint

FAQ

Jak mogę usunąć wbudowaną właściwość z prezentacji?

Wbudowane właściwości są integralną częścią prezentacji i nie mogą być całkowicie usunięte. Można jednak zmienić ich wartości lub ustawić je na pustą wartość, jeśli dana właściwość na to pozwala.

Co się stanie, jeśli dodam niestandardową właściwość, która już istnieje?

Jeśli dodasz niestandardową właściwość, która już istnieje, jej istniejąca wartość zostanie nadpisana nową. Nie musisz usuwać ani sprawdzać właściwości wcześniej, ponieważ Aspose.Slides automatycznie aktualizuje wartość właściwości.

Czy mogę uzyskać dostęp do właściwości prezentacji bez pełnego załadowania prezentacji?

Tak. Użyj PresentationFactory.getPresentationInfo i następnie IPresentationInfo.readDocumentProperties aby odczytać zapisane metadane dokumentu bez tworzenia instancji Presentation. Zobacz Zbuduj lekki inwentaryzator prezentacji po pełnym przykładzie raportowania i ograniczeniach specyficznych dla formatu.

Czy mogę odczytać publiczne właściwości zaszyfrowanej prezentacji bez jej hasła otwierającego?

Tak. Prezentacja musi być zaszyfrowana po wywołaniu IProtectionManager.setEncryptDocumentProperties z false, a następnie załadowana po wywołaniu LoadOptions.setOnlyLoadDocumentProperties z true.

Czy mogę zaktualizować zaszyfrowany plik PPTX w trybie tylko właściwości dokumentu?

Nie. Publiczne i zaszyfrowane dane właściwości muszą pozostać spójne, więc aktualizacja zaszyfrowanego pliku PPTX wymaga pełnego załadowania prezentacji z prawidłowym hasłem otwierającym.