在 JavaScript 中管理 PowerPoint 簡報的敏感度標籤

本頁內容簡介

使用 Aspose.Slides for Node.js via Java 在 PowerPoint PPTX 簡報中讀取、加入、更新、移除和遷移 Microsoft Purview 敏感度標籤。

概觀

Microsoft Purview 敏感度標籤可協助組織對文件進行分類和治理。在自動化簡報處理期間，應用程式可能需要保留現有標籤、套用政策所選的標籤、更新其狀態，或遷移舊版 Microsoft Information Protection (MIP) 工作流程所寫入的標籤中繼資料。

Aspose.Slides for Node.js via Java 透過 Presentation.getSensitivityLabels 釋出現代敏感度標籤中繼資料。此方法會傳回一個 SensitivityLabelCollection，可在簡報儲存為 PPTX 之前檢閱和修改。

Note

敏感度標籤識別碼與政策資訊由您的 Microsoft Purview 設定定義。在新增或遷移中繼資料之前，請先在環境中驗證標籤的可用性與政策需求。SensitivityLabel.getContentMarkTypes 值描述與標籤相關的內容標記；它們本身不會在投影片上加入可見的文字或圖形。

了解敏感度標籤屬性

每個 SensitivityLabel 都包含以下中繼資料：

方法	目的
SensitivityLabel.getId and SensitivityLabel.setId	取得或設定 Purview 政策中的敏感度標籤識別碼。
SensitivityLabel.getSiteId and SensitivityLabel.setSiteId	取得或設定與標籤政策關聯的網站。
SensitivityLabel.isEnabled and SensitivityLabel.setEnabled	取得或設定標籤是否已啟用。
SensitivityLabel.isRemoved and SensitivityLabel.setRemoved	取得或設定標籤是否已被移除。當必須在中繼資料中保留移除狀態時，將值設為 true。
SensitivityLabel.getAssignmentMethodType and SensitivityLabel.setAssignmentMethodType	取得或設定標籤是自動套用還是透過使用者決策套用。
SensitivityLabel.getContentMarkTypes	取得與標籤相關聯的內容標記類型。

SensitivityLabelAssignmentType 類別定義了標籤的分配方式：

• SensitivityLabelAssignmentType.Standard 代表預設或自動套用的標籤。
• SensitivityLabelAssignmentType.Privileged 代表透過使用者決策套用的標籤，包括手動套用、建議性以及強制性標籤。

SensitivityLabelContentType 類別定義了與標籤相關聯的標記：

值	意義
SensitivityLabelContentType.None	標籤是預設或自動套用的。
SensitivityLabelContentType.Header	頁首內容標記與標籤相關聯。
SensitivityLabelContentType.Footer	頁尾內容標記與標籤相關聯。
SensitivityLabelContentType.Watermark	浮水印內容標記與標籤相關聯。
SensitivityLabelContentType.Encryption	加密保護與標籤相關聯。

一個標籤可以關聯多種標記類型。

列舉現有敏感度標籤

從 Presentation.getSensitivityLabels 讀取現代標籤集合並列舉它。以下範例列出每個標籤所儲存的所有屬性與內容標記：

const aspose = { slides: require("aspose.slides.via.java") };

const presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    const sensitivityLabels = presentation.getSensitivityLabels();
    const labelCount = sensitivityLabels.getCount();

    for (let labelIndex = 0; labelIndex < labelCount; labelIndex++) {
        const sensitivityLabel = sensitivityLabels.get_Item(labelIndex);
        const labelIdentifier = sensitivityLabel.getId();
        const siteIdentifier = sensitivityLabel.getSiteId();
        const isEnabled = sensitivityLabel.isEnabled();
        const isRemoved = sensitivityLabel.isRemoved();
        const assignmentMethod = sensitivityLabel.getAssignmentMethodType();

        console.log("Label ID: " + labelIdentifier);
        console.log("Site ID: " + siteIdentifier);
        console.log("Enabled: " + isEnabled);
        console.log("Removed: " + isRemoved);
        console.log("Assignment method: " + assignmentMethod);

        const contentMarkTypes = sensitivityLabel.getContentMarkTypes();
        const contentMarkCount = contentMarkTypes.size();

        for (let contentMarkIndex = 0; contentMarkIndex < contentMarkCount; contentMarkIndex++) {
            const contentMarkType = contentMarkTypes.get_Item(contentMarkIndex);
            console.log("Content marking: " + contentMarkType);
        }
    }
} finally {
    presentation.dispose();
}

