Zarządzanie etykietami wrażliwości w prezentacjach PowerPoint w Javie

O czym jest ta strona

Odczytuj, dodawaj, aktualizuj, usuwaj i migruj etykiety wrażliwości Microsoft Purview w prezentacjach PowerPoint PPTX przy użyciu Aspose.Slides dla Javy.

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 etykiety zapisane przez starszy przepływ pracy Microsoft Information Protection (MIP).

Aspose.Slides udostępnia nowoczesne metadane etykiet wrażliwości za pośrednictwem IPresentation.getSensitivityLabels. Metoda ta zwraca ISensitivityLabelCollection, które można przeglądać i modyfikować przed zapisaniem prezentacji jako PPTX.

Note

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

Zrozumienie właściwości etykiety wrażliwości

Każdy ISensitivityLabel zawiera następujące metadane:

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

Klasa SensitivityLabelAssignmentType określa, jak etykieta została przydzielona:

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

Klasa SensitivityLabelContentType definiuje oznaczenie powiązane z etykietą:

Wartość	Znaczenie
SensitivityLabelContentType.None	Etykieta została zastosowana domyślnie lub automatycznie.
SensitivityLabelContentType.Header	Oznaczenie treści nagłówka jest powiązane z etykietą.
SensitivityLabelContentType.Footer	Oznaczenie treści stopki jest powiązane z etykietą.
SensitivityLabelContentType.Watermark	Oznaczenie treści 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ą.

Wylistowanie istniejących etykiet wrażliwości

Odczytaj nowoczesną kolekcję etykiet za pomocą IPresentation.getSensitivityLabels i wylicz ją. Poniższy przykład wyświetla wszystkie właściwości i oznaczenia treści przechowywane dla każdej etykiety:

import com.aspose.slides.*;

Presentation presentation = new Presentation("presentation.pptx");
try {
    ISensitivityLabelCollection sensitivityLabels = presentation.getSensitivityLabels();

    for (ISensitivityLabel sensitivityLabel : sensitivityLabels) {
        System.out.println("Label ID: " + sensitivityLabel.getId());
        System.out.println("Site ID: " + sensitivityLabel.getSiteId());
        System.out.println("Enabled: " + sensitivityLabel.isEnabled());
        System.out.println("Removed: " + sensitivityLabel.isRemoved());
        System.out.println("Assignment method: " + sensitivityLabel.getAssignmentMethodType());

        for (Integer contentMarkType : sensitivityLabel.getContentMarkTypes()) {
            System.out.println("Content marking: " + contentMarkType);
        }
    }
} finally {
    presentation.dispose();
}

Dodanie etykiety wrażliwości z oznaczeniem treści

Użyj ISensitivityLabelCollection.add z identyfikatorem etykiety, identyfikatorem witryny, stanem włączenia i metodą przydziału. Po zwróceniu nowego ISensitivityLabel, dodaj wymagane wartości oznaczeń przy użyciu listy zwróconej przez ISensitivityLabel.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:

import com.aspose.slides.*;
import java.util.UUID;

