Управление свойствами презентации с помощью Python
Введение
Aspose.Slides for Python via .NET поддерживает встроенные и пользовательские свойства документа. Используйте эти свойства для чтения и обновления метаданных презентации, таких как автор, заголовок и пользовательские значения.
Aspose.Slides позволяет работать со свойствами документа презентации через класс DocumentProperties. Экземпляр этого класса возвращается методом Presentation.document_properties. Ниже приведены примеры чтения, изменения и управления этими свойствами.
Note
Aspose.Slides управляет метаданными приложения и производителя при сохранении презентаций; эти поля идентифицируют программное обеспечение, создавшее вывод.Управление свойствами презентации
Свойства документа хранят описательную информацию вместе с содержимым презентации. Они делятся на две категории:
- Встроенные свойства содержат стандартные метаданные, такие как заголовок, автор и статистика документа.
- Пользовательские свойства хранят определяемые пользователем пары имя/значение.
Aspose.Slides for Python via .NET предоставляет доступ к обеим категориям. В PowerPoint выберите File → Info → Properties → Advanced Properties, чтобы просмотреть метаданные документа. Диалог группирует информацию по вкладкам, таким как Summary, Statistics, Contents и Custom. Используйте вкладку Custom для управления пользовательскими свойствами.
Чтение публичных свойств из зашифрованной презентации
Обычный пароль открывает как содержимое презентации, так и свойства документа. Когда презентация зашифрована с помощью ProtectionManager.encrypt_document_properties со значением False, её свойства документа остаются публичными. Приложение может установить LoadOptions.only_load_document_properties в True и прочитать публичные метаданные без указания пароля открытия.
LoadOptions.only_load_document_properties контролирует, что загружает Aspose.Slides; он ничего не расшифровывает. Если свойства включены в шифрование, загрузка без пароля завершится ошибкой. Если презентация не зашифрована, параметр игнорируется и загружается полностью.
Пример требует зашифрованную презентацию, у которой свойства документа оставлены публичными. Он проверяет режим загрузки через ProtectionManager.is_only_document_properties_loaded и затем читает встроенные свойства через Presentation.document_properties:
import aspose.slides as slides
load_options = slides.LoadOptions()
load_options.only_load_document_properties = True
with slides.Presentation("public-properties-encrypted.pptx", load_options) as presentation:
if presentation.protection_manager.is_only_document_properties_loaded:
document_properties = presentation.document_properties
print("Author: " + document_properties.author)
print("Title: " + document_properties.title)
print("Keywords: " + document_properties.keywords)
else:
print("The presentation was not loaded in document-properties-only mode.")
В этом режиме содержимое слайдов не загружается. Слайды, шаблоны, макеты, фигуры, медиа и другие объекты презентации недоступны. Приложения всегда должны проверять ProtectionManager.is_only_document_properties_loaded перед выполнением операций, требующих полной модели объектов презентации.
Security
Публичные метаданные могут раскрывать имена авторов, заголовки, темы, ключевые слова, информацию о компании, комментарии и пользовательские значения. Зашифруйте чувствительные свойства вместе с презентацией. Оставляйте их публичными только тогда, когда системы индексации, классификации, поиска или управления документами имеют конкретную потребность доступа к ним без пароля.Обновление свойств зашифрованной презентации
Для зашифрованного файла PPTX презентация, загруженная с помощью LoadOptions.only_load_document_properties, предназначена для чтения публичных метаданных. Aspose.Slides не может сохранить изменённые свойства из этого объекта только с метаданными, потому что публичные свойства должны оставаться согласованными с соответствующими данными внутри зашифрованной презентации. Поэтому их обновление требует правильного пароля открытия и полной загрузки.
Пример требует зашифрованную презентацию PPTX с публичными свойствами документа и известным паролем открытия. Он открывает полную презентацию с помощью LoadOptions.password, обновляет публичные встроенные свойства и сохраняет результат. Затем он использует PresentationInfo.is_encrypted, чтобы убедиться, что шифрование сохранено, и вновь открывает публичные метаданные без пароля для проверки новых значений:
import aspose.slides as slides
input_path = "public-properties-encrypted.pptx"
output_path = "updated-public-properties-encrypted.pptx"
load_options = slides.LoadOptions()
load_options.password = "open_password"
with slides.Presentation(input_path, load_options) as presentation:
document_properties = presentation.document_properties
document_properties.title = "Updated Product Roadmap"
document_properties.keywords = "roadmap, planning, indexed"
presentation.save(output_path, slides.export.SaveFormat.PPTX)
presentation_info = slides.PresentationFactory.instance.get_presentation_info(output_path)
print("The presentation is encrypted: " + str(presentation_info.is_encrypted))
metadata_load_options = slides.LoadOptions()
metadata_load_options.only_load_document_properties = True
with slides.Presentation(output_path, metadata_load_options) as metadata_presentation:
if metadata_presentation.protection_manager.is_only_document_properties_loaded:
print("Title: " + metadata_presentation.document_properties.title)
print("Keywords: " + metadata_presentation.document_properties.keywords)
else:
print("The presentation was not loaded in document-properties-only mode.")
Если приложению не разрешено расшифровывать или загружать содержимое презентации, оно должно рассматривать публичные свойства зашифрованного файла PPTX как доступные только для чтения.
Доступ к встроенным свойствам
Класс DocumentProperties предоставляет встроенные метаданные через типизированные свойства, включая DocumentProperties.author, DocumentProperties.title и DocumentProperties.created_time. Этот пример открывает существующую презентацию и выводит её сохранённые метаданные в консоль. Значения зависят от входной презентации; некоторые поля могут быть пустыми.
import aspose.slides as slides
with slides.Presentation("AccessBuiltInProperties.pptx") as presentation:
document_properties = presentation.document_properties
print("Category:", document_properties.category)
print("Content status:", document_properties.content_status)
print("Creation date:", document_properties.created_time)
print("Author:", document_properties.author)
print("Comments:", document_properties.comments)
print("Keywords:", document_properties.keywords)
print("Last modified by:", document_properties.last_saved_by)
print("Manager:", document_properties.manager)
print("Modified date:", document_properties.last_saved_time)
print("Presentation format:", document_properties.presentation_format)
print("Last print date:", document_properties.last_printed)
print("Is shared between producers:", document_properties.shared_doc)
print("Subject:", document_properties.subject)
print("Title:", document_properties.title)
Изменение встроенных свойств
Чтобы обновить встроенные метаданные, присвойте значения записываемым свойствам, доступным через Presentation.document_properties. Этот пример открывает существующую презентацию, устанавливает DocumentProperties.author, DocumentProperties.title, DocumentProperties.subject, DocumentProperties.comments и DocumentProperties.manager, затем сохраняет обновлённую презентацию с помощью Presentation.save. Сохранённый PPTX содержит новые метаданные.
import aspose.slides as slides
with slides.Presentation("ModifyBuiltInProperties.pptx") as presentation:
document_properties = presentation.document_properties
document_properties.author = "Aspose.Slides for Python via .NET"
document_properties.title = "Manage PowerPoint Presentation Properties"
document_properties.subject = "Modify Built-in Properties"
document_properties.comments = "Aspose description"
document_properties.manager = "Aspose manager"
presentation.save("DocumentProperties_output.pptx", slides.export.SaveFormat.PPTX)
Управление базой гиперссылок
DocumentProperties.hyperlink_base хранит базовый URL уровня документа для относительных гиперссылок. Это полезно при перемещении презентации и связанных файлов в другое место. Он отделён от отдельного свойства гиперссылки Hyperlink.external_url: изменение базы не пере‑записывает сохранённые адреса ссылок и не меняет абсолютные назначения.
Пример требует презентацию, содержащую как относительную ссылку, например target.html, так и абсолютную ссылку на файл или веб‑сайт. Он считывает текущую базу, задаёт новый базовый адрес, сохраняет и вновь открывает презентацию для проверки значения. Затем он очищает базу, задав "", и проверяет пустое значение в отдельном сохранённом файле. Замените пример базового адреса на расположение ваших связанных файлов.
import aspose.slides as slides
with slides.Presentation("hyperlinks.pptx") as presentation:
print("Original base:", presentation.document_properties.hyperlink_base)
new_base = "https://example.com/new/"
presentation.document_properties.hyperlink_base = new_base
presentation.save("hyperlinks-updated.pptx", slides.export.SaveFormat.PPTX)
with slides.Presentation("hyperlinks-updated.pptx") as updated_presentation:
print("Base preserved:", updated_presentation.document_properties.hyperlink_base == new_base)
updated_presentation.document_properties.hyperlink_base = ""
updated_presentation.save("hyperlinks-cleared.pptx", slides.export.SaveFormat.PPTX)
with slides.Presentation("hyperlinks-cleared.pptx") as cleared_presentation:
print("Base cleared:", cleared_presentation.document_properties.hyperlink_base == "")
Два сообщения проверки должны вывести True. Очистка базы оставляет отдельные адреса гиперссылок неизменными.
Относительная ссылка на target.pptx открывала old/target.pptx, когда база указывала на папку old. После изменения базы на папку new, сохранения и повторного открытия презентации та же ссылка открывала new/target.pptx. Абсолютная ссылка продолжала открываться к тому же файлу. Проверьте свои относительные ссылки в PowerPoint до и после перемещения презентации или изменения её базы.
Добавление пользовательских свойств презентации
Пользовательские свойства хранят метаданные, не имеющие соответствующего встроенного поля. Метод DocumentProperties.set_custom_property_value позволяет задать значение по имени свойства. Этот пример создаёт презентацию, добавляет два текстовых значения и целочисленное значение версии, и сохраняет презентацию с помощью Presentation.save. Присвоение значения существующему имени заменяет значение свойства.
import aspose.slides as slides
with slides.Presentation() as presentation:
document_properties = presentation.document_properties
document_properties.set_custom_property_value("Reviewed by", "John Smith")
document_properties.set_custom_property_value("Confidentiality level", "Internal")
document_properties.set_custom_property_value("Document version", 2)
presentation.save("CustomDocumentProperties_output.pptx", slides.export.SaveFormat.PPTX)
Доступ и изменение пользовательских свойств
Этот пример открывает презентацию, содержащую пользовательские свойства, и использует DocumentProperties.count_of_custom_properties для перебора их. DocumentProperties.get_custom_property_name принимает нулевой индекс и возвращает имя, используемое в DocumentProperties.set_custom_property_value. Пример требует презентацию, у которой все пользовательские свойства представлены строками. Он выводит каждое оригинальное имя и значение, заменяет каждое значение на нумерованную строку и сохраняет изменения. Если пользовательских свойств нет, цикл не вносит изменений.
import aspose.slides as slides
with slides.Presentation("AccessAndModifyProperties.pptx") as presentation:
document_properties = presentation.document_properties
for i in range(document_properties.count_of_custom_properties):
property_name = document_properties.get_custom_property_name(i)
property_value = [""]
document_properties.get_custom_property_value(property_name, property_value)
print("Custom property name:", property_name)
print("Custom property value:", property_value[0])
document_properties.set_custom_property_value(property_name, "New Value " + str(i + 1))
presentation.save("CustomProperties_output.pptx", slides.export.SaveFormat.PPTX)
DocumentProperties.get_custom_property_value возвращает значение через одноэлементный список, переданный вторым аргументом. Заполнитель должен соответствовать типу сохраняемого свойства: используйте [""] для строки или [0] для целого числа. Несоответствие типов вызывает InvalidCastException; выбирайте заполнитель согласно схеме ваших пользовательских свойств.
Живой пример
Попробуйте онлайн‑приложение Просмотр и редактирование метаданных PowerPoint, чтобы увидеть, как работать со свойствами документа с помощью API Aspose.Slides:
Вопросы и ответы
Как удалить встроенное свойство из презентации?
Встроенные свойства являются неотъемлемой частью презентации и полностью удалить их нельзя. Однако вы можете изменить их значения или задать им пустое значение, если это допускает конкретное свойство.
Что происходит, если я добавляю пользовательское свойство, которое уже существует?
Если вы добавляете пользовательское свойство, которое уже существует, его текущее значение будет перезаписано новым. Не требуется удалять или проверять свойство заранее, так как Aspose.Slides автоматически обновит значение свойства.
Могу ли я получить доступ к свойствам презентации без полной загрузки презентации?
Да. Используйте PresentationFactory.get_presentation_info и затем PresentationInfo.read_document_properties, чтобы прочитать сохранённые метаданные документа без создания экземпляра Presentation. См. Build a Lightweight Presentation Inventory для полного примера отчёта и ограничений, зависящих от формата.
Могу ли я прочитать публичные свойства зашифрованной презентации без пароля открытия?
Да. Презентация должна быть зашифрована с параметром ProtectionManager.encrypt_document_properties = False, и должна быть загружена с LoadOptions.only_load_document_properties = True.
Могу ли я обновить зашифрованный файл PPTX в режиме только свойств документа?
Нет. Публичные и зашифрованные данные свойств должны оставаться согласованными, поэтому обновление зашифрованного файла PPTX требует полной загрузки презентации с правильным паролем открытия.
