Quản lý Nhãn Nhạy cảm trong Bản trình chiếu PowerPoint bằng Python

Trang này nói về điều gì

Đọc, thêm, cập nhật, loại bỏ và di chuyển nhãn nhạy cảm Microsoft Purview trong các bản trình chiếu PowerPoint PPTX bằng Aspose.Slides cho Python thông qua Java.

Tổng quan

Microsoft Purview sensitivity labels giúp các tổ chức phân loại và quản lý tài liệu. Trong quá trình xử lý tự động bản trình chiếu, một ứng dụng có thể cần giữ lại nhãn hiện có, áp dụng nhãn được chọn bởi chính sách, cập nhật trạng thái của nó, hoặc di chuyển siêu dữ liệu nhãn được ghi bởi quy trình Microsoft Information Protection (MIP) cũ.

Aspose.Slides cung cấp siêu dữ liệu nhãn nhạy cảm hiện đại thông qua Presentation.getSensitivityLabels. Phương thức này trả về một SensitivityLabelCollection có thể được kiểm tra và chỉnh sửa trước khi bản trình chiếu được lưu dưới dạng PPTX.

Note

Các định danh nhãn nhạy cảm và thông tin chính sách được xác định bởi cấu hình Microsoft Purview của bạn. Xác thực tính khả dụng của nhãn và yêu cầu chính sách trong môi trường của bạn trước khi thêm hoặc di chuyển siêu dữ liệu. Các giá trị của SensitivityLabel.getContentMarkTypes mô tả các đánh dấu nội dung liên kết với một nhãn; chúng không tự tạo ra văn bản hay hình dạng hiển thị trên các slide.

Hiểu các thuộc tính của Nhãn Nhạy cảm

Phương thức	Mục đích
getId và setId	Lấy hoặc đặt định danh nhãn nhạy cảm trong chính sách Purview.
getSiteId và setSiteId	Lấy hoặc đặt trang web liên kết với chính sách nhãn.
isEnabled và setEnabled	Lấy hoặc đặt trạng thái bật của nhãn.
isRemoved và setRemoved	Lấy hoặc đặt xem nhãn đã bị loại bỏ hay chưa. Đặt giá trị thành `True` khi trạng thái loại bỏ phải được giữ lại trong siêu dữ liệu.
getAssignmentMethodType và setAssignmentMethodType	Lấy hoặc đặt xem nhãn được áp dụng tự động hay thông qua quyết định của người dùng.
getContentMarkTypes	Lấy các loại đánh dấu nội dung liên kết với nhãn.

Lớp SensitivityLabelAssignmentType định nghĩa cách một nhãn được gán:

Standard đại diện cho nhãn mặc định hoặc được áp dụng tự động.
Privileged đại diện cho nhãn được áp dụng thông qua quyết định của người dùng, bao gồm nhãn được áp dụng thủ công, đề xuất và bắt buộc.

Lớp SensitivityLabelContentType định nghĩa đánh dấu liên kết với một nhãn:

Giá trị	Ý nghĩa
None	Nhãn được áp dụng mặc định hoặc tự động.
Header	Đánh dấu nội dung đầu trang được liên kết với nhãn.
Footer	Đánh dấu nội dung chân trang được liên kết với nhãn.
Watermark	Đánh dấu nội dung watermark được liên kết với nhãn.
Encryption	Bảo vệ mã hoá được liên kết với nhãn.

Nhiều loại đánh dấu có thể được liên kết với một nhãn.

Liệt kê các Nhãn Nhạy cảm hiện có

Đọc bộ sưu tập nhãn hiện đại từ Presentation.getSensitivityLabels và liệt kê nó. Ví dụ sau liệt kê mọi thuộc tính và đánh dấu nội dung được lưu cho mỗi nhãn:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

presentation = Presentation("presentation.pptx")
try:
    sensitivity_labels = presentation.getSensitivityLabels()

    for sensitivity_label in sensitivity_labels:
        print("Label ID:", sensitivity_label.getId())
        print("Site ID:", sensitivity_label.getSiteId())
        print("Enabled:", sensitivity_label.isEnabled())
        print("Removed:", sensitivity_label.isRemoved())
        print("Assignment method:", sensitivity_label.getAssignmentMethodType())

        for content_mark_type in sensitivity_label.getContentMarkTypes():
            print("Content marking:", content_mark_type)
