# JavaScript에서 PowerPoint 프레젠테이션의 민감도 레이블 관리

> Aspose.Slides for Node.js via Java를 사용하여 PowerPoint PPTX 프레젠테이션에서 Microsoft Purview 민감도 레이블을 읽고, 추가하고, 업데이트하고, 제거하며, 마이그레이션합니다.

Source: https://docs.aspose.com/slides/ko/nodejs-java/sensitivity-labels/
Updated: 2026-09-02

## **개요**

Microsoft Purview 민감도 레이블은 조직이 문서를 분류하고 관리하도록 도와줍니다. 자동 프레젠테이션 처리 중에 애플리케이션은 기존 레이블을 보존하거나 정책에 의해 선택된 레이블을 적용하고, 상태를 업데이트하거나 오래된 Microsoft Information Protection (MIP) 워크플로우에서 작성된 레이블 메타데이터를 마이그레이션해야 할 수 있습니다.

Aspose.Slides for Node.js via Java는 최신 민감도 레이블 메타데이터를 [Presentation.getSensitivityLabels](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/presentation/#getSensitivityLabels) 를 통해 노출합니다. 이 메서드는 [SensitivityLabelCollection](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabelcollection/) 을 반환하며, 프레젠테이션을 PPTX 로 저장하기 전에 검토하고 수정할 수 있습니다.

{{% alert color="primary" title="참고" %}}
민감도 레이블 식별자와 정책 정보는 Microsoft Purview 구성에 의해 정의됩니다. 메타데이터를 추가하거나 마이그레이션하기 전에 환경에서 레이블 가용성 및 정책 요구 사항을 확인하십시오. [SensitivityLabel.getContentMarkTypes](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/#getContentMarkTypes) 값은 레이블에 연결된 콘텐츠 표시 유형을 설명하며, 슬라이드에 눈에 보이는 텍스트나 도형을 직접 추가하지는 않습니다.
{{% /alert %}}

## **민감도 레이블 속성 이해**

각 [SensitivityLabel](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/) 은 다음 메타데이터를 포함합니다:

| 메서드 | 목적 |
| --- | --- |
| [SensitivityLabel.getId](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/#getId) 및 [SensitivityLabel.setId](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/#setId) | Purview 정책에서 민감도 레이블 식별자를 가져오거나 설정합니다. |
| [SensitivityLabel.getSiteId](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/#getSiteId) 및 [SensitivityLabel.setSiteId](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/#setSiteId) | 레이블 정책과 연결된 사이트를 가져오거나 설정합니다. |
| [SensitivityLabel.isEnabled](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/#isEnabled) 및 [SensitivityLabel.setEnabled](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/#setEnabled) | 레이블이 활성화되어 있는지 여부를 가져오거나 설정합니다. |
| [SensitivityLabel.isRemoved](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/#isRemoved) 및 [SensitivityLabel.setRemoved](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/#setRemoved) | 레이블이 삭제되었는지 여부를 가져오거나 설정합니다. 메타데이터에 삭제 상태를 유지해야 할 경우 값을 `true` 로 설정하십시오. |
| [SensitivityLabel.getAssignmentMethodType](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/#getAssignmentMethodType) 및 [SensitivityLabel.setAssignmentMethodType](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/#setAssignmentMethodType) | 레이블이 자동으로 적용되었는지 또는 사용자 결정에 의해 적용되었는지를 가져오거나 설정합니다. |
| [SensitivityLabel.getContentMarkTypes](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/#getContentMarkTypes) | 레이블에 연결된 콘텐츠 표시 유형을 가져옵니다. |

[SensitivityLabelAssignmentType](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabelassignmenttype/) 클래스는 레이블이 어떻게 할당되었는지를 정의합니다:

- [SensitivityLabelAssignmentType.Standard](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabelassignmenttype/) 은 기본값이거나 자동으로 적용된 레이블을 나타냅니다.
- [SensitivityLabelAssignmentType.Privileged](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabelassignmenttype/) 은 사용자 결정에 의해 적용된 레이블을 나타내며, 수동 적용, 권장 및 필수 레이블을 포함합니다.

[SensitivityLabelContentType](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabelcontenttype/) 클래스는 레이블과 연결된 표시를 정의합니다:

| 값 | 의미 |
| --- | --- |
| [SensitivityLabelContentType.None](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabelcontenttype/) | 레이블이 기본값으로 또는 자동으로 적용되었습니다. |
| [SensitivityLabelContentType.Header](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabelcontenttype/) | 헤더 콘텐츠 표시가 레이블에 연결됩니다. |
| [SensitivityLabelContentType.Footer](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabelcontenttype/) | 푸터 콘텐츠 표시가 레이블에 연결됩니다. |
| [SensitivityLabelContentType.Watermark](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabelcontenttype/) | 워터마크 콘텐츠 표시가 레이블에 연결됩니다. |
| [SensitivityLabelContentType.Encryption](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabelcontenttype/) | 암호화 보호가 레이블에 연결됩니다. |

여러 표시 유형을 하나의 레이블에 연결할 수 있습니다.

## **기존 민감도 레이블 나열**

[Presentation.getSensitivityLabels](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/presentation/#getSensitivityLabels) 로 최신 레이블 컬렉션을 읽고 열거하십시오. 다음 예제는 각 레이블에 저장된 모든 속성과 콘텐츠 표시를 나열합니다:

```javascript
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](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabelcollection/#add) 를 호출하십시오. 메서드가 새 [SensitivityLabel](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/) 을 반환하면, [SensitivityLabel.getContentMarkTypes](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/#getContentMarkTypes) 로 반환된 목록을 통해 필요한 표시 값을 추가하십시오.

다음 예제는 푸터 및 워터마크 표시와 연결된 수동 선택 레이블을 추가하고 결과를 PPTX 로 저장합니다:

```javascript
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](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/) 값은 읽기/쓰기 가능하지만, [SensitivityLabel.getContentMarkTypes](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/#getContentMarkTypes) 로 반환된 목록은 리스트 연산을 통해 수정됩니다. 필요한 레이블을 찾은 뒤 식별자, 사이트 식별자, 활성 상태, 할당 방법, 삭제 상태 및 콘텐츠 표시 유형을 업데이트할 수 있습니다. 변경 사항을 지속하려면 프레젠테이션을 저장하십시오.

다음 예제는 첫 번째 레이블의 활성 상태와 할당 방법을 업데이트합니다:

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

## **민감도 레이블을 삭제된 것으로 표시**

레이블이 삭제된 사실을 보존하려면 해당 레이블을 찾고 [SensitivityLabel.setRemoved](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/#setRemoved) 를 `true` 로 호출하십시오. 이렇게 하면 레이블 항목이 유지되면서 삭제 상태가 기록됩니다. 최신 컬렉션에서 항목을 완전히 삭제해야 하는 경우 [SensitivityLabelCollection.removeAt](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabelcollection/#removeAt) 를 사용하고, 모든 항목을 삭제하려면 [SensitivityLabelCollection.clear](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabelcollection/#clear) 를 사용하십시오.

다음 예제는 특정 레이블을 삭제된 것으로 표시하고 업데이트된 프레젠테이션을 저장합니다:

```javascript
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](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/documentproperties/#getSensitivityLabels) 로 읽습니다. 이 메서드는 레거시 사용자 지정 속성을 구문 분석하고 [SensitivityLabel](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/) 객체 배열을 반환합니다.

메타데이터를 마이그레이션하려면 반환된 각 레이블을 [SensitivityLabelCollection.add](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabelcollection/#add) 을 통해 최신 [SensitivityLabelCollection](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabelcollection/) 에 추가하십시오. 중복 레이블 식별자를 추가하면 예외가 발생하므로, 예제에서는 복사하기 전에 대상 컬렉션을 확인합니다. 현재 Purview 정책에 아직 존재하는 레거시 레이블인지 확인하는 추가 검증을 수행할 수 있습니다.

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

마이그레이션은 구문 분석된 레이블 객체를 최신 컬렉션으로 복사합니다. 모든 사용자 지정 문서 속성을 삭제할 필요가 없으며, 관련 없는 문서 메타데이터는 그대로 유지됩니다. 최신 레이블 메타데이터를 PPTX 파일에 기록하려면 [Presentation.save](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/presentation/#save) 와 [SaveFormat.Pptx](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/saveformat/) 를 사용하십시오.

## **FAQ**

**콘텐츠 표시 유형을 추가하면 슬라이드에 눈에 보이는 헤더, 푸터 또는 워터마크가 생성됩니까?**

아니오. [SensitivityLabel.getContentMarkTypes](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/#getContentMarkTypes) 로 반환된 목록에 추가된 값은 민감도 레이블에 연결된 표시를 설명합니다. 프레젠테이션에 눈에 보이는 텍스트나 도형을 생성하지 않습니다. 워크플로우에서 해당 표시를 렌더링해야 하는 경우 별도로 슬라이드 콘텐츠를 추가하십시오.

**레이블을 삭제된 것으로 표시하는 것과 컬렉션에서 삭제하는 것의 차이점은 무엇입니까?**

[SensitivityLabel.setRemoved](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/#setRemoved) 를 `true` 로 호출하면 레이블 항목이 유지되고 삭제 상태가 기록됩니다. [SensitivityLabelCollection.removeAt](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabelcollection/#removeAt) 를 호출하면 최신 컬렉션에서 해당 항목이 삭제됩니다. 조직의 메타데이터 보존 요구 사항에 맞는 작업을 선택하십시오.

**프레젠테이션에 레거시 MIP 메타데이터와 최신 민감도 레이블을 모두 포함할 수 있나요?**

예. 레거시 레이블은 사용자 지정 문서 속성에 남아 있을 수 있으며, 최신 레이블은 [Presentation.getSensitivityLabels](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/presentation/#getSensitivityLabels) 를 통해 사용할 수 있습니다. 레거시 메타데이터를 읽으려면 [DocumentProperties.getSensitivityLabels](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/documentproperties/#getSensitivityLabels) 를 사용하고, 최신 컬렉션에 아직 존재하지 않는 유효한 레이블만 마이그레이션하십시오.

**동일 식별자를 가진 레이블을 여러 번 추가하면 어떻게 되나요?**

[SensitivityLabelCollection.add](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabelcollection/#add) 은 컬렉션에 동일 식별자를 가진 레이블이 이미 존재하면 예외를 발생시킵니다. 레이블을 추가하거나 마이그레이션하기 전에 [SensitivityLabel.getId](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/sensitivitylabel/#getId) 로 반환된 기존 값을 확인하십시오.

**업데이트된 민감도 레이블을 보존하려면 어떤 출력 형식을 사용해야 합니까?**

위 예제와 같이 [Presentation.save](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/presentation/#save) 와 [SaveFormat.Pptx](https://reference.aspose.com/slides/ko/nodejs-java/aspose.slides/saveformat/) 를 사용하여 프레젠테이션을 PPTX 로 저장하십시오.