Node.js에서 원본 프레젠테이션 형식 결정

이 페이지의 내용

Aspose.Slides for Node.js via Java를 사용하여 Node.js에서 로드된 프레젠테이션의 원본 형식을 읽고, 감지 API를 비교하며, 파일, 스트림 및 레거시 형식을 처리합니다.

개요

프레젠테이션을 로드한 후, 원래 형식을 확인하려면 Presentation.getSourceFormat 메서드를 호출합니다. 현재 인스턴스가 로드된 형식에 따라 후속 처리가 달라지는 경우에 사용하십시오.

소스 형식은 출력 파일에 대해 선택한 SaveFormat과 다릅니다. 다른 형식으로 저장해도 기존 인스턴스의 소스 형식은 변경되지 않습니다.

파일의 소스 형식 읽기

이 예제는 기존 sample.pptx 파일이 필요합니다. 파일을 로드하고 파일 이름 대신 Presentation.getSourceFormat을 사용해 애플리케이션 처리 정책을 선택합니다. 입력 경로를 변경하여 다른 형식을 시도해 보십시오. 예제는 선택된 정책을 출력합니다; 메시지를 애플리케이션 로직으로 교체하십시오.

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

const presentation = new aspose.Presentation("sample.pptx");
try {
    switch (presentation.getSourceFormat()) {
        case aspose.SourceFormat.Ppt:
        case aspose.SourceFormat.Pps:
        case aspose.SourceFormat.Pot:
            console.log("Use the legacy PowerPoint processing policy.");
            break;
        case aspose.SourceFormat.Pptx:
            console.log("Use the standard PPTX processing policy.");
            break;
        default:
            console.log("Use the general policy for source format " + presentation.getSourceFormat() + ".");
            break;
    }
} finally {
    presentation.dispose();
}

지원되는 값 인식

SourceFormat 클래스는 다음 프레젠테이션 형식을 구분하는 정수 상수를 정의합니다. 아래 확장자는 기존 파일 이름을 재구성한 것이 아니라 일반적인 확장자입니다.

SourceFormat 값	확장자	형식
`Ppt`	`.ppt`	PowerPoint 97–2003 프레젠테이션
`Pptx`	`.pptx`	Office Open XML 프레젠테이션
`Pptm`	`.pptm`	매크로 사용 Office Open XML 프레젠테이션
`Pps`	`.pps`	PowerPoint 97–2003 슬라이드 쇼
`Ppsx`	`.ppsx`	Office Open XML 슬라이드 쇼
`Ppsm`	`.ppsm`	매크로 사용 Office Open XML 슬라이드 쇼
`Pot`	`.pot`	PowerPoint 97–2003 템플릿
`Potx`	`.potx`	Office Open XML 템플릿
`Potm`	`.potm`	매크로 사용 Office Open XML 템플릿
`Odp`	`.odp`	OpenDocument 프레젠테이션
`Otp`	`.otp`	OpenDocument 프레젠테이션 템플릿
`Fodp`	`.fodp`	Flat XML ODF 프레젠테이션
`Xml`	`.xml`	PowerPoint XML 프레젠테이션

스트림의 소스 형식 읽기

이 예제는 기존 sample.pps 파일이 필요합니다. 파일 바이트를 메모리 스트림에 읽어들이면 파일 이름 없이 받은 입력(예: 데이터베이스 값 또는 업로드된 바이트 배열)을 모델링할 수 있습니다. Presentation 생성자는 스트림만 받습니다.

const aspose = require("aspose.slides.via.java");
const java = require("java");
const fs = require("fs");

const buffer = fs.readFileSync("sample.pps");
const bytes = java.newArray("byte", Array.from(buffer));
const stream = java.newInstanceSync("java.io.ByteArrayInputStream", bytes);
try {
    const presentation = new aspose.Presentation(stream);
    try {
        console.log("Source format: " + presentation.getSourceFormat());
    } finally {
        presentation.dispose();
    }
} finally {
    stream.close();
}

PPT, PPS, POT는 동일한 기본 바이너리 형식을 사용합니다. 파일 경로로 로드할 경우 확장자를 통해 슬라이드 쇼 또는 템플릿을 구분할 수 있습니다. 파일 이름이 없으면 레거시 PPS 및 POT 내용이 SourceFormat.Ppt로 보고될 수 있습니다; 위의 PPS 예제는 SourceFormat.Ppt의 정수 값을 출력합니다.

