مدیریت OLE در ارائه‌ها با استفاده از PHP

مقدمه

OLE (Object Linking & Embedding) یک فناوری مایکروسافت است که اجازه می‌دهد داده‌ها و اشیائی که در یک برنامه ایجاد شده‌اند، از طریق ارتباط یا جاسازی در برنامه دیگری قرار گیرند.

به یک نمودار ایجاد شده در MS Excel توجه کنید. سپس این نمودار داخل یک اسلاید PowerPoint قرار می‌گیرد. آن نمودار Excel به عنوان یک شیء OLE در نظر گرفته می‌شود.

یک شیء OLE ممکن است به صورت یک آیکون نمایش داده شود. در این حالت، هنگام دوبار کلیک روی آیکون، نمودار در برنامه مرتبط خود (Excel) باز می‌شود یا از شما خواسته می‌شود برنامه‌ای را برای باز کردن یا ویرایش شیء انتخاب کنید.
یک شیء OLE ممکن است محتوای واقعی خود را نشان دهد، مانند محتوای یک نمودار. در این حالت، نمودار در PowerPoint فعال می‌شود، رابط کاربری نمودار بارگذاری می‌شود و می‌توانید داده‌های نمودار را درون PowerPoint تغییر دهید.

Aspose.Slides for PHP via Java به شما امکان می‌دهد OLE Objects را به اسلایدها به‌عنوان چارچوب‌های شیء OLE وارد کنید (OleObjectFrame).

افزودن چارچوب‌های شیء OLE به اسلایدها

فرض کنید قبلاً یک نمودار در Microsoft Excel ایجاد کرده‌اید و می‌خواهید آن را به‌صورت یک چارچوب شیء OLE در یک اسلاید جاسازی کنید با استفاده از Aspose.Slides for PHP via Java؛ می‌توانید این کار را به این روش انجام دهید:

یک نمونه از کلاس Presentation ایجاد کنید.
مرجع اسلاید را بر اساس ایندکس آن دریافت کنید.
فایل Excel را به‌عنوان آرایه بایت بخوانید.
چارچوب OleObjectFrame را به اسلاید اضافه کنید که شامل آرایه بایت و سایر اطلاعات مربوط به شیء OLE است.
ارائه‌ اصلاح‌شده را به‌صورت فایل PPTX ذخیره کنید.

در مثال زیر، یک نمودار از یک فایل Excel را به‌عنوان یک چارچوب شیء OLE به یک اسلاید اضافه کردیم با استفاده از Aspose.Slides for PHP via Java.
توجه که سازندهٔ OleEmbeddedDataInfo یک پسوند شیء جاسازی‌شدنی را به‌عنوان پارامتر دوم می‌گیرد. این پسوند به PowerPoint امکان می‌دهد نوع فایل را به‌درستی تفسیر کرده و برنامه مناسب برای باز کردن این شیء OLE را انتخاب کند.

$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 نشان می‌دهد چگونه یک OleObjectFrame با فایل Excel پیوندی به یک اسلاید اضافه کنید:

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

// Add an OLE object frame with a linked Excel file.
$slide->getShapes()->addOleObjectFrame(20, 20, 200, 150, "Excel.Sheet.12", "book.xlsx");

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

دسترسی به چارچوب‌های شیء OLE

اگر یک شیء OLE از پیش در یک اسلاید جاسازی شده باشد، می‌توانید به راحتی آن را به این روش پیدا یا دسترسی پیدا کنید:

یک ارائه حاوی شیء OLE جاسازی‌شده را با ایجاد یک نمونه از کلاس Presentation بارگذاری کنید.
مرجع اسلاید را با استفاده از ایندکس آن دریافت کنید.
به شکل 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;
    
    // دریافت داده‌های فایل جاسازی‌شده.
    // دریافت پسوند فایل جاسازی‌شده.
    // ...
}

دسترسی به ویژگی‌های چارچوب شیء 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 از پیش در یک اسلاید جاسازی شده باشد، می‌توانید به راحتی به آن شیء دسترسی پیدا کنید و داده‌های آن را به این روش تغییر دهید:

یک ارائه حاوی شیء OLE جاسازی‌شده را با ایجاد یک نمونه از کلاس Presentation بارگذاری کنید.
مرجع اسلاید را از طریق ایندکس آن دریافت کنید.
به شکل 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، پیش‌نمایشی شامل یک تصویر آیکون به‌طور خودکار افزوده می‌شود. این پیش‌نمایش همان چیزی است که کاربران قبل از دسترسی یا باز کردن شیء 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);

// Set a title and the image for the OLE preview.
$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» ممکن است اندازه و موقعیت چارچوب شیء OLE را تغییر دهد زیرا PowerPoint داده‌ها را از شیء OLE پیوندی به‌روزرسانی می‌کند و پیش‌نمایش شیء را تازه می‌سازد. برای جلوگیری از این درخواست PowerPoint، متد setUpdateAutomatic کلاس OleObjectFrame را روی false تنظیم کنید:

$oleFrame->setUpdateAutomatic(false);

استخراج فایل‌های جاسازی‌شده

Aspose.Slides for PHP via Java به شما امکان می‌دهد فایل‌های جاسازی‌شده در اسلایدها را به‌عنوان اشیای OLE به این روش استخراج کنید:

یک نمونه از کلاس Presentation ایجاد کنید که شامل اشیای OLEی که قصد استخراج آنها را دارید، باشد.
بر تمام اشکال موجود در ارائه حلقه بزنید و به اشکال 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();

FAQ

آیا محتوای OLE هنگام خروجی گرفتن اسلایدها به PDF/تصاویر رندر می‌شود؟

آنچه در اسلاید قابل مشاهده است رندر می‌شود — آیکون/تصویر جایگزین (پیشنمایش). محتوای زنده OLE در هنگام رندر اجرا نمی‌شود. در صورت نیاز، تصویر پیش‌نمایش خود را تنظیم کنید تا ظاهر مورد انتظار در PDF خروجی تأیید شود.

چگونه می‌توانم یک شیء OLE را در اسلاید قفل کنم تا کاربران نتوانند آن را در PowerPoint جابه‌جا یا ویرایش کنند؟

شکل را قفل کنید: Aspose.Slides قفل‌های سطح شکل را ارائه می‌دهد. این قفل‌گذاری رمزنگاری نیست، اما به‌طور مؤثری از ویرایش‌ها و جابه‌جایی‌های ناخواسته جلوگیری می‌کند.

آیا مسیرهای نسبی برای اشیای OLE پیوندی در فرمت PPTX حفظ می‌شوند؟

در PPTX اطلاعات «مسیر نسبی» موجود نیست — فقط مسیر کامل ذخیره می‌شود. مسیرهای نسبی در فرمت قدیمی PPT یافت می‌شوند. برای قابل حمل بودن، مسیرهای مطمئن مطلق/URIهای قابل دسترسی یا جاسازی را ترجیح دهید.

مدیریت فایل‌های رسانه‌ای در PHP مدیریت متن ارائه در PHP