مدیریت برچسب‌های حساسیت در ارائه‌های پاورپوینت با جاوا

این صفحه درباره چیست

برچسب‌های حساسیت Microsoft Purview را در ارائه‌های PPTX پاورپوینت با Aspose.Slides برای جاوا بخوانید، اضافه کنید، به‌روزرسانی کنید، حذف کنید و منتقل کنید.

بررسی کلی

Microsoft Purview sensitivity labels به سازمان‌ها کمک می‌کند تا اسناد را طبقه‌بندی و مدیریت کنند. در هنگام پردازش خودکار ارائه، ممکن است یک برنامه نیاز داشته باشد برچسب موجود را حفظ کند، برچسبی که توسط یک سیاست انتخاب شده است اعمال کند، وضعیت آن را به‌روزرسانی کند یا متادیتای برچسب نوشته‌شده توسط یک گردش کاری قدیمی Microsoft Information Protection (MIP) را منتقل کند.

Aspose.Slides متادیتای برچسب حساسیت مدرن را از طریق IPresentation.getSensitivityLabels در دسترس قرار می‌دهد. این متد یک ISensitivityLabelCollection را برمی‌گرداند که می‌توان قبل از ذخیره ارائه به صورت PPTX، آن را بررسی و تغییر داد.

Note

شناسه‌های برچسب حساسیت و اطلاعات سیاست توسط پیکربندی Microsoft Purview شما تعریف می‌شوند. قبل از افزودن یا انتقال متادیتا، دسترسی برچسب و الزامات سیاست را در محیط خود اعتبارسنجی کنید. مقادیر ISensitivityLabel.getContentMarkTypes توصیف‌کننده نشانه‌های محتوایی مرتبط با یک برچسب هستند؛ خود به خود متن یا اشکال قابل‌مشاهده‌ای به اسلایدها اضافه نمی‌کنند.

درک ویژگی‌های برچسب حساسیت

هر ISensitivityLabel شامل متادیتای زیر است:

متدها	هدف
ISensitivityLabel.getId و ISensitivityLabel.setId	دریافت یا تعیین شناسه برچسب حساسیت در سیاست Purview.
ISensitivityLabel.getSiteId و ISensitivityLabel.setSiteId	دریافت یا تعیین سایتی که به سیاست برچسب مرتبط است.
ISensitivityLabel.isEnabled و ISensitivityLabel.setEnabled	دریافت یا تعیین این که برچسب فعال است یا نه.
ISensitivityLabel.isRemoved و ISensitivityLabel.setRemoved	دریافت یا تعیین این که برچسب حذف شده است. هنگام نیاز به نگهداری وضعیت حذف در متادیتا مقدار را به `true` تنظیم کنید.
ISensitivityLabel.getAssignmentMethodType و ISensitivityLabel.setAssignmentMethodType	دریافت یا تعیین این که برچسب به‌صورت خودکار یا از طریق تصمیم کاربر اعمال شده است.
ISensitivityLabel.getContentMarkTypes	دریافت انواع نشانه‌های محتوا مرتبط با برچسب.

کلاس SensitivityLabelAssignmentType نحوه اختصاص برچسب را تعریف می‌کند:

SensitivityLabelAssignmentType.Standard نمایانگر برچسب پیش‌فرض یا به‌صورت خودکار اعمال‌شده است.
SensitivityLabelAssignmentType.Privileged نمایانگر برچسبی است که از طریق تصمیم کاربر اعمال شده است، شامل برچسب‌های دستی، پیشنهادی و اجباری.

کلاس SensitivityLabelContentType نشانه‌گذاری مرتبط با برچسب را تعریف می‌کند:

مقدار	معنی
SensitivityLabelContentType.None	برچسب به‌صورت پیش‌فرض یا خودکار اعمال شده است.
SensitivityLabelContentType.Header	نشانه‌گذاری محتوای سرصفحه با برچسب مرتبط است.
SensitivityLabelContentType.Footer	نشانه‌گذاری محتوای پاورقی با برچسب مرتبط است.
SensitivityLabelContentType.Watermark	نشانه‌گذاری محتوای واترمارک با برچسب مرتبط است.
SensitivityLabelContentType.Encryption	محافظت رمزنگاری با برچسب مرتبط است.

چندین نوع نشانه می‌توانند به یک برچسب مرتبط باشند.

فهرست برچسب‌های حساسیت موجود

مجمع برچسب‌های مدرن را از طریق IPresentation.getSensitivityLabels بخوانید و آن را پیمایش کنید. مثال زیر هر ویژگی و نشانه محتوایی ذخیره‌شده برای هر برچسب را فهرست می‌کند:

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

افزودن برچسب حساسیت با نشانه‌گذاری محتوا

از ISensitivityLabelCollection.add همراه با شناسه برچسب، شناسه سایت، وضعیت فعال بودن و روش اختصاص استفاده کنید. پس از بازگرداندن برچسب جدید ISensitivityLabel، مقادیر نشانه‌گذاری مورد نیاز را از طریق فهرست برگردانده‌شده توسط ISensitivityLabel.getContentMarkTypes اضافه کنید.

مثال زیر برچسبی که به‌صورت دستی انتخاب شده و با نشانه‌های پاورقی و واترمارک مرتبط است را اضافه می‌کند و سپس نتیجه را به صورت 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();
}

به‌روزرسانی برچسب حساسیت

