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

Введение

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

Aspose.Slides позволяет работать со свойствами документа презентации через класс DocumentProperties . Экземпляр этого класса возвращается методом Presentation::getDocumentProperties. Ниже приведены примеры, показывающие как читать, изменять и управлять этими свойствами. Предполагается, что PHP/Java Bridge и оболочка Aspose.Slides для PHP инициализированы.

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

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

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

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

Чтение открытых свойств из зашифрованной презентации

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

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

Для примера требуется зашифрованная презентация, у которой свойства документа оставлены открытыми. Он проверяет режим загрузки через ProtectionManager::isOnlyDocumentPropertiesLoaded и затем читает встроенные свойства через Presentation::getDocumentProperties:

use aspose\slides\LoadOptions;
use aspose\slides\Presentation;

$loadOptions = new LoadOptions();
$loadOptions->setOnlyLoadDocumentProperties(true);

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

        echo("Author: " . $documentProperties->getAuthor() . "\n");
        echo("Title: " . $documentProperties->getTitle() . "\n");
        echo("Keywords: " . $documentProperties->getKeywords() . "\n");
    } else {
        echo("The presentation was not loaded in document-properties-only mode." . "\n");
    }
} finally {
    $presentation->dispose();
}

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

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

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

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

use aspose\slides\LoadOptions;
use aspose\slides\Presentation;
use aspose\slides\PresentationFactory;
use aspose\slides\SaveFormat;

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

$loadOptions = new LoadOptions();
$loadOptions->setPassword("open_password");

$presentation = new Presentation($inputPath, $loadOptions);
try {
    $documentProperties = $presentation->getDocumentProperties();
    $documentProperties->setTitle("Updated Product Roadmap");
    $documentProperties->setKeywords("roadmap, planning, indexed");
    
    $presentation->save($outputPath, SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

$presentationInfo = PresentationFactory::getInstance()->getPresentationInfo($outputPath);
echo("The presentation is encrypted: " . (java_values($presentationInfo->isEncrypted()) ? "true" : "false") . "\n");

$metadataLoadOptions = new LoadOptions();
$metadataLoadOptions->setOnlyLoadDocumentProperties(true);

$metadataPresentation = new Presentation($outputPath, $metadataLoadOptions);
try {
    if (java_values($metadataPresentation->getProtectionManager()->isOnlyDocumentPropertiesLoaded())) {
        echo("Title: " . $metadataPresentation->getDocumentProperties()->getTitle() . "\n");
        echo("Keywords: " . $metadataPresentation->getDocumentProperties()->getKeywords() . "\n");
    } else {
        echo("The presentation was not loaded in document-properties-only mode." . "\n");
    }
} finally {
    $metadataPresentation->dispose();
}

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

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

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

use aspose\slides\Presentation;

$presentation = new Presentation("AccessBuiltInProperties.pptx");
try {
    $documentProperties = $presentation->getDocumentProperties();

    echo("Category: " . $documentProperties->getCategory() . "\n");
    echo("Content status: " . $documentProperties->getContentStatus() . "\n");
    echo("Creation date: " . $documentProperties->getCreatedTime() . "\n");
    echo("Author: " . $documentProperties->getAuthor() . "\n");
    echo("Comments: " . $documentProperties->getComments() . "\n");
    echo("Keywords: " . $documentProperties->getKeywords() . "\n");
    echo("Last modified by: " . $documentProperties->getLastSavedBy() . "\n");
    echo("Manager: " . $documentProperties->getManager() . "\n");
    echo("Modified date: " . $documentProperties->getLastSavedTime() . "\n");
    echo("Presentation format: " . $documentProperties->getPresentationFormat() . "\n");
    echo("Last print date: " . $documentProperties->getLastPrinted() . "\n");
    echo("Is shared between producers: " . (java_values($documentProperties->getSharedDoc()) ? "true" : "false") . "\n");
    echo("Subject: " . $documentProperties->getSubject() . "\n");
    echo("Title: " . $documentProperties->getTitle() . "\n");
} finally {
    $presentation->dispose();
}

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

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

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("ModifyBuiltInProperties.pptx");
try {
    $documentProperties = $presentation->getDocumentProperties();

    $documentProperties->setAuthor("Aspose.Slides for PHP via 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();
}

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

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

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

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("hyperlinks.pptx");
try {
    echo("Original base: " . $presentation->getDocumentProperties()->getHyperlinkBase() . "\n");

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

    $updatedPresentation = new Presentation("hyperlinks-updated.pptx");
    try {
        echo("Base preserved: " . ((string) $updatedPresentation->getDocumentProperties()->getHyperlinkBase() === $newBase ? "true" : "false") . "\n");

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

        $clearedPresentation = new Presentation("hyperlinks-cleared.pptx");
        try {
            echo("Base cleared: " . ((string) $clearedPresentation->getDocumentProperties()->getHyperlinkBase() === "" ? "true" : "false") . "\n");
        } finally {
            $clearedPresentation->dispose();
        }
    } finally {
        $updatedPresentation->dispose();
    }
} finally {
    $presentation->dispose();
}

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

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

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

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

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $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 принимает нулевой индекс и возвращает имя, использованное в DocumentProperties::set_Item. Пример выводит каждое исходное имя и значение, заменяет каждое значение нумерованной строкой независимо от исходного типа и сохраняет изменения. Если пользовательских свойств нет, цикл не делает изменений.

use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation("AccessAndModifyProperties.pptx");
try {
    $documentProperties = $presentation->getDocumentProperties();

    for ($i = 0; $i < java_values($documentProperties->getCountOfCustomProperties()); $i++) {
        $propertyName = $documentProperties->getCustomPropertyName($i);
        $propertyValue = $documentProperties->get_Item($propertyName);

        echo("Custom property name: " . $propertyName . "\n");
        echo("Custom property value: " . $propertyValue . "\n");

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

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

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

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

Просмотр и редактирование метаданных PowerPoint

Часто задаваемые вопросы

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

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

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

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

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

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

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

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

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

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