finally:
    presentation.dispose()

Thêm Nhãn Nhạy cảm với Đánh dấu Nội dung

Sử dụng SensitivityLabelCollection.add với định danh nhãn, định danh trang, trạng thái bật và phương thức gán. Sau khi phương thức trả về SensitivityLabel mới, thêm các giá trị đánh dấu cần thiết thông qua danh sách trả về bởi SensitivityLabel.getContentMarkTypes.

Ví dụ sau thêm một nhãn được chọn thủ công liên kết với các đánh dấu chân trang và watermark, sau đó lưu kết quả dưới dạng PPTX:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SensitivityLabelAssignmentType, SensitivityLabelContentType
from java.util import UUID

presentation = Presentation("presentation.pptx")
try:
    sensitivity_labels = presentation.getSensitivityLabels()

    label_identifier = "{11111111-2222-3333-4444-555555555555}"
    site_identifier = UUID.fromString("aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee")
    is_enabled = True
    assignment_method = SensitivityLabelAssignmentType.Privileged

    sensitivity_label = sensitivity_labels.add(label_identifier, site_identifier, is_enabled, assignment_method)

    sensitivity_label.getContentMarkTypes().addItem(jpype.JInt(SensitivityLabelContentType.Footer))
    sensitivity_label.getContentMarkTypes().addItem(jpype.JInt(SensitivityLabelContentType.Watermark))

    presentation.save("presentation_with_label.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Cập nhật Nhãn Nhạy cảm

Các giá trị của SensitivityLabel có thể đọc/ghi, ngoại trừ danh sách trả về bởi SensitivityLabel.getContentMarkTypes được sửa đổi thông qua các thao tác danh sách của nó. Sau khi tìm được nhãn cần thiết, bạn có thể cập nhật định danh, định danh trang, trạng thái bật, phương thức gán, trạng thái loại bỏ và các loại đánh dấu nội dung. Lưu bản trình chiếu để lưu các thay đổi.

Ví dụ sau cập nhật trạng thái bật và phương thức gán của nhãn đầu tiên:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SensitivityLabelAssignmentType

presentation = Presentation("presentation.pptx")
try:
    sensitivity_labels = presentation.getSensitivityLabels()

    if sensitivity_labels.getCount() > 0:
        sensitivity_label = sensitivity_labels.get_Item(0)
        sensitivity_label.setEnabled(True)
        sensitivity_label.setAssignmentMethodType(SensitivityLabelAssignmentType.Privileged)

    presentation.save("presentation_with_updated_label.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Đánh dấu Nhãn Nhạy cảm là Đã bị Loại bỏ

Để giữ lại thông tin rằng một nhãn đã bị loại bỏ, tìm nhãn và gọi SensitivityLabel.setRemoved với True. Điều này giữ lại mục nhãn đồng thời ghi lại trạng thái đã bị loại bỏ. Nếu bạn muốn xóa một mục khỏi bộ sưu tập hiện đại, sử dụng SensitivityLabelCollection.removeAt; dùng SensitivityLabelCollection.clear để xóa mọi mục.

Ví dụ sau đánh dấu một nhãn cụ thể là đã bị loại bỏ và lưu bản trình chiếu đã cập nhật:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    sensitivity_labels = presentation.getSensitivityLabels()
    target_label_identifier = "{11111111-2222-3333-4444-555555555555}"

    for sensitivity_label in sensitivity_labels:
        is_target_label = str(sensitivity_label.getId()).casefold() == target_label_identifier.casefold()

        if is_target_label:
            sensitivity_label.setRemoved(True)
            break

    presentation.save("presentation_with_removed_label.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Đọc và Di chuyển Nhãn Nhạy cảm MIP Legacy

Các quy trình dựa trên MIP cũ có thể lưu siêu dữ liệu nhãn nhạy cảm trong thuộc tính tài liệu tùy chỉnh thay vì bộ sưu tập nhãn hiện đại. Đọc siêu dữ liệu đó bằng DocumentProperties.getSensitivityLabels. Phương thức này phân tích các thuộc tính tùy chỉnh legacy và trả về một mảng các đối tượng SensitivityLabel.

Để di chuyển siêu dữ liệu, thêm mỗi nhãn trả về vào SensitivityLabelCollection hiện đại thông qua SensitivityLabelCollection.add. Vì việc thêm định danh nhãn trùng lặp sẽ gây ra ngoại lệ, ví dụ này kiểm tra bộ sưu tập đích trước khi sao chép mỗi nhãn. Bạn có thể thêm xác thực bổ sung để xác nhận mỗi nhãn legacy vẫn tồn tại trong chính sách Purview hiện tại.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("presentation_with_legacy_labels.pptx")
try:
    legacy_sensitivity_labels = presentation.getDocumentProperties().getSensitivityLabels()
    modern_sensitivity_labels = presentation.getSensitivityLabels()

    for legacy_sensitivity_label in legacy_sensitivity_labels:
        label_already_exists = False

        for modern_sensitivity_label in modern_sensitivity_labels:
            label_already_exists = str(modern_sensitivity_label.getId()).casefold() == str(legacy_sensitivity_label.getId()).casefold()

            if label_already_exists:
                break

        if not label_already_exists:
            modern_sensitivity_labels.add(legacy_sensitivity_label)

    presentation.save("presentation_with_modern_labels.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Quá trình di chuyển sao chép các đối tượng nhãn đã phân tích vào bộ sưu tập hiện đại. Nó không yêu cầu xóa tất cả các thuộc tính tài liệu tùy chỉnh, vì vậy siêu dữ liệu tài liệu không liên quan vẫn được giữ nguyên. Sử dụng Presentation.save với SaveFormat.Pptx để ghi siêu dữ liệu nhãn hiện đại vào tệp PPTX.

Câu hỏi thường gặp

Thêm loại đánh dấu nội dung có tạo ra tiêu đề, chân trang hoặc watermark hiển thị trên slide không?
Không. Các giá trị được thêm qua danh sách trả về bởi SensitivityLabel.getContentMarkTypes mô tả các đánh dấu liên kết với nhãn nhạy cảm. chúng không tạo ra văn bản hoặc hình dạng hiển thị trong bản trình chiếu. Thêm nội dung slide tương ứng riêng biệt nếu quy trình của bạn cần hiển thị các đánh dấu đó.

Sự khác biệt giữa việc đánh dấu một nhãn là đã bị loại bỏ và việc xóa nó khỏi bộ sưu tập là gì?
Gọi SensitivityLabel.setRemoved với True giữ lại mục nhãn và ghi lại trạng thái đã bị loại bỏ. Gọi SensitivityLabelCollection.removeAt xóa mục khỏi bộ sưu tập hiện đại. Chọn thao tác phù hợp với yêu cầu lưu giữ siêu dữ liệu của tổ chức bạn.

Bản trình chiếu có thể chứa cả siêu dữ liệu MIP legacy và nhãn nhạy cảm hiện đại không?
Có. Các nhãn legacy có thể vẫn tồn tại trong thuộc tính tài liệu tùy chỉnh trong khi các nhãn hiện đại có sẵn qua Presentation.getSensitivityLabels. Sử dụng DocumentProperties.getSensitivityLabels để đọc siêu dữ liệu legacy và chỉ di chuyển những nhãn hợp lệ chưa có trong bộ sưu tập hiện đại.

Điều gì xảy ra khi một nhãn có cùng định danh được thêm nhiều lần?
SensitivityLabelCollection.add ném ngoại lệ khi bộ sưu tập đã chứa nhãn có cùng định danh. Kiểm tra các giá trị hiện có được trả về bởi SensitivityLabel.getId trước khi thêm hoặc di chuyển nhãn.

Định dạng đầu ra nào nên được sử dụng để giữ lại các nhãn nhạy cảm đã cập nhật?
Lưu bản trình chiếu dưới dạng PPTX bằng cách gọi Presentation.save với SaveFormat.Pptx, như đã minh họa trong các ví dụ ở trên.

Thêm Watermark vào Bản Trình Chiếu trong Python