PHP로 프레젠테이션에서 OLE 관리

소개

OLE(Object Linking & Embedding)는 하나의 애플리케이션에서 생성된 데이터와 개체를 연결 또는 포함을 통해 다른 애플리케이션에 배치할 수 있게 하는 Microsoft 기술입니다.

MS Excel에서 만든 차트를 생각해 보세요. 해당 차트를 PowerPoint 슬라이드에 삽입합니다. 이 Excel 차트는 OLE 객체로 간주됩니다.

OLE 객체는 아이콘 형태로 나타날 수 있습니다. 이 경우 아이콘을 두 번 클릭하면 차트가 연관된 애플리케이션(Excel)에서 열리거나, 객체를 열거나 편집할 애플리케이션을 선택하라는 메시지가 표시됩니다.
OLE 객체는 차트 내용과 같이 실제 내용을 표시할 수 있습니다. 이 경우 차트가 PowerPoint에서 활성화되고 차트 인터페이스가 로드되며, PowerPoint 내에서 차트 데이터를 수정할 수 있습니다.

Aspose.Slides for PHP via Java은 OLE 객체를 OLE 객체 프레임(OleObjectFrame)으로 슬라이드에 삽입할 수 있게 합니다.

슬라이드에 OLE 객체 프레임 추가

Microsoft Excel에서 차트를 이미 만든 상태이며 Aspose.Slides for PHP via Java를 사용해 OLE 객체 프레임으로 슬라이드에 삽입하려는 경우 다음과 같이 할 수 있습니다:

Presentation 클래스의 인스턴스를 생성합니다.
인덱스를 통해 슬라이드 참조를 가져옵니다.
Excel 파일을 바이트 배열로 읽어들입니다.
바이트 배열 및 OLE 객체에 관한 기타 정보를 포함하여 슬라이드에 OleObjectFrame을 추가합니다.
수정된 프레젠테이션을 PPTX 파일로 저장합니다.

아래 예제에서는 Aspose.Slides for PHP via Java를 사용해 Excel 파일의 차트를 OLE 객체 프레임으로 슬라이드에 추가했습니다.
Note that the OleEmbeddedDataInfo constructor takes an embeddable object extension as a second parameter. This extension allows PowerPoint to correctly interpret the file type and choose the right application to open this OLE object.

$presentation = new Presentation();
$slideSize = $presentation->getSlideSize()->getSize();
$slide = $presentation->getSlides()->get_Item(0);

// Prepare data for the OLE object.
$fileData = file_get_contents("book.xlsx");
$dataInfo = new OleEmbeddedDataInfo($fileData, "xlsx");

// Add the OLE object frame to the slide.
$slide->getShapes()->addOleObjectFrame(0, 0, $slideSize->getWidth(), $slideSize->getHeight(), $dataInfo);

$presentation->save("output.pptx", SaveFormat::Pptx);
$presentation->dispose();

연결된 OLE 객체 프레임 추가

Aspose.Slides for PHP via Java는 데이터를 포함하지 않고 파일에 대한 링크만으로 OleObjectFrame을 추가할 수 있게 합니다.

다음 PHP 코드는 연결된 Excel 파일을 사용해 슬라이드에 OleObjectFrame을 추가하는 방법을 보여줍니다:

$presentation = new Presentation();
$slide = $presentation->getSlides()->get_Item(0);

// 연결된 Excel 파일을 사용하여 OLE 객체 프레임을 추가합니다.
$slide->getShapes()->addOleObjectFrame(20, 20, 200, 150, "Excel.Sheet.12", "book.xlsx");

$presentation->save("output.pptx", SaveFormat::Pptx);
$presentation->dispose();

OLE 객체 프레임 접근

슬라이드에 OLE 객체가 이미 포함되어 있는 경우 다음과 같이 쉽게 찾거나 접근할 수 있습니다:

Presentation 클래스의 인스턴스를 생성하여 포함된 OLE 객체가 있는 프레젠테이션을 로드합니다.
인덱스를 사용해 슬라이드 참조를 얻습니다.
OleObjectFrame 형태에 접근합니다. 예제에서는 첫 슬라이드에 하나의 형태만 있는 기존 PPTX를 사용했습니다.
OLE 객체 프레임에 접근한 후 원하는 모든 작업을 수행할 수 있습니다.