مقادیر ISensitivityLabel قابل خواندن/نوشتن هستند، به‌جز اینکه فهرست برگردانده‌شده توسط ISensitivityLabel.getContentMarkTypes از طریق عملیات فهرست آن تغییر می‌کند. پس از یافتن برچسب مورد نیاز، می‌توانید شناسه، شناسه سایت، وضعیت فعال بودن، روش اختصاص، وضعیت حذف و انواع نشانه‌گذاری محتوا را به‌روزرسانی کنید. ارائه را ذخیره کنید تا تغییرات ثابت شوند.

مثال زیر وضعیت فعال بودن و روش اختصاص برچسب اول را به‌روزرسانی می‌کند:

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

علامت‌گذاری یک برچسب حساسیت به عنوان حذف‌شده

برای حفظ این واقعیت که برچسب حذف شده است، برچسب را پیدا کنید و ISensitivityLabel.setRemoved را با مقدار true فراخوانی کنید. این کار ورودی برچسب را نگه می‌دارد و وضعیت حذف آن را ثبت می‌کند. اگر به‌جای آن نیاز به حذف یک ورودی از مجموعه مدرن دارید، از ISensitivityLabelCollection.removeAt استفاده کنید؛ برای حذف همه ورودی‌ها از ISensitivityLabelCollection.clear بهره ببرید.

مثال زیر یک برچسب خاص را به‌عنوان حذف‌شده علامت‌گذاری کرده و ارائه به‌روز شده را ذخیره می‌کند:

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

خواندن و انتقال برچسب‌های حساسیت قدیمی MIP

گردش‌کارهای مبتنی بر MIP قدیمی می‌توانند متادیتای برچسب حساسیت را در ویژگی‌های سفارشی سند به جای مجموعه برچسب مدرن ذخیره کنند. این متادیتا را با IDocumentProperties.getSensitivityLabels بخوانید. این متد ویژگی‌های سفارشی قدیمی را تجزیه می‌کند و آرایه‌ای از اشیاء ISensitivityLabel را برمی‌گرداند.

برای انتقال متادیتا، هر برچسب بازگردانده‌شده را از طریق ISensitivityLabelCollection.add به ISensitivityLabelCollection مدرن اضافه کنید. از آنجا که افزودن شناسه برچسب تکراری منجر به استثنا می‌شود، مثال پیش از کپی هر برچسب مجموعه مقصد را بررسی می‌کند. می‌توانید اعتبارسنجی بیشتری اضافه کنید تا تأیید شود هر برچسب قدیمی هنوز در سیاست 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();
}

انتقال، اشیاء برچسب تجزیه‌شده را به مجموعه مدرن کپی می‌کند. نیازی به پاک‌سازی تمام ویژگی‌های سفارشی سند نیست، بنابراین متادیتای نامرتبط سند دست نخورده می‌ماند. برای نوشتن متادیتای برچسب مدرن به یک فایل PPTX از IPresentation.save همراه با SaveFormat.Pptx استفاده کنید.

پرسش‌های متداول

آیا افزودن یک نوع نشانه‌گذاری محتوا یک سرصفحه، پاورقی یا واترمارک قابل‌مشاهده در اسلایدها ایجاد می‌کند؟

خیر. مقادیری که از طریق فهرست برگردانده‌شده توسط ISensitivityLabel.getContentMarkTypes اضافه می‌شوند، نشانه‌های مرتبط با برچسب حساسیت را توصیف می‌کنند. آن‌ها متن یا اشکال قابل‌مشاهده‌ای در ارائه ایجاد نمی‌کنند. اگر گردش کار شما نیاز به نمایش این نشانه‌ها دارد، محتوای اسلاید مربوطه را جداگانه اضافه کنید.

فارق بین علامت‌گذاری برچسب به‌عنوان حذف‌شده و حذف آن از مجموعه چیست؟

فراخوانی ISensitivityLabel.setRemoved با true ورودی برچسب را نگه می‌دارد و وضعیت حذف آن را ثبت می‌کند. فراخوانی ISensitivityLabelCollection.removeAt ورودی را از مجموعه مدرن حذف می‌کند. عملیاتی را انتخاب کنید که با الزامات نگهداری متادیتای سازمان شما مطابقت داشته باشد.

آیا یک ارائه می‌تواند هم متادیتای قدیمی MIP و هم برچسب‌های حساسیت مدرن را داشته باشد؟

بله. برچسب‌های قدیمی می‌توانند در ویژگی‌های سفارشی سند باقی بمانند در حالی که برچسب‌های مدرن از طریق IPresentation.getSensitivityLabels در دسترس هستند. برای خواندن متادیتای قدیمی از IDocumentProperties.getSensitivityLabels استفاده کنید و تنها برچسب‌های معتبر که پیش از این در مجموعه مدرن وجود ندارند را منتقل کنید.

وقتی یک برچسب با همان شناسه بیش از یک بار اضافه شود چه اتفاقی می‌افتد؟

ISensitivityLabelCollection.add هنگامیکه مجموعه قبلاً حاوی برچسبی با همان شناسه باشد، یک استثنا ایجاد می‌کند. پیش از افزودن یا انتقال برچسب‌ها، مقادیر موجود را که توسط ISensitivityLabel.getId برگردانده می‌شوند، بررسی کنید.

برای حفظ برچسب‌های حساسیت به‌روز شده چه فرمت خروجی باید استفاده شود؟

ارائه را به صورت PPTX ذخیره کنید با فراخوانی IPresentation.save همراه با SaveFormat.Pptx، همان‌طور که در مثال‌های فوق نشان داده شده است.

افزودن آب‌نشان به ارائه‌ها در Java