Управление свойствами презентации в Java

О чём эта страница

Мастерство управления свойствами презентации в Aspose.Slides for Java и оптимизация поиска, брендинга и рабочего процесса в ваших файлах PowerPoint и OpenDocument.

Введение

Aspose.Slides for Java поддерживает встроенные и пользовательские свойства документа. Используйте эти свойства для чтения и обновления метаданных презентации, таких как автор, заголовок и пользовательские значения.

Aspose.Slides позволяет работать со свойствами документа презентации через интерфейс IDocumentProperties . Экземпляр этого интерфейса возвращается методом IPresentation.getDocumentProperties . Ниже приведены примеры, показывающие, как читать, изменять и управлять этими свойствами.

Note

Aspose.Slides управляет метаданными приложения и производителя при сохранении презентаций; эти поля идентифицируют программное обеспечение, создавшее вывод.

Управление свойствами презентации

Свойства документа хранят описательную информацию наряду с содержимым презентации. Они делятся на две категории:

Встроенные свойства содержат стандартные метаданные, такие как заголовок, автор и статистика документа.
Пользовательские свойства хранят пользовательские пары имя/значение.

Aspose.Slides for Java предоставляет доступ к обеим категориям. В PowerPoint выберите File → Info → Properties → Advanced Properties, чтобы просмотреть метаданные документа. Диалог группирует информацию по вкладкам, таким как Summary, Statistics, Contents и Custom. Используйте вкладку Custom для управления пользовательскими свойствами.

Чтение публичных свойств из зашифрованной презентации

Пароль открытия обычно защищает как содержание презентации, так и свойства документа. Когда презентация зашифрована после вызова IProtectionManager.setEncryptDocumentProperties с параметром false, её свойства документа остаются публичными. Приложение может затем вызвать LoadOptions.setOnlyLoadDocumentProperties с параметром true и прочитать публичные метаданные без предоставления пароля открытия.

LoadOptions.setOnlyLoadDocumentProperties управляет тем, что загружает Aspose.Slides; он не расшифровывает ничего. Если свойства включены в шифрование, загрузка их без пароля завершается ошибкой. Если презентация не зашифрована, параметр игнорируется и загружается полная презентация.

В примере требуется зашифрованная презентация, у которой свойства документа оставлены публичными. Он проверяет режим загрузки через IProtectionManager.isOnlyDocumentPropertiesLoaded и затем читает встроенные свойства через 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();
}

В этом режиме содержимое слайдов не загружается. Слайды, шаблоны, макеты, фигуры, медиа и другие объекты презентации недоступны. Приложения всегда должны проверять IProtectionManager.isOnlyDocumentPropertiesLoaded , прежде чем выполнять операцию, требующую полной модели объекта презентации.

Warning

Публичные метаданные могут раскрыть имена авторов, заголовки, темы, ключевые слова, информацию о компании, комментарии и пользовательские значения. Шифруйте чувствительные свойства вместе с презентацией. Оставляйте их публичными только в случаях, когда системы индексации, классификации, поиска или управления документами имеют конкретную необходимость доступа к ним без пароля.

Обновление свойств зашифрованной презентации

Для зашифрованного файла PPTX презентация, загруженная после вызова LoadOptions.setOnlyLoadDocumentProperties с параметром true, предназначена для чтения публичных метаданных. Aspose.Slides не может сохранить изменённые свойства из этого объекта, содержащего только метаданные, потому что публичные свойства должны оставаться согласованными с соответствующими данными внутри зашифрованной презентации. Поэтому их обновление требует правильного пароля открытия и полной загрузки.

В примере требуется зашифрованная PPTX‑презентация с публичными свойствами документа и известным паролем открытия. Он открывает полную презентацию с помощью LoadOptions.setPassword , обновляет публичные встроенные свойства и сохраняет результат. Затем используется IPresentationInfo.isEncrypted , чтобы проверить, что шифрование сохраняется, и повторно открывает публичные метаданные без пароля для проверки новых значений:

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();
}

Если приложению не разрешено расшифровывать или загружать содержимое презентации, оно должно рассматривать публичные свойства зашифрованного файла PPTX как только для чтения.

Доступ к встроенным свойствам

Интерфейс IDocumentProperties предоставляет доступ к встроенным метаданным через методы‑получатели, включая getAuthor , getTitle и getCreatedTime . Этот пример открывает существующую презентацию и выводит её хранимые метаданные в консоль. Значения зависят от входной презентации; некоторые поля могут быть пустыми.

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();
}