아래 예제에서는 슬라이드에 삽입된 OLE 객체 프레임(Excel 차트 객체)과 해당 파일 데이터를 접근합니다.

$presentation = new Presentation("sample.pptx");
$slide = $presentation->getSlides()->get_Item(0);
$shape = $slide->getShapes()->get_Item(0);

if (java_instanceof($shape, new JavaClass("com.aspose.slides.OleObjectFrame"))) {
    $oleFrame = $shape;
    
    // 삽입된 파일 데이터를 가져옵니다.
    $fileData = $oleFrame->getEmbeddedData()->getEmbeddedFileData();

    // 삽입된 파일의 확장자를 가져옵니다.
    $fileExtension = $oleFrame->getEmbeddedData()->getEmbeddedFileExtension();

    // ...
}

연결된 OLE 객체 프레임 속성 접근

Aspose.Slides는 연결된 OLE 객체 프레임 속성에 접근할 수 있게 합니다.

다음 PHP 코드는 OLE 객체가 연결되어 있는지 확인하고 연결된 파일의 경로를 얻는 방법을 보여줍니다:

$presentation = new Presentation("sample.ppt");
$slide = $presentation->getSlides()->get_Item(0);
$shape = $slide->getShapes()->get_Item(0);

if (java_instanceof($shape, new JavaClass("com.aspose.slides.OleObjectFrame"))) {
    $oleFrame = $shape;

    // OLE 객체가 연결되어 있는지 확인합니다.
    if (java_values($oleFrame->isObjectLink()) != 0) {
        // 연결된 파일의 전체 경로를 출력합니다.
        echo "OLE object frame is linked to: " . $oleFrame->getLinkPathLong() . PHP_EOL;

        // 존재한다면 연결된 파일의 상대 경로를 출력합니다.
        // 상대 경로는 PPT 프레젠테이션에만 포함될 수 있습니다.
        $relativePath = java_values($oleFrame->getLinkPathRelative());
        if (!is_null($relativePath) && $relativePath !== "") {
            echo "OLE object frame relative path: " . $oleFrame->getLinkPathRelative() . PHP_EOL;
        }
    }
}

$presentation->dispose();

OLE 객체 데이터 변경

이 섹션에서는 아래 코드 예제가 Aspose.Cells for PHP via Java를 사용합니다.

슬라이드에 OLE 객체가 이미 포함되어 있는 경우 다음과 같이 해당 객체에 접근하고 데이터를 수정할 수 있습니다:

Presentation 클래스의 인스턴스를 생성하여 포함된 OLE 객체가 있는 프레젠테이션을 로드합니다.
인덱스를 통해 슬라이드 참조를 얻습니다.
OleObjectFrame 형태에 접근합니다. 예제에서는 첫 슬라이드에 하나의 형태만 있는 기존 PPTX를 사용했습니다.
OLE 객체 프레임에 접근한 후 원하는 모든 작업을 수행할 수 있습니다.
Workbook 객체를 생성하고 OLE 데이터를 접근합니다.
원하는 Worksheet에 접근하여 데이터를 수정합니다.
업데이트된 Workbook을 스트림에 저장합니다.
스트림에서 OLE 객체 데이터를 교체합니다.

아래 예제에서는 슬라이드에 삽입된 OLE 객체 프레임(Excel 차트 객체)의 파일 데이터를 접근하고 차트 데이터를 업데이트하도록 수정합니다.

$presentation = new Presentation("sample.pptx");
$slide = $presentation->getSlides()->get_Item(0);
$shape = $slide->getShapes()->get_Item(0);

