PHP'de PowerPoint Sunumlarında Hassasiyet Etiketlerini Yönetme

Bu sayfa ne hakkında

PHP’de PowerPoint PPTX sunumlarında Microsoft Purview hassasiyet etiketlerini okuyun, ekleyin, güncelleyin, kaldırın ve taşıyın.

Genel Bakış

Microsoft Purview hassasiyet etiketleri, kuruluşların belgeleri sınıflandırmasına ve yönetmesine yardımcı olur. Otomatik sunum işleme sırasında, bir uygulama mevcut bir etiketi korumak, bir politika tarafından seçilen bir etiketi uygulamak, durumunu güncellemek veya daha eski bir Microsoft Information Protection (MIP) iş akışı tarafından yazılmış etiket meta verilerini taşımak zorunda kalabilir.

Aspose.Slides for PHP via Java, modern hassasiyet etiketi meta verilerini Presentation::getSensitivityLabels aracılığıyla sunar. Bu yöntem, sunumu PPTX olarak kaydedilmeden önce incelenebilen ve değiştirilebilen bir SensitivityLabelCollection döndürür.

Note

Hassasiyet etiketi tanımlayıcıları ve politika bilgileri, Microsoft Purview yapılandırmanız tarafından tanımlanır. Meta verileri eklemeden veya taşımanıza önce ortamınızdaki etiket kullanılabilirliğini ve politika gereksinimlerini doğrulayın. SensitivityLabel::getContentMarkTypes değerleri, bir etiketle ilişkili içerik işaretlemelerini tanımlar; bunlar tek başına slaytlara görünür metin veya şekil eklemez.

Hassasiyet Etiketi Özelliklerini Anlama

Her bir SensitivityLabel aşağıdaki meta verilere sahiptir:

Yöntemler	Amaç
SensitivityLabel::getId and SensitivityLabel::setId	Purview politikasındaki hassasiyet etiketi tanımlayıcısını alır veya ayarlar.
SensitivityLabel::getSiteId and SensitivityLabel::setSiteId	Etiket politikasına bağlı siteyi alır veya ayarlar.
SensitivityLabel::isEnabled and SensitivityLabel::setEnabled	Etiketin etkin olup olmadığını alır veya ayarlar.
SensitivityLabel::isRemoved and SensitivityLabel::setRemoved	Etiketin kaldırılıp kaldırılmadığını alır veya ayarlar. Kaldırma durumunun meta veride korunması gerektiğinde değeri `true` olarak ayarlayın.
SensitivityLabel::getAssignmentMethodType and SensitivityLabel::setAssignmentMethodType	Etiketin otomatik olarak mı yoksa kullanıcı kararıyla mı uygulandığını alır veya ayarlar.
SensitivityLabel::getContentMarkTypes	Etiketle ilişkili içerik işaretleme türlerini alır.

SensitivityLabelAssignmentType sınıfı, bir etiketin nasıl atandığını tanımlar:

SensitivityLabelAssignmentType::Standard varsayılan veya otomatik olarak uygulanmış bir etiketi temsil eder.
SensitivityLabelAssignmentType::Privileged kullanıcı kararıyla uygulanan, manuel uygulanmış, önerilen ve zorunlu etiketler dahil olmak üzere bir etiketi temsil eder.

SensitivityLabelContentType sınıfı, bir etiketle ilişkili işaretlemeyi tanımlar:

Değer	Anlam
SensitivityLabelContentType::None	Etiket varsayılan veya otomatik olarak uygulanmıştır.
SensitivityLabelContentType::Header	Üstbilgi içerik işaretlemesi etiketle ilişkilendirilmiştir.
SensitivityLabelContentType::Footer	Altbilgi içerik işaretlemesi etiketle ilişkilendirilmiştir.
SensitivityLabelContentType::Watermark	Filigran içerik işaretlemesi etiketle ilişkilendirilmiştir.
SensitivityLabelContentType::Encryption	Şifreleme koruması etiketle ilişkilendirilmiştir.

Bir etiketle birden fazla işaretleme türü ilişkilendirilebilir.

Mevcut Hassasiyet Etiketlerini Listeleme

Modern etiket koleksiyonunu Presentation::getSensitivityLabels ile okuyun ve üzerinden döngü kurun. Aşağıdaki örnek, her etiket için saklanan tüm özellikleri ve içerik işaretlemelerini listeler:

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

İçerik İşaretlemesiyle Hassasiyet Etiketi Ekleme

SensitivityLabelCollection::add yöntemini etiket tanımlayıcısı, site tanımlayıcısı, etkin durumu ve atama yöntemi ile kullanın. Yöntem yeni bir SensitivityLabel döndürdükten sonra, gerekli işaretleme değerlerini SensitivityLabel::getContentMarkTypes tarafından döndürülen listeye ekleyin.

Aşağıdaki örnek, altbilgi ve filigran işaretlemeleriyle ilişkilendirilmiş, manuel olarak seçilmiş bir etiketi ekler ve ardından sonucu PPTX olarak kaydeder:

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

Hassasiyet Etiketini Güncelleme

