Zarządzaj etykietami poufności w prezentacjach PowerPoint w PHP

O czym jest ta strona

Odczyt, dodawanie, aktualizacja, usuwanie i migracja etykiet poufności Microsoft Purview w prezentacjach PowerPoint PPTX w PHP.

Przegląd

Microsoft Purview sensitivity labels pomagają organizacjom klasyfikować i zarządzać dokumentami. Podczas automatycznego przetwarzania prezentacji aplikacja może potrzebować zachować istniejącą etykietę, zastosować etykietę wybraną przez politykę, zaktualizować jej stan lub migrować metadane etykiet zapisane przez starszy przepływ pracy Microsoft Information Protection (MIP).

Aspose.Slides for PHP via Java udostępnia nowoczesne metadane etykiet poufności poprzez Presentation::getSensitivityLabels. Ta metoda zwraca SensitivityLabelCollection, którą można przeglądać i modyfikować przed zapisaniem prezentacji jako PPTX.

Uwaga

Identyfikatory etykiet poufności i informacje o polityce są definiowane w konfiguracji Microsoft Purview. Zweryfikuj dostępność etykiet i wymagania polityki w swoim środowisku przed dodaniem lub migracją metadanych. Wartości SensitivityLabel::getContentMarkTypes opisują oznaczenia treści powiązane z etykietą; same w sobie nie dodają widocznego tekstu ani kształtów do slajdów.

Zrozum właściwości etykiet poufności

Każda SensitivityLabel zawiera następujące metadane:

Metody	Cel
SensitivityLabel::getId i SensitivityLabel::setId	Pobierz lub ustaw identyfikator etykiety poufności w polityce Purview.
SensitivityLabel::getSiteId i SensitivityLabel::setSiteId	Pobierz lub ustaw witrynę powiązaną z polityką etykiety.
SensitivityLabel::isEnabled i SensitivityLabel::setEnabled	Pobierz lub ustaw, czy etykieta jest włączona.
SensitivityLabel::isRemoved i SensitivityLabel::setRemoved	Pobierz lub ustaw, czy etykieta została usunięta. Ustaw wartość na `true`, gdy stan usunięcia ma być zachowany w metadanych.
SensitivityLabel::getAssignmentMethodType i SensitivityLabel::setAssignmentMethodType	Pobierz lub ustaw, czy etykieta została zastosowana automatycznie czy w wyniku decyzji użytkownika.
SensitivityLabel::getContentMarkTypes	Pobierz typy oznaczeń treści powiązane z etykietą.

Klasa SensitivityLabelAssignmentType definiuje sposób przypisania etykiety:

SensitivityLabelAssignmentType::Standard reprezentuje etykietę domyślną lub zastosowaną automatycznie.
SensitivityLabelAssignmentType::Privileged reprezentuje etykietę zastosowaną w wyniku decyzji użytkownika, w tym ręcznie zastosowane, zalecane i obowiązkowe etykiety.

Klasa SensitivityLabelContentType definiuje oznaczenie powiązane z etykietą:

Wartość	Znaczenie
SensitivityLabelContentType::None	Etykieta została zastosowana domyślnie lub automatycznie.
SensitivityLabelContentType::Header	Oznaczenie nagłówka jest powiązane z etykietą.
SensitivityLabelContentType::Footer	Oznaczenie stopki jest powiązane z etykietą.
SensitivityLabelContentType::Watermark	Oznaczenie znaku wodnego jest powiązane z etykietą.
SensitivityLabelContentType::Encryption	Ochrona szyfrowaniem jest powiązana z etykietą.

Wiele typów oznaczeń może być powiązanych z jedną etykietą.

Wymień istniejące etykiety poufności

Odczytaj nowoczesną kolekcję etykiet z Presentation::getSensitivityLabels i wylicz ją. Poniższy przykład wymienia wszystkie właściwości i oznaczenia treści przechowywane dla każdej etykiety:

$presentation = new Presentation("presentation.pptx");
try {
    $sensitivityLabels = $presentation->getSensitivityLabels();
    $sensitivityLabelCount = java_values($sensitivityLabels->getCount());

    for ($labelIndex = 0; $labelIndex < $sensitivityLabelCount; $labelIndex++) {
        $sensitivityLabel = $sensitivityLabels->get_Item($labelIndex);

        echo "Label ID: " . java_values($sensitivityLabel->getId()) . PHP_EOL;
        echo "Site ID: " . java_values($sensitivityLabel->getSiteId()->toString()) . PHP_EOL;
        echo "Enabled: " . (java_values($sensitivityLabel->isEnabled()) ? "true" : "false") . PHP_EOL;
        echo "Removed: " . (java_values($sensitivityLabel->isRemoved()) ? "true" : "false") . PHP_EOL;
        echo "Assignment method: " . java_values($sensitivityLabel->getAssignmentMethodType()) . PHP_EOL;

        $contentMarkIterator = $sensitivityLabel->getContentMarkTypes()->iterator();
        while (java_values($contentMarkIterator->hasNext())) {
            $contentMarkType = java_values($contentMarkIterator->next());
            echo "Content marking: " . $contentMarkType . PHP_EOL;
        }
    }
} finally {
    $presentation->dispose();
}