if (java_instanceof($shape, new JavaClass("com.aspose.slides.OleObjectFrame"))) {
    $oleFrame = $shape;

    $oleStream = new ByteArrayInputStream($oleFrame->getEmbeddedData()->getEmbeddedFileData());

    // OLE 객체 데이터를 Workbook 객체로 읽어옵니다.
    $workbook = new Workbook($oleStream);

    $newOleStream = new Java("java.io.ByteArrayOutputStream");

    // 워크북 데이터를 수정합니다.
    $workbook->getWorksheets()->get(0)->getCells()->get(0, 4)->putValue("E");
    $workbook->getWorksheets()->get(0)->getCells()->get(1, 4)->putValue(12);
    $workbook->getWorksheets()->get(0)->getCells()->get(2, 4)->putValue(14);
    $workbook->getWorksheets()->get(0)->getCells()->get(3, 4)->putValue(15);

    $fileOptions = new OoxmlSaveOptions(SaveFormat::XLSX);
    $workbook->save($newOleStream, $fileOptions);

    // OLE 프레임 객체 데이터를 변경합니다.
    $newData = new OleEmbeddedDataInfo($newOleStream->toByteArray(), $oleFrame->getEmbeddedData()->getEmbeddedFileExtension());
    $oleFrame->setEmbeddedData($newData);

    $newOleStream->close();
    $oleStream->close();
}

$presentation->save("output.pptx", SaveFormat::Pptx);
$presentation->dispose();

다른 파일 형식을 슬라이드에 삽입

Excel 차트 외에도 Aspose.Slides for PHP via Java를 사용하면 HTML, PDF, ZIP 등 다양한 파일 형식을 슬라이드에 객체로 삽입할 수 있습니다. 사용자가 삽입된 객체를 두 번 클릭하면 해당 프로그램이 자동으로 열리거나, 적절한 프로그램을 선택하라는 프롬프트가 표시됩니다.

다음 PHP 코드는 HTML과 ZIP을 슬라이드에 삽입하는 방법을 보여줍니다:

$presentation = new Presentation("sample.pptx");
$slide = $presentation->getSlides()->get_Item(0);

$htmlData = file_get_contents("sample.html");
$htmlDataInfo = new OleEmbeddedDataInfo($htmlData, "html");
$htmlOleFrame = $slide->getShapes()->addOleObjectFrame(150, 120, 50, 50, $htmlDataInfo);
$htmlOleFrame->setObjectIcon(true);

$zipData = file_get_contents("sample.zip");
$zipDataInfo = new OleEmbeddedDataInfo($zipData, "zip");
$zipOleFrame = $slide->getShapes()->addOleObjectFrame(150, 220, 50, 50, $zipDataInfo);
$zipOleFrame->setObjectIcon(true);

$presentation->save("output.pptx", SaveFormat::Pptx);
$presentation->dispose();

삽입된 객체의 파일 형식 설정

프레젠테이션 작업 중 기존 OLE 객체를 새로운 것으로 교체하거나 지원되지 않는 OLE 객체를 지원되는 것으로 교체해야 할 때가 있습니다. Aspose.Slides for PHP via Java를 사용하면 삽입된 객체의 파일 형식을 설정하여 OLE 프레임 데이터 또는 확장자를 업데이트할 수 있습니다.

다음 PHP 코드는 삽입된 OLE 객체의 파일 형식을 zip으로 설정하는 방법을 보여줍니다:

$presentation = new Presentation("sample.pptx");
$slide = $presentation->getSlides()->get_Item(0);
$oleFrame = $slide->getShapes()->get_Item(0);

$fileExtension = $oleFrame->getEmbeddedData()->getEmbeddedFileExtension();
$fileData = $oleFrame->getEmbeddedData()->getEmbeddedFileData();

echo "Current embedded file extension is: " . $fileExtension . PHP_EOL;

// 파일 형식을 ZIP으로 변경합니다.
$oleFrame->setEmbeddedData(new OleEmbeddedDataInfo($fileData, "zip"));

$presentation->save("output.pptx", SaveFormat::Pptx);
$presentation->dispose();

삽입된 객체의 아이콘 이미지 및 제목 설정

OLE 객체를 삽입하면 아이콘 이미지가 자동으로 미리 보기 형태로 추가됩니다. 이 미리 보기는 사용자가 객체에 접근하거나 열기 전에 보게 되는 이미지입니다. 특정 이미지와 텍스트를 미리 보기 요소로 사용하고 싶다면 Aspose.Slides for PHP via Java를 이용해 아이콘 이미지와 제목을 설정할 수 있습니다.

다음 PHP 코드는 삽입된 객체의 아이콘 이미지와 제목을 설정하는 방법을 보여줍니다:

$presentation = new Presentation("sample.pptx");
$slide = $presentation->getSlides()->get_Item(0);
$oleFrame = $slide->getShapes()->get_Item(0);

// 프레젠테이션 리소스에 이미지를 추가합니다.
$imageData = file_get_contents("image.png");
$oleImage = $presentation->getImages()->addImage($imageData);

// OLE 미리보기를 위한 제목과 이미지를 설정합니다.
$oleFrame->setSubstitutePictureTitle("My title");
$oleFrame->getSubstitutePictureFormat()->getPicture()->setImage($oleImage);
$oleFrame->setObjectIcon(true);

$presentation->save("output.pptx", SaveFormat::Pptx);
$presentation->dispose();

OLE 객체 프레임이 크기 조정 및 위치 변경되는 것을 방지

연결된 OLE 객체를 프레젠테이션 슬라이드에 추가한 뒤 PowerPoint에서 프레젠테이션을 열면 링크 업데이트 메시지가 표시될 수 있습니다. “Update Links” 버튼을 클릭하면 PowerPoint가 연결된 OLE 객체의 데이터를 업데이트하고 미리 보기를 새로 고치면서 OLE 객체 프레임의 크기와 위치가 변경될 수 있습니다. PowerPoint가 객체 데이터를 업데이트하도록 요청하는 것을 방지하려면 OleObjectFrame 클래스의 setUpdateAutomatic 메서드를 false로 설정합니다:

$oleFrame->setUpdateAutomatic(false);

삽입된 파일 추출

Aspose.Slides for PHP via Java를 사용하면 슬라이드에 OLE 객체로 삽입된 파일을 다음과 같이 추출할 수 있습니다:

추출하려는 OLE 객체가 포함된 Presentation 클래스의 인스턴스를 생성합니다.
프레젠테이션의 모든 형태를 순회하면서 OleObjectFrame 형태에 접근합니다.
OLE 객체 프레임에서 삽입된 파일 데이터를 읽어 디스크에 저장합니다.

다음 PHP 코드는 슬라이드에 삽입된 파일을 OLE 객체로 추출하는 방법을 보여줍니다:

$presentation = new Presentation("sample.pptx");
$slide = $presentation->getSlides()->get_Item(0);

$shapeCount = java_values($slide->getShapes()->size());
for ($index = 0; $index < $shapeCount; $index++) {
    $shape = $slide->getShapes()->get_Item($index);

    if (java_instanceof($shape, new JavaClass("com.aspose.slides.OleObjectFrame"))) {
        $oleFrame = $shape;

        $fileData = $oleFrame->getEmbeddedData()->getEmbeddedFileData();
        $fileExtension = $oleFrame->getEmbeddedData()->getEmbeddedFileExtension();

        $filePath = "OLE_object_" . $index . $fileExtension;
        file_put_contents($filePath, $fileData);
    }
}

$presentation->dispose();

자주 묻는 질문

슬라이드를 PDF/이미지로 내보낼 때 OLE 콘텐츠가 렌더링됩니까?

슬라이드에 보이는 아이콘/대체 이미지(미리 보기)만 렌더링됩니다. “실시간” OLE 콘텐츠는 렌더링 중에 실행되지 않습니다. 필요하다면 자체 미리 보기 이미지를 지정하여 내보낸 PDF에서 원하는 모양이 표시되도록 할 수 있습니다.

PowerPoint에서 사용자가 OLE 객체를 이동하거나 편집하지 못하도록 슬라이드에 잠그려면 어떻게 해야 하나요?

형태를 잠급니다: Aspose.Slides는 형태 수준의 잠금 기능을 제공합니다. 이것은 암호화가 아니지만 실수로 인한 편집 및 이동을 효과적으로 방지합니다.

연결된 OLE 객체의 상대 경로가 PPTX 형식에 유지됩니까?

PPTX에서는 “상대 경로” 정보가 제공되지 않으며 전체 경로만 저장됩니다. 상대 경로는 구형 PPT 형식에서만 지원됩니다. 이동성을 위해 신뢰할 수 있는 절대 경로/접근 가능한 URI 또는 삽입 방식을 사용하는 것이 좋습니다.

PHP에서 프레젠테이션 접근성 관리 PHP에서 프레젠테이션 텍스트 관리