Presentation presentation = new Presentation("presentation.pptx");
try {
    ISensitivityLabelCollection sensitivityLabels = presentation.getSensitivityLabels();

    String labelIdentifier = "{11111111-2222-3333-4444-555555555555}";
    UUID siteIdentifier = UUID.fromString("aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee");
    boolean isEnabled = true;
    int assignmentMethod = SensitivityLabelAssignmentType.Privileged;

    ISensitivityLabel sensitivityLabel = sensitivityLabels.add(
            labelIdentifier,
            siteIdentifier,
            isEnabled,
            assignmentMethod);

    sensitivityLabel.getContentMarkTypes().addItem(SensitivityLabelContentType.Footer);
    sensitivityLabel.getContentMarkTypes().addItem(SensitivityLabelContentType.Watermark);

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

Aktualizacja etykiety wrażliwości

Wartości ISensitivityLabel są odczytywalne i zapisywalne, z wyjątkiem listy zwróconej przez ISensitivityLabel.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ę przydziału, stan usunięcia oraz typy oznaczeń treści. Zapisz prezentację, aby zachować zmiany.

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

import com.aspose.slides.*;

Presentation presentation = new Presentation("presentation.pptx");
try {
    ISensitivityLabelCollection sensitivityLabels = presentation.getSensitivityLabels();

    if (sensitivityLabels.getCount() > 0) {
        ISensitivityLabel sensitivityLabel = sensitivityLabels.get_Item(0);
        sensitivityLabel.setEnabled(true);
        sensitivityLabel.setAssignmentMethodType(SensitivityLabelAssignmentType.Privileged);
    }

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

Oznaczenie etykiety wrażliwości jako usuniętej

Aby zachować informację, że etykieta została usunięta, znajdź etykietę i wywołaj ISensitivityLabel.setRemoved z wartością true. To zachowuje wpis etykiety, rejestrując jej stan usunięcia. Jeśli zamiast tego musisz usunąć wpis z nowoczesnej kolekcji, użyj ISensitivityLabelCollection.removeAt; użyj ISensitivityLabelCollection.clear aby usunąć wszystkie wpisy.

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

import com.aspose.slides.*;

Presentation presentation = new Presentation("presentation.pptx");
try {
    ISensitivityLabelCollection sensitivityLabels = presentation.getSensitivityLabels();
    String targetLabelIdentifier = "{11111111-2222-3333-4444-555555555555}";

    for (ISensitivityLabel sensitivityLabel : sensitivityLabels) {
        boolean isTargetLabel = sensitivityLabel.getId().equalsIgnoreCase(targetLabelIdentifier);

        if (isTargetLabel) {
            sensitivityLabel.setRemoved(true);
            break;
        }
    }

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

Odczyt i migracja starszych etykiet MIP wrażliwości

Starsze przepływy pracy oparte na MIP mogą przechowywać metadane etykiet wrażliwości w niestandardowych właściwościach dokumentu zamiast w nowoczesnej kolekcji etykiet. Odczytaj te metadane za pomocą IDocumentProperties.getSensitivityLabels. Metoda analizuje starsze niestandardowe właściwości i zwraca tablicę obiektów ISensitivityLabel.

Aby migrować metadane, dodaj każdą zwróconą etykietę do nowoczesnej ISensitivityLabelCollection za pomocą ISensitivityLabelCollection.add. Ponieważ dodanie identyfikatora etykiety, który już istnieje, 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.

import com.aspose.slides.*;

Presentation presentation = new Presentation("presentation_with_legacy_labels.pptx");
try {
    ISensitivityLabel[] legacySensitivityLabels = presentation.getDocumentProperties().getSensitivityLabels();
    ISensitivityLabelCollection modernSensitivityLabels = presentation.getSensitivityLabels();

    for (ISensitivityLabel legacySensitivityLabel : legacySensitivityLabels) {
        boolean labelAlreadyExists = false;

        for (ISensitivityLabel modernSensitivityLabel : modernSensitivityLabels) {
            labelAlreadyExists = modernSensitivityLabel.getId().equalsIgnoreCase(
                    legacySensitivityLabel.getId());

            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 niepowiązane metadane dokumentu pozostają niezmienione. Użyj IPresentation.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 poprzez listę zwróconą przez ISensitivityLabel.getContentMarkTypes opisują oznaczenia powiązane z etykietą wrażliwości. Nie tworzą one widocznego tekstu ani kształtów w prezentacji. Dodaj odpowiednią zawartość slajdu osobno, jeśli Twój przepływ pracy musi renderować te oznaczenia.

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

Wywołanie ISensitivityLabel.setRemoved z wartością true zachowuje wpis etykiety i rejestruje jej stan usunięcia. Wywołanie ISensitivityLabelCollection.removeAt usuwa wpis z nowoczesnej kolekcji. Wybierz operację odpowiadającą wymaganiom Twojej organizacji dotyczącym przechowywania metadanych.

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

Tak. Starsze etykiety mogą pozostać w niestandardowych właściwościach dokumentu, podczas gdy nowoczesne etykiety są dostępne poprzez IPresentation.getSensitivityLabels. Użyj IDocumentProperties.getSensitivityLabels , aby odczytać starsze metadane i migrować tylko te prawidłowe 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?

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

Jakiego formatu wyjściowego należy używać, aby zachować zaktualizowane etykiety wrażliwości?

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

Dodaj znaki wodne do prezentacji w Javie