Управление метками конфиденциальности в презентациях PowerPoint на C++

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

Читать, добавлять, обновлять, удалять и мигрировать метки конфиденциальности Microsoft Purview в презентациях PowerPoint PPTX с помощью Aspose.Slides для C++.

Обзор

Microsoft Purview sensitivity labels помогают организациям классифицировать и управлять документами. При автоматической обработке презентаций приложение может потребоваться сохранить существующую метку, применить метку, выбранную политикой, обновить её состояние или перенести метаданные метки, записанные более старым рабочим процессом Microsoft Information Protection (MIP).

Aspose.Slides предоставляет современные метаданные меток конфиденциальности через IPresentation::get_SensitivityLabels. Этот метод возвращает ISensitivityLabelCollection, которую можно просмотреть и изменить перед сохранением презентации в формате PPTX.

Примечание

Идентификаторы меток конфиденциальности и информация о политике определяются вашей конфигурацией Microsoft Purview. Проверьте доступность меток и требования политики в вашей среде перед добавлением или миграцией метаданных. Значения ISensitivityLabel::get_ContentMarkTypes описывают маркировки содержимого, связанные с меткой; они сами по себе не добавляют видимый текст или фигуры на слайды.

Понимание свойств метки конфиденциальности

Каждый ISensitivityLabel содержит следующие метаданные:

Доступ к свойствам	Описание
ISensitivityLabel::get_Id, ISensitivityLabel::set_Id	Идентифицирует метку конфиденциальности в политике Purview.
ISensitivityLabel::get_SiteId, ISensitivityLabel::set_SiteId	Идентифицирует сайт, связанный с политикой метки.
ISensitivityLabel::get_IsEnabled, ISensitivityLabel::set_IsEnabled	Указывает, включена ли метка.
ISensitivityLabel::get_IsRemoved, ISensitivityLabel::set_IsRemoved	Указывает, что метка была удалена. Установите значение `true`, когда состояние удаления должно сохраняться в метаданных.
ISensitivityLabel::get_AssignmentMethodType, ISensitivityLabel::set_AssignmentMethodType	Указывает, была ли метка применена автоматически или в результате решения пользователя.
ISensitivityLabel::get_ContentMarkTypes	Список типов маркировки содержимого, связанных с меткой.

Перечисление SensitivityLabelAssignmentType описывает, как была назначена метка:

SensitivityLabelAssignmentType::Standard представляет метку по умолчанию или автоматически применённую.
SensitivityLabelAssignmentType::Privileged представляет метку, применённую пользователем, включая вручную применяемые, рекомендованные и обязательные метки.

Перечисление SensitivityLabelContentType идентифицирует маркировку, связанную с меткой:

Значение	Значение
SensitivityLabelContentType::None	Метка применена по умолчанию или автоматически.
SensitivityLabelContentType::Header	К метке привязана маркировка заголовка.
SensitivityLabelContentType::Footer	К метке привязана маркировка нижнего колонтитула.
SensitivityLabelContentType::Watermark	К метке привязана маркировка водяного знака.
SensitivityLabelContentType::Encryption	К метке привязана защита шифрованием.

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

Список существующих меток конфиденциальности

Чтение современной коллекции меток из IPresentation::get_SensitivityLabels и её перечисление. В следующем примере перечисляются все свойства и маркировки содержимого, хранящиеся для каждой метки:

#include <DOM/Presentation.h>
#include <DOM/ISensitivityLabel.h>
#include <DOM/ISensitivityLabelCollection.h>
#include <DOM/SensitivityLabelAssignmentType.h>
#include <DOM/SensitivityLabelContentType.h>
#include <system/collections/ilist.h>
#include <system/console.h>
#include <system/guid.h>
#include <system/shared_ptr.h>
#include <system/string.h>

using Aspose::Slides::Presentation;
using System::Console;
using System::MakeObject;

auto presentation = MakeObject<Presentation>(u"presentation.pptx");
auto sensitivityLabels = presentation->get_SensitivityLabels();

for (auto&& sensitivityLabel : sensitivityLabels)
{
    auto labelIdentifier = sensitivityLabel->get_Id();
    auto siteIdentifier = sensitivityLabel->get_SiteId();
    auto isEnabled = sensitivityLabel->get_IsEnabled();
    auto isRemoved = sensitivityLabel->get_IsRemoved();
    auto assignmentMethod = sensitivityLabel->get_AssignmentMethodType();

    Console::WriteLine(u"Label ID: {0}", labelIdentifier);
    Console::WriteLine(u"Site ID: {0}", siteIdentifier);
    Console::WriteLine(u"Enabled: {0}", isEnabled);
    Console::WriteLine(u"Removed: {0}", isRemoved);
    Console::WriteLine(u"Assignment method: {0}", assignmentMethod);

    for (auto contentMarkType : sensitivityLabel->get_ContentMarkTypes())
    {
        Console::WriteLine(u"Content marking: {0}", contentMarkType);
    }
}

