Kelola Label Sensitivitas dalam Presentasi PowerPoint di Android

Tentang apa halaman ini

Baca, tambahkan, perbarui, hapus, dan migrasikan label sensitivitas Microsoft Purview dalam presentasi PPTX PowerPoint dengan Aspose.Slides untuk Android via Java.

Ikhtisar

Label sensitivitas Microsoft Purview membantu organisasi mengklasifikasikan dan mengelola dokumen. Selama pemrosesan presentasi otomatis, sebuah aplikasi mungkin perlu mempertahankan label yang ada, menerapkan label yang dipilih oleh kebijakan, memperbarui statusnya, atau memigrasikan metadata label yang ditulis oleh alur kerja Microsoft Information Protection (MIP) yang lebih lama.

Aspose.Slides for Android via Java mengekspos metadata label sensitivitas modern melalui IPresentation.getSensitivityLabels. Metode ini mengembalikan sebuah ISensitivityLabelCollection yang dapat diperiksa dan dimodifikasi sebelum presentasi disimpan sebagai PPTX.

Note

Pengidentifikasi label sensitivitas dan informasi kebijakan didefinisikan oleh konfigurasi Microsoft Purview Anda. Validasi ketersediaan label dan persyaratan kebijakan di lingkungan Anda sebelum menambahkan atau memigrasikan metadata. Nilai ISensitivityLabel.getContentMarkTypes menjelaskan penandaan konten yang terkait dengan sebuah label; nilai tersebut tidak secara langsung menambahkan teks atau bentuk yang terlihat pada slide.

Memahami Properti Label Sensitivitas

Setiap ISensitivityLabel berisi metadata berikut:

Metode	Tujuan
ISensitivityLabel.getId dan ISensitivityLabel.setId	Dapatkan atau setel pengidentifikasi label sensitivitas dalam kebijakan Purview.
ISensitivityLabel.getSiteId dan ISensitivityLabel.setSiteId	Dapatkan atau setel situs yang terkait dengan kebijakan label.
ISensitivityLabel.isEnabled dan ISensitivityLabel.setEnabled	Dapatkan atau setel apakah label diaktifkan.
ISensitivityLabel.isRemoved dan ISensitivityLabel.setRemoved	Dapatkan atau setel apakah label telah dihapus. Setel nilai ke `true` ketika keadaan penghapusan harus dipertahankan dalam metadata.
ISensitivityLabel.getAssignmentMethodType dan ISensitivityLabel.setAssignmentMethodType	Dapatkan atau setel apakah label diterapkan secara otomatis atau melalui keputusan pengguna.
ISensitivityLabel.getContentMarkTypes	Dapatkan tipe penandaan konten yang terkait dengan label.

Kelas SensitivityLabelAssignmentType mendefinisikan cara label ditetapkan:

SensitivityLabelAssignmentType.Standard mewakili label default atau yang diterapkan secara otomatis.
SensitivityLabelAssignmentType.Privileged mewakili label yang diterapkan melalui keputusan pengguna, termasuk label yang diterapkan secara manual, yang direkomendasikan, dan yang wajib.

Kelas SensitivityLabelContentType mendefinisikan penandaan yang terkait dengan sebuah label:

Nilai	Makna
SensitivityLabelContentType.None	Label diterapkan secara default atau otomatis.
SensitivityLabelContentType.Header	Penandaan konten header terkait dengan label.
SensitivityLabelContentType.Footer	Penandaan konten footer terkait dengan label.
SensitivityLabelContentType.Watermark	Penandaan konten watermark terkait dengan label.
SensitivityLabelContentType.Encryption	Perlindungan enkripsi terkait dengan label.

Beberapa tipe penandaan dapat terkait dengan satu label.

Daftar Label Sensitivitas yang Ada

Baca koleksi label modern dari IPresentation.getSensitivityLabels dan lakukan enumerasi. Contoh berikut menampilkan setiap properti dan penandaan konten yang disimpan untuk setiap label:

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();
}

Menambahkan Label Sensitivitas dengan Penandaan Konten

Gunakan ISensitivityLabelCollection.add dengan pengidentifikasi label, pengidentifikasi situs, status aktif, dan metode penetapan. Setelah metode mengembalikan ISensitivityLabel baru, tambahkan nilai penandaan yang diperlukan melalui daftar yang dikembalikan oleh ISensitivityLabel.getContentMarkTypes.

Contoh berikut menambahkan label yang dipilih secara manual dengan penandaan footer dan watermark, lalu menyimpan hasilnya sebagai 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();
}