Изменение встроенных свойств

Чтобы обновить встроенные метаданные, используйте методы‑установщики объекта, возвращаемого IPresentation.getDocumentProperties . Этот пример открывает существующую презентацию, вызывает setAuthor , setTitle , setSubject , setComments и setManager , затем сохраняет обновлённую презентацию с помощью Presentation.save . Сохранённый PPTX содержит новые метаданные.

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();
}

Управление базой гиперссылок

IDocumentProperties.getHyperlinkBase возвращает базовый адрес уровня документа для относительных гиперссылок. Используйте IDocumentProperties.setHyperlinkBase , чтобы изменить его или очистить. Это полезно при перемещении презентации и связанных файлов в другое место. Это отдельно от отдельной гиперссылки IHyperlink.getExternalUrl : изменение базы не переписывает сохранённые адреса ссылок и не меняет абсолютные назначения.

В примере требуется презентация, содержащая как относительную ссылку, например target.html, так и абсолютную ссылку, например https://example.org/absolute.html. Он считывает существующую базу, задаёт новый базовый адрес, сохраняет и повторно открывает презентацию для проверки значения. Затем очищает базу пустой строкой и проверяет пустое значение в отдельном сохранённом файле. Замените пример базового адреса на расположение ваших связанных файлов.

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();
}

Оба сообщения проверки должны вывести true. Очистка базы сохраняет отдельные адреса гиперссылок неизменными.

Относительная ссылка на target.pptx открывала old/target.pptx, когда база указывала на папку old. После изменения базы на папку new, сохранения и повторного открытия презентации, та же ссылка открывала new/target.pptx. Абсолютная ссылка продолжала открывать тот же файл. Проверьте свои относительные ссылки в PowerPoint до и после перемещения презентации или изменения её базы.

Добавление пользовательских свойств презентации

Пользовательские свойства хранят метаданные, для которых нет соответствующего встроенного поля. Метод IDocumentProperties.set_Item позволяет назначать значение по имени свойства. Этот пример создаёт презентацию, добавляет два текстовых значения и целочисленное значение версии, и сохраняет презентацию с помощью Presentation.save . Присвоение значения существующему имени заменяет значение этого свойства.

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();
}

Доступ и изменение пользовательских свойств

Этот пример открывает презентацию, содержащую пользовательские свойства, и использует getCountOfCustomProperties , чтобы пройтись по ним. getCustomPropertyName принимает нулевой индекс и возвращает имя, используемое IDocumentProperties.set_Item . Пример выводит каждое оригинальное имя и значение, заменяет каждое значение на нумерованную строку независимо от исходного типа, и сохраняет изменения. Если пользовательских свойств нет, цикл не вносит изменений.

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();
}

Рабочий пример

Попробуйте онлайн‑приложение Просмотр и редактирование метаданных PowerPoint , чтобы увидеть, как работать со свойствами документа с помощью API Aspose.Slides:

Вопросы и ответы

Как удалить встроенное свойство из презентации?

Встроенные свойства являются неотъемлемой частью презентации и не могут быть полностью удалены. Однако вы можете изменить их значения или установить их пустыми, если конкретное свойство это позволяет.

Что произойдет, если я добавлю пользовательское свойство, которое уже существует?

Если вы добавите пользовательское свойство, которое уже существует, его текущее значение будет перезаписано новым. Удалять или проверять свойство заранее не требуется, так как Aspose.Slides автоматически обновляет значение свойства.

Могу ли я получить доступ к свойствам презентации без полной загрузки презентации?

Да. Используйте PresentationFactory.getPresentationInfo и затем IPresentationInfo.readDocumentProperties , чтобы прочитать сохранённые метаданные документа без создания экземпляра Presentation . См. Build a Lightweight Presentation Inventory для полного примера отчёта и ограничений, зависящих от формата.

Могу ли я прочитать публичные свойства зашифрованной презентации без её пароля открытия?

Да. Презентация должна быть зашифрована после вызова IProtectionManager.setEncryptDocumentProperties с false, и должна быть загружена после вызова LoadOptions.setOnlyLoadDocumentProperties с true.

Могу ли я обновить зашифрованный файл PPTX в режиме только свойств документа?

Нет. Публичные и зашифрованные данные свойств должны оставаться согласованными, поэтому обновление зашифрованного файла PPTX требует полной загрузки презентации с правильным паролем открытия.

Безопасность презентации Получение и обновление свойств представления презентации в Java