presentation->Dispose();

Добавление метки конфиденциальности с маркировкой содержимого

Используйте ISensitivityLabelCollection::Add с идентификатором метки, идентификатором сайта, состоянием включения и методом назначения. После возврата метода получаете новую ISensitivityLabel, добавьте требуемые типы маркировки через ISensitivityLabel::get_ContentMarkTypes.

В следующем примере добавляется вручную выбранная метка, связанная с маркировками нижнего колонтитула и водяного знака, после чего результат сохраняется в формате PPTX:

#include <DOM/Presentation.h>
#include <DOM/ISensitivityLabel.h>
#include <DOM/ISensitivityLabelCollection.h>
#include <DOM/SensitivityLabelAssignmentType.h>
#include <DOM/SensitivityLabelContentType.h>
#include <Export/SaveFormat.h>
#include <system/collections/ilist.h>
#include <system/guid.h>
#include <system/shared_ptr.h>

using Aspose::Slides::Presentation;
using Aspose::Slides::SensitivityLabelAssignmentType;
using Aspose::Slides::SensitivityLabelContentType;
using Aspose::Slides::Export::SaveFormat;
using System::Guid;
using System::MakeObject;

auto presentation = MakeObject<Presentation>(u"presentation.pptx");
auto sensitivityLabels = presentation->get_SensitivityLabels();

auto labelIdentifier = u"{11111111-2222-3333-4444-555555555555}";
auto siteIdentifier = Guid::Parse(u"{aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee}");
bool isEnabled = true;
auto assignmentMethod = SensitivityLabelAssignmentType::Privileged;

auto sensitivityLabel = sensitivityLabels->Add(
    labelIdentifier,
    siteIdentifier,
    isEnabled,
    assignmentMethod);

sensitivityLabel->get_ContentMarkTypes()->Add(SensitivityLabelContentType::Footer);
sensitivityLabel->get_ContentMarkTypes()->Add(SensitivityLabelContentType::Watermark);

presentation->Save(u"presentation_with_label.pptx", SaveFormat::Pptx);
presentation->Dispose();

Обновление метки конфиденциальности

Значения ISensitivityLabel доступны для чтения/записи через их методы‑получатели и методы‑установщики, за исключением коллекции, возвращаемой ISensitivityLabel::get_ContentMarkTypes, которая модифицируется через операции списка. После нахождения нужной метки вы можете обновить её идентификатор, идентификатор сайта, состояние включения, метод назначения, состояние удаления и типы маркировки содержимого. Сохраните презентацию, чтобы зафиксировать изменения.

В следующем примере обновляются состояние включения и метод назначения первой метки:

#include <DOM/Presentation.h>
#include <DOM/ISensitivityLabel.h>
#include <DOM/ISensitivityLabelCollection.h>
#include <DOM/SensitivityLabelAssignmentType.h>
#include <Export/SaveFormat.h>
#include <system/shared_ptr.h>

using Aspose::Slides::Presentation;
using Aspose::Slides::SensitivityLabelAssignmentType;
using Aspose::Slides::Export::SaveFormat;
using System::MakeObject;

auto presentation = MakeObject<Presentation>(u"presentation.pptx");
auto sensitivityLabels = presentation->get_SensitivityLabels();
int labelCount = sensitivityLabels->get_Count();

if (labelCount > 0)
{
    auto sensitivityLabel = sensitivityLabels->idx_get(0);
    sensitivityLabel->set_IsEnabled(true);
    sensitivityLabel->set_AssignmentMethodType(SensitivityLabelAssignmentType::Privileged);
}

presentation->Save(u"presentation_with_updated_label.pptx", SaveFormat::Pptx);
presentation->Dispose();

Отметка метки конфиденциальности как удалённой

Чтобы сохранить факт удаления метки, найдите её и вызовите ISensitivityLabel::set_IsRemoved с true. Это сохраняет запись о метке, фиксируя её состояние удаления. Если вместо этого необходимо удалить запись из современной коллекции, используйте ISensitivityLabelCollection::RemoveAt; для удаления всех записей используйте ISensitivityLabelCollection::Clear.

В следующем примере конкретная метка отмечается как удалённая и сохраняется обновлённая презентация:

#include <DOM/Presentation.h>
#include <DOM/ISensitivityLabel.h>
#include <DOM/ISensitivityLabelCollection.h>
#include <Export/SaveFormat.h>
#include <system/shared_ptr.h>
#include <system/string.h>
#include <system/string_comparison.h>

using Aspose::Slides::Presentation;
using Aspose::Slides::Export::SaveFormat;
using System::MakeObject;
using System::String;
using System::StringComparison;

auto presentation = MakeObject<Presentation>(u"presentation.pptx");
auto sensitivityLabels = presentation->get_SensitivityLabels();
auto targetLabelIdentifier = u"{11111111-2222-3333-4444-555555555555}";