애플리케이션에서 구분을 유지해야 한다면 원본 파일 이름이나 하위 유형 메타데이터를 별도로 보관하십시오. 확장자는 이러한 레거시 하위 유형에 대한 유용한 힌트이지만 임의의 프레젠테이션 내용을 식별하는 유일한 근거가 되어서는 안 됩니다.

로드 전후 감지 비교

파일을 완전한 프레젠테이션 객체 모델로 로드하기 전에 검사해야 할 경우 PresentationFactory.getPresentationInfo와 PresentationInfo.getLoadFormat을 사용합니다. 이미 인스턴스가 존재할 때는 Presentation.getSourceFormat을 사용합니다.

이 예제는 sample.pptx가 필요하며 각각 LoadFormat.Pptx와 SourceFormat.Pptx의 정수 값을 출력합니다. 실제 환경에서는 처리 단계에 맞는 API를 선택하십시오; 이미 로드된 프레젠테이션은 소스 형식을 얻기 위해 두 번째 검사가 필요하지 않습니다.

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

const path = "sample.pptx";
const information = aspose.PresentationFactory.getInstance().getPresentationInfo(path);
console.log("Before loading: " + information.getLoadFormat());

const presentation = new aspose.Presentation(path);
try {
    console.log("After loading: " + presentation.getSourceFormat());
} finally {
    presentation.dispose();
}

결과는 서로 다른 클래스의 상수인 LoadFormat와 SourceFormat를 사용합니다. 숫자 값을 비교하거나 모든 형식이 동일한 감지 결과를 가진다고 가정하지 마십시오. PowerPoint XML은 로드 전에는 LoadFormat.Unknown으로, 로드 후에는 SourceFormat.Xml으로 보고될 수 있습니다.

소스 형식과 출력 형식 분리 유지

이 예제는 sample.pptx가 필요하고 converted.odp를 씁니다. 원본 인스턴스를 저장하기 전후에 SourceFormat.Pptx의 정수 값을 출력합니다. ODP 출력에서 로드된 새 인스턴스만 Odp를 보고합니다.

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

const presentation = new aspose.Presentation("sample.pptx");
try {
    console.log("Before saving: " + presentation.getSourceFormat());

    presentation.save("converted.odp", aspose.SaveFormat.Odp);
    console.log("After saving: " + presentation.getSourceFormat());

    const reopened = new aspose.Presentation("converted.odp");
    try {
        console.log("Reopened output: " + reopened.getSourceFormat());
    } finally {
        reopened.dispose();
    }
} finally {
    presentation.dispose();
}

new Presentation()으로 처음부터 만든 프레젠테이션은 SourceFormat.Pptx를 보고합니다. 입력 파일이 없으며, 이는 새로 만든 인스턴스의 기본값일 뿐 PPTX 파일이 로드된 증거가 아닙니다. 구분이 중요하다면 애플리케이션이 인스턴스를 생성했는지 로드했는지 별도로 추적하십시오.

소스 형식을 확장자로 매핑

다음 예제는 sample.pptx가 필요합니다. 현재 지원되는 모든 SourceFormat 값을 일반적인 확장자로 매핑하며, 입력 파일 이름을 파싱하지 않습니다. 대체값은 인식되지 않는 값에 확장자를 조용히 할당하는 것을 방지합니다.

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

const presentation = new aspose.Presentation("sample.pptx");
try {
    let extension;
    switch (presentation.getSourceFormat()) {
        case aspose.SourceFormat.Ppt:
            extension = ".ppt";
            break;
        case aspose.SourceFormat.Pptx:
            extension = ".pptx";
            break;
        case aspose.SourceFormat.Pptm:
            extension = ".pptm";
            break;
        case aspose.SourceFormat.Pps:
            extension = ".pps";
            break;
        case aspose.SourceFormat.Ppsx:
            extension = ".ppsx";
            break;
        case aspose.SourceFormat.Ppsm:
            extension = ".ppsm";
            break;
        case aspose.SourceFormat.Pot:
            extension = ".pot";
            break;
        case aspose.SourceFormat.Potx:
            extension = ".potx";
            break;
        case aspose.SourceFormat.Potm:
            extension = ".potm";
            break;
        case aspose.SourceFormat.Odp:
            extension = ".odp";
            break;
        case aspose.SourceFormat.Otp:
            extension = ".otp";
            break;
        case aspose.SourceFormat.Fodp:
            extension = ".fodp";
            break;
        case aspose.SourceFormat.Xml:
            extension = ".xml";
            break;
        default:
            extension = null;
            break;
    }

    console.log(extension != null ? extension : "No extension mapping is available.");
} finally {
    presentation.dispose();
}

