Kelola Label Sensitivitas dalam Presentasi PowerPoint di PHP

Gambaran Umum

Microsoft Purview sensitivity labels 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 PHP via Java memungkinkan akses metadata label sensitivitas modern melalui Presentation::getSensitivityLabels. Metode ini mengembalikan SensitivityLabelCollection yang dapat diperiksa dan dimodifikasi sebelum presentasi disimpan sebagai PPTX.

Memahami Properti Label Sensitivitas

Setiap SensitivityLabel berisi metadata berikut:

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

Kelas SensitivityLabelAssignmentType mendefinisikan bagaimana label ditetapkan:

Kelas SensitivityLabelContentType mendefinisikan penandaan yang terkait dengan 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 jenis penandaan dapat terkait dengan satu label.

Daftar Label Sensitivitas yang Ada

Baca koleksi label modern dari Presentation::getSensitivityLabels dan enumerasi. Contoh berikut mencantumkan setiap properti dan penandaan konten yang disimpan untuk masing-masing label:

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

Menambahkan Label Sensitivitas dengan Penandaan Konten

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

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

Memperbarui Label Sensitivitas

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

Contoh berikut memperbarui status aktif dan metode penetapan label pertama:

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

Menandai Label Sensitivitas sebagai Dihapus

Untuk mempertahankan fakta bahwa sebuah label dihapus, temukan label tersebut dan panggil SensitivityLabel::setRemoved dengan true. Ini mempertahankan entri label sambil mencatat status penghapusannya. Jika Anda justru perlu menghapus entri dari koleksi modern, gunakan SensitivityLabelCollection::removeAt; gunakan SensitivityLabelCollection::clear untuk menghapus semua entri.

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

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

Membaca dan Memigrasikan Label Sensitivitas MIP Legacy

Alur kerja berbasis MIP lama dapat menyimpan metadata label sensitivitas dalam properti dokumen khusus alih-alih koleksi label modern. Baca metadata tersebut dengan DocumentProperties::getSensitivityLabels. Metode ini mengurai properti khusus legacy dan mengembalikan array Java berisi objek SensitivityLabel.

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

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

Migrasi menyalin objek label yang diurai ke dalam koleksi modern. Ini tidak memerlukan pengosongan semua properti dokumen khusus, sehingga metadata dokumen yang tidak terkait tetap utuh. Gunakan Presentation::save dengan SaveFormat::Pptx untuk menulis metadata label modern ke file PPTX.

FAQ

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

Tidak. Nilai yang ditambahkan melalui daftar yang dikembalikan oleh SensitivityLabel::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 SensitivityLabel::setRemoved dengan true mempertahankan entri label dan mencatat status penghapusannya. Memanggil SensitivityLabelCollection::removeAt menghapus entri dari koleksi modern. Pilih operasi yang sesuai dengan kebutuhan retensi metadata organisasi Anda.

Apakah sebuah presentasi dapat berisi metadata MIP legacy dan label sensitivitas modern sekaligus?

Ya. Label legacy dapat tetap berada dalam properti dokumen khusus sementara label modern tersedia melalui Presentation::getSensitivityLabels. Gunakan DocumentProperties::getSensitivityLabels untuk membaca metadata legacy dan memigrasikan hanya label yang valid yang belum ada dalam koleksi modern.

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

SensitivityLabelCollection::add memicu pengecualian ketika koleksi sudah berisi label dengan pengidentifikasi yang sama. Periksa nilai yang ada dengan SensitivityLabel::getId sebelum menambah atau memigrasikan label.

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

Simpan presentasi sebagai PPTX dengan memanggil Presentation::save bersama SaveFormat::Pptx, seperti yang ditunjukkan pada contoh di atas.

Menambahkan Watermark ke Presentasi dalam PHP