加入帶內容標記的敏感度標籤

使用 SensitivityLabelCollection.add 並提供標籤識別碼、網站識別碼、啟用狀態與分配方式。方法傳回新的 SensitivityLabel 後，透過 SensitivityLabel.getContentMarkTypes 回傳的清單加入所需的標記值。

以下範例加入一個手動選取且與頁尾與浮水印標記相關聯的標籤，然後將結果儲存為 PPTX：

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    const sensitivityLabels = presentation.getSensitivityLabels();

    const labelIdentifier = "{11111111-2222-3333-4444-555555555555}";
    const siteIdentifier = java.callStaticMethodSync(
        "java.util.UUID",
        "fromString",
        "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee");
    const isEnabled = true;
    const assignmentMethod = aspose.slides.SensitivityLabelAssignmentType.Privileged;

    const sensitivityLabel = sensitivityLabels.add(
        labelIdentifier,
        siteIdentifier,
        isEnabled,
        assignmentMethod);

    const contentMarkTypes = sensitivityLabel.getContentMarkTypes();
    contentMarkTypes.addItem(aspose.slides.SensitivityLabelContentType.Footer);
    contentMarkTypes.addItem(aspose.slides.SensitivityLabelContentType.Watermark);

    presentation.save("presentation_with_label.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

更新敏感度標籤

SensitivityLabel 的值皆可讀寫，唯一例外是透過其清單操作修改由 SensitivityLabel.getContentMarkTypes 回傳的清單。找到目標標籤後，您可以更新其識別碼、網站識別碼、啟用狀態、分配方式、移除狀態與內容標記類型。儲存簡報以使變更永久化。

以下範例更新第一個標籤的啟用狀態與分配方式：

const aspose = { slides: require("aspose.slides.via.java") };

const presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    const sensitivityLabels = presentation.getSensitivityLabels();
    const labelCount = sensitivityLabels.getCount();

    if (labelCount > 0) {
        const sensitivityLabel = sensitivityLabels.get_Item(0);
        sensitivityLabel.setEnabled(true);
        sensitivityLabel.setAssignmentMethodType(
            aspose.slides.SensitivityLabelAssignmentType.Privileged);
    }

    presentation.save("presentation_with_updated_label.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

將敏感度標籤標記為已移除

若要保留標籤已被移除的事實，請找到該標籤並以 true 呼叫 SensitivityLabel.setRemoved。這會保留標籤項目同時記錄其移除狀態。若您需要從現代集合中刪除項目，請使用 SensitivityLabelCollection.removeAt；若要刪除所有項目，使用 SensitivityLabelCollection.clear。

以下範例將特定標籤標記為已移除，並儲存更新後的簡報：

const aspose = { slides: require("aspose.slides.via.java") };

const presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    const sensitivityLabels = presentation.getSensitivityLabels();
    const targetLabelIdentifier = "{11111111-2222-3333-4444-555555555555}";
    const labelCount = sensitivityLabels.getCount();

    for (let labelIndex = 0; labelIndex < labelCount; labelIndex++) {
        const sensitivityLabel = sensitivityLabels.get_Item(labelIndex);
        const labelIdentifier = sensitivityLabel.getId();
        const isTargetLabel = labelIdentifier.toLowerCase() === targetLabelIdentifier.toLowerCase();

        if (isTargetLabel) {
            sensitivityLabel.setRemoved(true);
            break;
        }
    }

    presentation.save("presentation_with_removed_label.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

讀取與遷移舊版 MIP 敏感度標籤

舊版基於 MIP 的工作流程可能會將敏感度標籤中繼資料儲存在自訂文件屬性中，而非現代標籤集合。可使用 DocumentProperties.getSensitivityLabels 讀取該中繼資料。此方法會解析舊版自訂屬性並回傳 SensitivityLabel 物件的陣列。

若要遷移中繼資料，請透過 SensitivityLabelCollection.add 將每個回傳的標籤加入現代的 SensitivityLabelCollection。由於加入重複的標籤識別碼會拋出例外，範例在複製每個標籤前會先檢查目標集合。您可以加入進一步的驗證，以確認每個舊版標籤仍在目前的 Purview 政策中。

const aspose = { slides: require("aspose.slides.via.java") };

const presentation = new aspose.slides.Presentation("presentation_with_legacy_labels.pptx");
try {
    const legacySensitivityLabels = presentation.getDocumentProperties().getSensitivityLabels();
    const modernSensitivityLabels = presentation.getSensitivityLabels();

    for (let legacyLabelIndex = 0; legacyLabelIndex < legacySensitivityLabels.length; legacyLabelIndex++) {
        const legacySensitivityLabel = legacySensitivityLabels[legacyLabelIndex];
        const legacyLabelIdentifier = legacySensitivityLabel.getId();
        const modernLabelCount = modernSensitivityLabels.getCount();
        let labelAlreadyExists = false;

        for (let modernLabelIndex = 0; modernLabelIndex < modernLabelCount; modernLabelIndex++) {
            const modernSensitivityLabel = modernSensitivityLabels.get_Item(modernLabelIndex);
            const modernLabelIdentifier = modernSensitivityLabel.getId();

            labelAlreadyExists =
                modernLabelIdentifier.toLowerCase() === legacyLabelIdentifier.toLowerCase();

            if (labelAlreadyExists) {
                break;
            }
        }

        if (!labelAlreadyExists) {
            modernSensitivityLabels.add(legacySensitivityLabel);
        }
    }

    presentation.save("presentation_with_modern_labels.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

遷移會將解析出的標籤物件複製到現代集合中。此過程不需要清除所有自訂文件屬性，因而不相關的文件中繼資料保持不變。使用 Presentation.save 搭配 SaveFormat.Pptx 將現代標籤中繼資料寫入 PPTX 檔案。

常見問題

加入內容標記類型會在投影片上產生可見的頁首、頁尾或浮水印嗎？

不會。透過 SensitivityLabel.getContentMarkTypes 回傳的清單加入的值僅描述與敏感度標籤相關的標記。它們不會在簡報中產生可見的文字或圖形。若您的工作流程必須呈現這些標記，請另行加入相應的投影片內容。

將標籤標記為已移除與從集合中刪除其有何差異？

以 true 呼叫 SensitivityLabel.setRemoved 會保留標籤項目並記錄其移除狀態。呼叫 SensitivityLabelCollection.removeAt 則會從現代集合中刪除該項目。請依照組織的中繼資料保留需求選擇適當的操作。

簡報可以同時包含舊版 MIP 中繼資料與現代敏感度標籤嗎？

可以。舊版標籤可保留在自訂文件屬性中，而現代標籤則可透過 Presentation.getSensitivityLabels 取得。使用 DocumentProperties.getSensitivityLabels 讀取舊版中繼資料，僅遷移尚未出現在現代集合中的有效標籤。

當相同識別碼的標籤被多次加入時會發生什麼？

當集合已包含相同識別碼的標籤時，SensitivityLabelCollection.add 會拋出例外。加入或遷移標籤前，請先檢查由 SensitivityLabel.getId 回傳的現有值。

應使用哪種輸出格式才能保留已更新的敏感度標籤？

如上例所示，使用 Presentation.save 並搭配 SaveFormat.Pptx 以 PPTX 格式儲存簡報，即可保留已更新的敏感度標籤。