Управление тегами и пользовательскими данными в презентациях на Android

Хранение данных в файлах презентаций

Файлы PPTX — элементы с расширением .pptx — хранятся в формате PresentationML, который является частью спецификации Office Open XML. Формат Office Open XML определяет структуру данных, содержащихся в презентациях.

Поскольку slide (слайд) является одним из элементов презентаций, slide part (часть слайда) содержит содержимое отдельного слайда. Части слайда могут иметь явные связи со многими частями — например, с пользовательскими тегами — определенными в ISO/IEC 29500.

Пользовательские данные (специфичные для презентации) или пользователь могут существовать в виде тегов (ITagCollection) и CustomXmlParts (ICustomXmlPartCollection).

Теги по сути являются парами «ключ‑строка».

Получение значений тегов

В слайдах тег соответствует методам IDocumentProperties.getKeywords() и IDocumentProperties.setKeywords(). Этот пример кода показывает, как получить значение тега с помощью Aspose.Slides для Android через Java для Presentation:

Presentation pres = new Presentation("pres.pptx");
try{
    String keywords = pres.getDocumentProperties().getKeywords();
} finally {
    if (pres != null) pres.dispose();
}

Добавление тегов в презентации

Aspose.Slides позволяет добавлять теги в презентации. Тег обычно состоит из двух элементов:

имя пользовательского свойства — MyTag
значение пользовательского свойства — My Tag Value

Если вам нужно классифицировать презентации на основе определённого правила или свойства, добавление тегов может быть полезным. Например, если вы хотите сгруппировать все презентации из стран Северной Америки, вы можете создать тег «North American» и задать соответствующие страны (США, Мексика и Канада) в качестве значений.

Этот пример кода показывает, как добавить тег к Presentation с помощью Aspose.Slides для Android через Java:

Presentation pres = new Presentation("pres.pptx");
try {
    ITagCollection tags = pres.getCustomData().getTags();
    pres.getCustomData().getTags().set_Item("MyTag", "My Tag Value");
} finally {
    if (pres != null) pres.dispose();
}

Теги также можно задать для Slide:

Presentation pres = new Presentation();
try {
    ISlide slide = pres.getSlides().get_Item(0);
    slide.getCustomData().getTags().set_Item("tag", "value");
} finally {
    if (pres != null) pres.dispose();
}

Или для любого отдельного Shape:

Presentation pres = new Presentation();
try {
    ISlide slide = pres.getSlides().get_Item(0);
    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 100, 50);
    shape.getTextFrame().setText("My text");
    shape.getCustomData().getTags().set_Item("tag", "value");
} finally {
    if (pres != null) pres.dispose();
}

Ограничения

Теги, добавленные через коллекцию пользовательских тегов с помощью getCustomData().getTags(), сохраняются только в файле PowerPoint. Они не переносятся в структуру тегов PDF при экспорте презентации в PDF. Следовательно, пользовательский идентификатор, заданный как тег, нельзя получить из PDF с тегами.

Обходной путь: Вы можете сохранить пользовательский идентификатор в Alt Text объекта (например, shape.setAlternativeText("MyId")). После экспорта в PDF Alt Text может появиться в структуре тегов PDF.

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

Можно ли удалить все теги из презентации, слайда или фигуры одним действием?

Да. Коллекция тегов поддерживает операцию clear , которая удаляет все пары ключ‑значение одновременно.

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

Используйте операцию remove(name) на коллекции тегов, чтобы удалить тег по его ключу.

Как получить полный список имён тегов для аналитики или фильтрации?

Вызовите getNamesOfTags у коллекции тегов; он возвращает массив всех имён тегов.

Таблица PowerPoint