Memperbarui Label Sensitivitas

Nilai ISensitivityLabel dapat dibaca/diedit, kecuali daftar yang dikembalikan oleh ISensitivityLabel.getContentMarkTypes dimodifikasi melalui operasi daftar. Setelah menemukan label yang diperlukan, Anda dapat memperbarui pengidentifikasinya, pengidentifikasi situs, status aktif, metode penetapan, status penghapusan, dan tipe penandaan konten. Simpan presentasi untuk mempertahankan perubahan.

Contoh berikut memperbarui status aktif dan metode penetapan label pertama:

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();
}

Menandai Label Sensitivitas sebagai Dihapus

Untuk mempertahankan fakta bahwa sebuah label telah dihapus, temukan label tersebut dan panggil ISensitivityLabel.setRemoved dengan true. Ini menjaga entri label sambil mencatat status penghapusan. Jika Anda perlu menghapus entri dari koleksi modern, gunakan ISensitivityLabelCollection.removeAt; gunakan ISensitivityLabelCollection.clear untuk menghapus semua entri.

Contoh berikut menandai label tertentu sebagai dihapus dan menyimpan presentasi yang diperbarui:

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();
}

Membaca dan Mentransfer Label Sensitivitas MIP Warisan

Alur kerja berbasis MIP yang lebih lama dapat menyimpan metadata label sensitivitas dalam properti dokumen khusus alih-alih koleksi label modern. Baca metadata tersebut dengan IDocumentProperties.getSensitivityLabels. Metode ini mengurai properti khusus warisan dan mengembalikan array objek ISensitivityLabel.

Untuk memigrasikan metadata, tambahkan setiap label yang dikembalikan ke ISensitivityLabelCollection modern melalui ISensitivityLabelCollection.add. Karena menambahkan pengidentifikasi label duplikat menyebabkan pengecualian, contoh memeriksa koleksi tujuan sebelum menyalin setiap label. Anda dapat menambahkan validasi lebih lanjut untuk memastikan setiap label warisan masih ada dalam kebijakan Purview saat ini.

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();
}

Migrasi menyalin objek label yang diurai ke dalam koleksi modern. Tidak perlu menghapus semua properti dokumen khusus, sehingga metadata dokumen yang tidak terkait tetap utuh. Gunakan IPresentation.save dengan SaveFormat.Pptx untuk menulis metadata label modern ke file PPTX.

FAQ

Apakah menambahkan tipe penandaan konten membuat header, footer, atau watermark yang terlihat pada slide?

Tidak. Nilai yang ditambahkan melalui daftar yang dikembalikan oleh ISensitivityLabel.getContentMarkTypes menggambarkan penandaan yang terkait dengan label sensitivitas. Nilai tersebut tidak membuat teks atau bentuk yang terlihat dalam presentasi. Tambahkan konten slide yang sesuai secara terpisah jika alur kerja Anda harus menampilkan penandaan tersebut.

Apa perbedaan antara menandai label sebagai dihapus dan menghapusnya dari koleksi?

Memanggil ISensitivityLabel.setRemoved dengan true mempertahankan entri label dan mencatat status penghapusannya. Memanggil ISensitivityLabelCollection.removeAt menghapus entri dari koleksi modern. Pilih operasi yang sesuai dengan persyaratan retensi metadata organisasi Anda.

Dapatkah sebuah presentasi berisi metadata MIP warisan dan label sensitivitas modern sekaligus?

Ya. Label warisan dapat tetap berada di properti dokumen khusus sementara label modern tersedia melalui IPresentation.getSensitivityLabels. Gunakan IDocumentProperties.getSensitivityLabels untuk membaca metadata warisan dan memigrasikan hanya label yang valid yang belum ada di dalam koleksi modern.

Apa yang terjadi ketika sebuah label dengan pengidentifikasi yang sama ditambahkan lebih dari satu kali?

ISensitivityLabelCollection.add menghasilkan pengecualian ketika koleksi sudah berisi label dengan pengidentifikasi yang sama. Periksa nilai yang ada yang dikembalikan oleh ISensitivityLabel.getId sebelum menambahkan atau memigrasikan label.

Format output apa yang harus digunakan untuk mempertahankan label sensitivitas yang diperbarui?

Simpan presentasi sebagai PPTX dengan memanggil IPresentation.save menggunakan SaveFormat.Pptx, seperti yang ditunjukkan pada contoh di atas.

Menambahkan Watermark ke Presentasi di Android