Dodaj etykietę poufności z oznaczeniem treści

Użyj SensitivityLabelCollection::add z identyfikatorem etykiety, identyfikatorem witryny, stanem włączenia i metodą przypisania. Po zwróceniu nowej SensitivityLabel dodaj wymagane wartości oznaczeń za pomocą listy zwróconej przez SensitivityLabel::getContentMarkTypes.

Poniższy przykład dodaje ręcznie wybraną etykietę powiązaną z oznaczeniami stopki i znaku wodnego, a następnie zapisuje wynik jako PPTX:

$presentation = new Presentation("presentation.pptx");
try {
    $sensitivityLabels = $presentation->getSensitivityLabels();

    $labelIdentifier = "{11111111-2222-3333-4444-555555555555}";
    $UUID = new JavaClass("java.util.UUID");
    $siteIdentifier = $UUID->fromString("aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee");
    $isEnabled = true;
    $assignmentMethod = SensitivityLabelAssignmentType::Privileged;

    $sensitivityLabel = $sensitivityLabels->add(
        $labelIdentifier,
        $siteIdentifier,
        $isEnabled,
        $assignmentMethod
    );

    $contentMarkTypes = $sensitivityLabel->getContentMarkTypes();
    $contentMarkTypes->addItem(SensitivityLabelContentType::Footer);
    $contentMarkTypes->addItem(SensitivityLabelContentType::Watermark);

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

Zaktualizuj etykietę poufności

Wartości SensitivityLabel są odczytywalne i zapisywalne, z wyjątkiem listy zwróconej przez SensitivityLabel::getContentMarkTypes, którą modyfikuje się za pomocą operacji na liście. Po znalezieniu wymaganej etykiety możesz zaktualizować jej identyfikator, identyfikator witryny, stan włączenia, metodę przypisania, stan usunięcia oraz typy oznaczeń treści. Zapisz prezentację, aby utrwalić zmiany.

Poniższy przykład aktualizuje stan włączenia i metodę przypisania pierwszej etykiety:

$presentation = new Presentation("presentation.pptx");
try {
    $sensitivityLabels = $presentation->getSensitivityLabels();
    $sensitivityLabelCount = java_values($sensitivityLabels->getCount());

    if ($sensitivityLabelCount > 0) {
        $sensitivityLabel = $sensitivityLabels->get_Item(0);
        $sensitivityLabel->setEnabled(true);
        $sensitivityLabel->setAssignmentMethodType(SensitivityLabelAssignmentType::Privileged);
    }

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

Oznacz etykietę poufności jako usuniętą

Aby zachować fakt, że etykieta została usunięta, znajdź etykietę i wywołaj SensitivityLabel::setRemoved z wartością true. Dzięki temu wpis etykiety pozostaje, a jej stan usunięcia jest zapisany. Jeśli zamiast tego musisz usunąć wpis z nowoczesnej kolekcji, użyj SensitivityLabelCollection::removeAt; użyj SensitivityLabelCollection::clear, aby usunąć wszystkie wpisy.

Poniższy przykład oznacza konkretną etykietę jako usuniętą i zapisuje zaktualizowaną prezentację:

$presentation = new Presentation("presentation.pptx");
try {
    $sensitivityLabels = $presentation->getSensitivityLabels();
    $targetLabelIdentifier = "{11111111-2222-3333-4444-555555555555}";
    $sensitivityLabelCount = java_values($sensitivityLabels->getCount());

    for ($labelIndex = 0; $labelIndex < $sensitivityLabelCount; $labelIndex++) {
        $sensitivityLabel = $sensitivityLabels->get_Item($labelIndex);
        $labelIdentifier = java_values($sensitivityLabel->getId());
        $isTargetLabel = strcasecmp($labelIdentifier, $targetLabelIdentifier) === 0;

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

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

Odczytaj i migruj starsze etykiety poufności MIP

Starsze przepływy pracy oparte na MIP mogą przechowywać metadane etykiet poufności w niestandardowych właściwościach dokumentu zamiast w nowoczesnej kolekcji etykiet. Odczytaj te metadane za pomocą DocumentProperties::getSensitivityLabels. Metoda analizuje starsze własne właściwości i zwraca tablicę Java obiektów SensitivityLabel.

Aby migrować metadane, dodaj każdą zwróconą etykietę do nowoczesnej SensitivityLabelCollection przy użyciu SensitivityLabelCollection::add. Ponieważ dodanie etykiety z powtarzającym się identyfikatorem powoduje wyjątek, przykład sprawdza docelową kolekcję przed skopiowaniem każdej etykiety. Możesz dodać dodatkową weryfikację, aby potwierdzić, że każda starsza etykieta nadal istnieje w bieżącej polityce Purview.

$presentation = new Presentation("presentation_with_legacy_labels.pptx");
try {
    $legacySensitivityLabels = $presentation->getDocumentProperties()->getSensitivityLabels();
    $modernSensitivityLabels = $presentation->getSensitivityLabels();

    $Array = new JavaClass("java.lang.reflect.Array");
    $legacyLabelCount = java_values($Array->getLength($legacySensitivityLabels));

    for ($legacyLabelIndex = 0; $legacyLabelIndex < $legacyLabelCount; $legacyLabelIndex++) {
        $legacySensitivityLabel = $legacySensitivityLabels[$legacyLabelIndex];
        $legacyLabelIdentifier = java_values($legacySensitivityLabel->getId());
        $labelAlreadyExists = false;
        $modernLabelCount = java_values($modernSensitivityLabels->getCount());

        for ($modernLabelIndex = 0; $modernLabelIndex < $modernLabelCount; $modernLabelIndex++) {
            $modernSensitivityLabel = $modernSensitivityLabels->get_Item($modernLabelIndex);
            $modernLabelIdentifier = java_values($modernSensitivityLabel->getId());
            $labelAlreadyExists = strcasecmp(
                $modernLabelIdentifier,
                $legacyLabelIdentifier
            ) === 0;

            if ($labelAlreadyExists) {
                break;
            }
        }

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

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

Migracja kopiuje przetworzone obiekty etykiet do nowoczesnej kolekcji. Nie wymaga czyszczenia wszystkich niestandardowych właściwości dokumentu, więc niezwiązane metadane pozostają nienaruszone. Użyj Presentation::save z SaveFormat::Pptx, aby zapisać nowoczesne metadane etykiet do pliku PPTX.

FAQ

Czy dodanie typu oznaczenia treści tworzy widoczny nagłówek, stopkę lub znak wodny na slajdach?

Nie. Wartości dodane za pomocą listy zwróconej przez SensitivityLabel::getContentMarkTypes opisują oznaczenia powiązane z etykietą poufności. Nie tworzą one widocznego tekstu ani kształtów w prezentacji. Dodaj odpowiednią treść slajdu osobno, jeśli Twój przepływ pracy musi wyświetlać te oznaczenia.

Jaka jest różnica między oznaczeniem etykiety jako usuniętej a jej usunięciem z kolekcji?

Wywołanie SensitivityLabel::setRemoved z wartością true zachowuje wpis etykiety i rejestruje jej stan usunięcia. Wywołanie SensitivityLabelCollection::removeAt usuwa wpis z nowoczesnej kolekcji. Wybierz operację, która odpowiada wymaganiom Twojej organizacji dotyczącym przechowywania metadanych.

Czy prezentacja może zawierać zarówno starsze metadane MIP, jak i nowoczesne etykiety poufności?

Tak. Starsze etykiety mogą pozostać w niestandardowych właściwościach dokumentu, podczas gdy nowoczesne etykiety są dostępne za pośrednictwem Presentation::getSensitivityLabels. Użyj DocumentProperties::getSensitivityLabels, aby odczytać starsze metadane i migrować tylko te etykiety, które nie są już obecne w nowoczesnej kolekcji.

Co się dzieje, gdy etykieta o tym samym identyfikatorze zostanie dodana więcej niż raz?

SensitivityLabelCollection::add zgłasza wyjątek, gdy kolekcja już zawiera etykietę o tym samym identyfikatorze. Sprawdź istniejące wartości zwrócone przez SensitivityLabel::getId przed dodaniem lub migracją etykiet.

Jaki format wyjściowy należy użyć, aby zachować zaktualizowane etykiety poufności?

Zapisz prezentację jako PPTX, wywołując Presentation::save z SaveFormat::Pptx, jak pokazano w powyższych przykładach.

Dodaj znaki wodne do prezentacji w PHP