[SensitivityLabel] değerleri okuma/yazma özelliktedir, ancak SensitivityLabel::getContentMarkTypes tarafından döndürülen liste, liste işlemleri aracılığıyla değiştirilir. Gerekli etiketi bulduktan sonra, tanımlayıcısını, site tanımlayıcısını, etkin durumunu, atama yöntemini, kaldırma durumunu ve içerik işaretleme türlerini güncelleyebilirsiniz. Değişiklikleri kalıcılaştırmak için sunumu kaydedin.

Aşağıdaki örnek, ilk etiketin etkin durumunu ve atama yöntemini günceller:

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

Bir Hassasiyet Etiketini Kaldırıldı Olarak İşaretleme

Bir etiketin kaldırıldığını kaydetmek için, etiketi bulun ve SensitivityLabel::setRemoved yöntemini true ile çağırın. Bu, etiketi giriş olarak tutarken kaldırılmış durumunu kaydeder. Modern koleksiyondan bir girişi silmek istiyorsanız, SensitivityLabelCollection::removeAt yöntemini kullanın; tüm girişleri silmek için SensitivityLabelCollection::clear yöntemini kullanın.

Aşağıdaki örnek, belirli bir etiketi kaldırıldı olarak işaretler ve güncellenmiş sunumu kaydeder:

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

Eski MIP Hassasiyet Etiketlerini Okuma ve Taşıma

Eski MIP tabanlı iş akışları, hassasiyet etiketi meta verilerini modern etiket koleksiyonu yerine özel belge özelliklerinde saklayabilir. Bu meta verileri DocumentProperties::getSensitivityLabels ile okuyun. Yöntem, eski özel özellikleri ayrıştırır ve bir Java dizisi olarak SensitivityLabel nesnelerini döndürür.

Meta verileri taşımak için, her döndürülen etiketi modern SensitivityLabelCollection içine SensitivityLabelCollection::add ile ekleyin. Çift etiket tanımlayıcısı eklenmesi bir istisna oluşturduğu için, örnek her etiketi kopyalamadan önce hedef koleksiyonu kontrol eder. Mevcut Purview politikasında her eski etiketin hâlâ mevcut olduğunu onaylamak için ek doğrulama ekleyebilirsiniz.

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

Taşıma, ayrıştırılan etiket nesnelerini modern koleksiyona kopyalar. Tüm özel belge özelliklerini temizlemeyi gerektirmez, böylece ilgili olmayan belge meta verileri sağlam kalır. Modern etiket meta verilerini bir PPTX dosyasına yazmak için Presentation::save ile SaveFormat::Pptx kullanın.

SSS

Bir içerik işaretleme türü eklemek, slaytlarda görünür bir üstbilgi, altbilgi veya filigran oluşturur mu?

Hayır. SensitivityLabel::getContentMarkTypes aracılığıyla listeye eklenen değerler, hassasiyet etiketiyle ilişkili işaretlemeleri tanımlar. Bunlar sunumda görünür metin veya şekil oluşturmaz. İş akışınız bu işaretlemeleri render etmesi gerekiyorsa, ilgili slayt içeriğini ayrı olarak ekleyin.

Bir etiketi kaldırıldı olarak işaretlemek ile koleksiyondan silmek arasındaki fark nedir?

[SensitivityLabel::setRemoved](https://reference.aspose.com/slides/tr/php-java/aspose.slides/sensitivitylabel/#setRemoved) yöntemini true ile çağırmak, etiket girişini tutar ve kaldırılmış durumunu kaydeder. [SensitivityLabelCollection::removeAt](https://reference.aspose.com/slides/tr/php-java/aspose.slides/sensitivitylabelcollection/#removeAt) yöntemi ise etiketi modern koleksiyondan siler. Organizasyonunuzun meta veri saklama gereksinimlerine uygun olan işlemi seçin.

Bir sunum hem eski MIP meta verilerini hem de modern hassasiyet etiketlerini içerebilir mi?

Evet. Eski etiketler özel belge özelliklerinde kalabilirken, modern etiketler Presentation::getSensitivityLabels aracılığıyla ulaşılabilir. Eski meta verileri okumak ve yalnızca modern koleksiyonda bulunmayan geçerli etiketleri taşımak için DocumentProperties::getSensitivityLabels kullanın.

Aynı tanımlayıcıya sahip bir etiket birden fazla eklendiğinde ne olur?

[SensitivityLabelCollection::add](https://reference.aspose.com/slides/tr/php-java/aspose.slides/sensitivitylabelcollection/#add) aynı tanımlayıcıya sahip bir etiket zaten koleksiyonda bulunuyorsa bir istisna oluşturur. Etiket eklemeden veya taşımadan önce [SensitivityLabel::getId](https://reference.aspose.com/slides/tr/php-java/aspose.slides/sensitivitylabel/#getId) ile mevcut değerleri kontrol edin.

Güncellenmiş hassasiyet etiketlerini korumak için hangi çıktı formatı kullanılmalıdır?

Güncellenmiş hassasiyet etiketlerini korumak için sunumu PPTX formatında, [Presentation::save](https://reference.aspose.com/slides/tr/php-java/aspose.slides/presentation/#save) ile [SaveFormat::Pptx](https://reference.aspose.com/slides/tr/php-java/aspose.slides/saveformat/) çağırarak kaydedin; yukarıdaki örneklerde gösterildiği gibi.

PHP'de Sunumlara Filigran Ekleme