for (auto&& sensitivityLabel : sensitivityLabels)
{
    auto labelIdentifier = sensitivityLabel->get_Id();
    bool isTargetLabel = String::Equals(
        labelIdentifier,
        targetLabelIdentifier,
        StringComparison::OrdinalIgnoreCase);

    if (isTargetLabel)
    {
        sensitivityLabel->set_IsRemoved(true);
        break;
    }
}

presentation->Save(u"presentation_with_removed_label.pptx", SaveFormat::Pptx);
presentation->Dispose();

Чтение и миграция устаревших меток MIP

Старые рабочие процессы на основе MIP могут хранить метаданные меток конфиденциальности в пользовательских свойствах документа вместо современной коллекции меток. Прочитайте эти метаданные с помощью IDocumentProperties::GetSensitivityLabels. Метод разбирает устаревшие пользовательские свойства и возвращает массив объектов ISensitivityLabel.

Для миграции метаданных добавьте каждую полученную метку в современную ISensitivityLabelCollection через ISensitivityLabelCollection::Add. Поскольку добавление дублирующего идентификатора метки вызывает исключение, пример проверяет целевую коллекцию перед копированием каждой метки. Вы можете добавить дополнительную проверку, чтобы подтвердить, что каждая устаревшая метка всё ещё существует в текущей политике Purview.

#include <DOM/Presentation.h>
#include <DOM/IDocumentProperties.h>
#include <DOM/ISensitivityLabel.h>
#include <DOM/ISensitivityLabelCollection.h>
#include <Export/SaveFormat.h>
#include <system/array.h>
#include <system/shared_ptr.h>
#include <system/string.h>
#include <system/string_comparison.h>

using Aspose::Slides::Presentation;
using Aspose::Slides::Export::SaveFormat;
using System::MakeObject;
using System::String;
using System::StringComparison;

auto presentation = MakeObject<Presentation>(u"presentation_with_legacy_labels.pptx");
auto documentProperties = presentation->get_DocumentProperties();
auto legacySensitivityLabels = documentProperties->GetSensitivityLabels();
auto modernSensitivityLabels = presentation->get_SensitivityLabels();

for (auto&& legacySensitivityLabel : legacySensitivityLabels)
{
    bool labelAlreadyExists = false;
    auto legacyLabelIdentifier = legacySensitivityLabel->get_Id();

    for (auto&& modernSensitivityLabel : modernSensitivityLabels)
    {
        auto modernLabelIdentifier = modernSensitivityLabel->get_Id();
        labelAlreadyExists = String::Equals(
            modernLabelIdentifier,
            legacyLabelIdentifier,
            StringComparison::OrdinalIgnoreCase);

        if (labelAlreadyExists)
        {
            break;
        }
    }

    if (!labelAlreadyExists)
    {
        modernSensitivityLabels->Add(legacySensitivityLabel);
    }
}

presentation->Save(u"presentation_with_modern_labels.pptx", SaveFormat::Pptx);
presentation->Dispose();

Миграция копирует разобранные объекты меток в современную коллекцию. Она не требует очистки всех пользовательских свойств документа, поэтому несвязанные метаданные остаются нетронутыми. Используйте IPresentation::Save с SaveFormat::Pptx для записи современных метаданных меток в файл PPTX.

FAQ

Создаёт ли добавление типа маркировки содержимого видимый заголовок, нижний колонтитул или водяной знак на слайдах?

Нет. Значения, добавленные через ISensitivityLabel::get_ContentMarkTypes, описывают маркировки, связанные с меткой конфиденциальности. Они не создают видимый текст или фигуры в презентации. Добавьте соответствующее содержимое слайда отдельно, если ваш рабочий процесс должен отобразить эти маркировки.

В чём разница между пометкой метки как удалённой и её удалением из коллекции?

Вызов ISensitivityLabel::set_IsRemoved с true сохраняет запись о метке и фиксирует её состояние удаления. Вызов ISensitivityLabelCollection::RemoveAt удаляет запись из современной коллекции. Выберите операцию, соответствующую требованиям вашей организации по сохранению метаданных.

Может ли презентация содержать одновременно устаревшие метаданные MIP и современные метки конфиденциальности?

Да. Устаревшие метки могут оставаться в пользовательских свойствах документа, в то время как современные метки доступны через IPresentation::get_SensitivityLabels. Используйте IDocumentProperties::GetSensitivityLabels для чтения устаревших метаданных и мигрируйте только валидные метки, которые ещё не присутствуют в современной коллекции.

Что происходит, если метка с тем же идентификатором добавляется более одного раза?

ISensitivityLabelCollection::Add бросает исключение аргумента, когда коллекция уже содержит метку с таким же идентификатором. Проверьте существующие значения ISensitivityLabel::get_Id перед добавлением или миграцией меток.

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

Сохраните презентацию как PPTX, вызвав IPresentation::Save с SaveFormat::Pptx, как показано в примерах выше.

Добавление водяных знаков в презентации на C++