이 매핑은 파일을 변환하거나 스트림 로드 중에 손실된 레거시 PPS/POT 하위 유형을 복구하지 않습니다. 실제 저장을 위해서는 SaveFormat을 명시적으로 선택하거나 원본 형식으로 프레젠테이션 저장에서 보여지는 변환을 사용하십시오.

저장 및 재열기로 형식 확인

이 독립형 예제는 프레젠테이션을 생성하고 작업 디렉터리에 세 개의 파일을 작성하며 동일한 이름의 파일을 덮어씁니다. 각 출력 파일을 경로와 메모리 스트림을 통해 다시 엽니다. PPTX와 ODP의 경우 두 경로 모두 저장된 형식을 보고합니다. PPS의 경우 경로로 로드하면 Pps를, 파일 이름 없이 같은 바이트를 로드하면 Ppt를 보고합니다.

const aspose = require("aspose.slides.via.java");
const java = require("java");
const fs = require("fs");

const presentation = new aspose.Presentation();
try {
    const formats = [aspose.SaveFormat.Pptx, aspose.SaveFormat.Odp, aspose.SaveFormat.Pps];
    const extensions = ["pptx", "odp", "pps"];

    for (let i = 0; i < formats.length; i++) {
        const path = "roundtrip." + extensions[i];
        presentation.save(path, formats[i]);

        const fromFile = new aspose.Presentation(path);
        try {
            const buffer = fs.readFileSync(path);
            const bytes = java.newArray("byte", Array.from(buffer));
            const stream = java.newInstanceSync("java.io.ByteArrayInputStream", bytes);
            try {
                const fromStream = new aspose.Presentation(stream);
                try {
                    console.log(extensions[i] + ": file=" + fromFile.getSourceFormat() + ", stream=" + fromStream.getSourceFormat());
                } finally {
                    fromStream.dispose();
                }
            } finally {
                stream.close();
            }
        } finally {
            fromFile.dispose();
        }
    }
} finally {
    presentation.dispose();
}

다음 표는 확장자가 일치하는 프레젠테이션에 대한 소스 형식 식별을 요약합니다. 이름은 상수를 나타내며, JavaScript 예제는 해당 정수 값을 출력합니다:

저장 형식	파일 경로에서의 SourceFormat	이름 없는 스트림에서의 SourceFormat
PPT	`Ppt`	`Ppt`
PPTX, PPTM	`Pptx`, `Pptm` 각각	파일 경로와 동일
PPS	`Pps`	`Ppt`
PPSX, PPSM	`Ppsx`, `Ppsm` 각각	파일 경로와 동일
POT	`Pot`	`Ppt`
POTX, POTM	`Potx`, `Potm` 각각	파일 경로와 동일
ODP, OTP	`Odp`, `Otp` 각각	파일 경로와 동일
FODP	`Fodp`	`Fodp`
PowerPoint XML	`Xml`	`Xml`

PPS/POT 콘텐츠는 이름 없는 스트림에서 Ppt로 식별됩니다. 이 표는 형식 식별을 설명하며, 변환 중 모든 프레젠테이션 기능이 보존된다는 것을 의미하지는 않습니다.

자주 묻는 질문

PPTX에서 로드된 프레젠테이션을 ODP로 저장하면 소스 형식이 변경됩니까?

아니요. 기존 인스턴스는 여전히 Pptx를 보고합니다. 저장된 ODP 파일에서 로드된 인스턴스는 Odp를 보고합니다.

스트림이 레거시 프레젠테이션, 슬라이드 쇼 및 템플릿을 항상 구분할 수 있습니까?

아니요. PPT, PPS, POT는 바이너리 형식을 공유합니다. 구분이 필요할 경우 파일 이름이나 하위 유형 메타데이터를 별도로 보관하십시오.

프레젠테이션이 이미 로드된 경우 어떤 API를 사용해야 합니까?

Presentation.getSourceFormat을 읽으십시오. 로드 전에 검사가 필요하면 PresentationFactory.getPresentationInfo을 사용하십시오.

JavaScript에서 프레젠테이션 정보 검색 및 업데이트 JavaScript에서 프레젠테이션을 효율적으로 병합하기