یکپارچه‌سازی داده‌های اکسل در ارائه‌های PowerPoint

این صفحه درباره چیست

داده‌ها را از کتاب‌کارهای اکسل در Aspose.Slides برای Python از طریق Java با استفاده از API ExcelDataWorkbook بخوانید. شیت‌ها و سلول‌ها را بارگذاری کنید و از مقادیر آنها برای تولید ارائه‌های PowerPoint مبتنی بر داده استفاده کنید.

معرفی

ارائه‌های PowerPoint روشی قدرتمند برای نمایش و انتقال اطلاعات هستند. این ارائه‌ها اغلب همراه با کتاب‌کارهای Excel استفاده می‌شوند، که در آن Excel منبع ساختارمند داده‌هاست و PowerPoint توانایی تجسم این داده‌ها برای مخاطب را دارد.

سناریوهای عملی متعددی وجود دارد که ترکیب Excel و PowerPoint در آنها ضروری است: ادغام نامه‌ها، پر کردن جداول داده‌ای، تولید اسلایدی برای هر رکورد داده (تولید دسته‌ای اسلاید)، ایجاد مطالب آموزشی، و تجمیع چندین گزارش Excel در یک ارائه، تنها به چند مثال اشاره می‌کنیم.

تا کنون پیاده‌سازی چنین ویژگی‌هایی با API Aspose.Slides نیاز به اتکای بر راه‌حل‌های شخص ثالث مانند Aspose.Cells داشت. اگرچه این ابزارها قدرتمندند، اما برای کاربرانی که فقط به عملکرد پایهٔ یکپارچه‌سازی داده‌ها نیاز دارند، می‌توانند بیش از حد پیچیده و پرهزینه باشند.

نحوه کار

برای آسان‌تر و یکنواخت‌تر کردن کار با داده‌های Excel، Aspose.Slides کلاس‌های جدیدی برای خواندن داده‌ها از کتاب‌کارهای Excel و وارد کردن محتوا به یک ارائه معرفی کرده است. این ویژگی امکانات جدیدی را برای کاربران API که می‌خواهند از Excel به عنوان منبع داده در جریان‌کارهای ارائه خود استفاده کنند، فراهم می‌کند.

این کارکرد جدید برای دسترسی عمومی به داده‌ها طراحی شده و در مدل شیئی سند ارائه (DOM) ادغام نشده است. به این معنی که اجازهٔ ویرایش یا ذخیرهٔ فایل‌های Excel را نمی‌دهد — هدف تنها باز کردن کتاب‌کارها و جستجو در محتوای آنها برای دریافت دادهٔ سلول‌هاست.

در هستهٔ این ویژگی، کلاس جدید ExcelDataWorkbook قرار دارد. این کلاس امکان بارگذاری یک کتاب‌کار Excel از فایل محلی یا یک جریان را فراهم می‌کند. پس از بارگذاری، چندین overload از متد ExcelDataWorkbook.getCell در اختیار شماست که می‌توانید برای بازیابی سلول‌های خاص بر اساس موقعیت‌شان (مثلاً اندیس‌های ردیف و ستون یا بازه‌های نام‌گذاری‌شده) از آنها استفاده کنید.

هر فراخوانی به ExcelDataWorkbook.getCell یک شیء ExcelDataCell برمی‌گرداند. این شیء نمایانگر یک سلول منفرد در کتاب‌کار Excel است و دسترسی ساده و شهودی به مقدار آن را فراهم می‌کند.

وارد کردن نمودار Excel

گام بعدی برای گسترش کارکرد، کلاس ExcelWorkbookImporter است. این کلاس کمکی قابلیت وارد کردن محتوا از یک کتاب‌کار Excel به یک ارائه را فراهم می‌کند. این کلاس چند overload از متد ExcelWorkbookImporter.addChartFromWorkbook دارد که به شما کمک می‌کند نمودار انتخابی را از کتاب‌کار Excel مشخص شده دریافت کرده و در انتهای مجموعهٔ اشکال داده‌شده، در مختصات مشخص‌شده اضافه کنید.

وارد کردن جدول Excel

کلاس ExcelWorkbookImporter همچنین چند overload از متد ExcelWorkbookImporter.addTableFromWorkbook دارد. این متدها به شما اجازه می‌دهند بازهٔ سلولی مشخصی را از کاربرگ مشخص‌شده وارد کرده و به عنوان یک جدول در انتهای مجموعهٔ اشکال داده‌شده، در مختصات مشخص‌شده اضافه کنید.

به‌عبارت دیگر، این یک API سبک و ساده برای خواندن داده‌های Excel است — دقیقاً همان چیزی که بسیاری از توسعه‌دهندگان بدون بار اضافی یک کتابخانهٔ کامل پردازش صفحه‌گسترده به آن نیاز دارند.

بیایید کد بنویسیم

مثال سناریوی ادغام نامه

در مثال زیر، یک سناریوی سادهٔ ادغام نامه را با تولید چندین ارائه بر پایهٔ داده‌های ذخیره‌شده در یک کتاب‌کار Excel پیاده‌سازی می‌کنیم.

برای شروع، به دو مورد نیاز داریم:

یک کتاب‌کار Excel حاوی داده‌ها

Excel data example

یک قالب ارائه PowerPoint

PowerPoint template example

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ExcelDataWorkbook, Presentation, SaveFormat

# بارگذاری کتاب‌کار اکسل حاوی داده‌های کارمندان.
workbook = ExcelDataWorkbook("TemplateData.xlsx")
worksheet_index = 0

# بارگذاری قالب ارائه.
template_presentation = Presentation("PresentationTemplate.pptx")

try:
    # تکرار بر روی ردیف‌های اکسل (به‌جز سرصفحه در ردیف 0).
    for row_index in range(1, 5):

        # ایجاد یک ارائه برای هر رکورد کارمند.
        employee_presentation = Presentation()

        try:
            # حذف اسلاید خالی پیش‌فرض.
            employee_presentation.getSlides().removeAt(0)

            # کپی‌کردن اسلاید قالب به داخل ارائه.
            slide = employee_presentation.getSlides().addClone(template_presentation.getSlides().get_Item(0))

            # دریافت پاراگراف‌ها از شکل هدف (فرض می‌کند ایندکس شکل 1 استفاده شده است).
            paragraphs = slide.getShapes().get_Item(1).getTextFrame().getParagraphs()

            # جایگزینی جای‌گیرها با داده‌های اکسل.
            employee_name = str(workbook.getCell(worksheet_index, row_index, 0).getValue())
            name_portion = paragraphs.get_Item(0).getPortions().get_Item(0)
            name_portion.setText(str(name_portion.getText()).replace("{{EmployeeName}}", employee_name))

            department = str(workbook.getCell(worksheet_index, row_index, 1).getValue())
            department_portion = paragraphs.get_Item(1).getPortions().get_Item(0)
            department_portion.setText(str(department_portion.getText()).replace("{{Department}}", department))

            years_of_service = str(workbook.getCell(worksheet_index, row_index, 2).getValue())
            years_portion = paragraphs.get_Item(2).getPortions().get_Item(0)
            years_portion.setText(str(years_portion.getText()).replace("{{YearsOfService}}", years_of_service))

            # ذخیرهٔ ارائه شخصی‌سازی‌شده در یک فایل جداگانه.
            employee_presentation.save(f"{employee_name} Report.pptx", SaveFormat.Pptx)
        finally:
            employee_presentation.dispose()
finally:
    template_presentation.dispose()

Result

مثال جدول Excel

در مثال دوم، به‌سادگی داده‌ها را از یک جدول Excel کپی می‌کنیم و آنها را در یک اسلاید PowerPoint به شکلی بصری‌تر نمایش می‌دهیم.

در این مثال، همان کتاب‌کار Excel اولین مثال را مجدداً استفاده می‌کنیم که شامل یک جدول سادهٔ کارمندان است.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ExcelDataWorkbook, Presentation, SaveFormat

# بارگذاری کتاب‌کار اکسل حاوی داده‌های کارمندان.
workbook = ExcelDataWorkbook("TemplateData.xlsx")
worksheet_index = 0

# ایجاد یک ارائه PowerPoint.
presentation = Presentation()

try:
    # افزودن یک شکل جدول به اسلاید اول.
    column_widths = jpype.JArray(jpype.JDouble)([200, 200, 200])
    row_heights = jpype.JArray(jpype.JDouble)([30, 30, 30, 30, 30])
    table = presentation.getSlides().get_Item(0).getShapes().addTable(50, 200, column_widths, row_heights)

    # پر کردن جدول PowerPoint با داده‌های کتاب‌کار اکسل.
    for row_index in range(5):
        for column_index in range(3):
            cell_value = str(workbook.getCell(worksheet_index, row_index, column_index).getValue())
            table.getColumns().get_Item(column_index).get_Item(row_index).getTextFrame().setText(cell_value)

    # ذخیرهٔ ارائه نهایی در یک فایل.
    presentation.save("Table.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Result

مثال وارد کردن نمودار Excel

در این مثال، یک نمودار را از کاربرگ اول کتاب‌کار Excel استفاده‌شده در مثال قبلی وارد می‌کنیم. این نمودار در ارائهٔ نهایی به کتاب‌کار خارجی لینک می‌شود.

ابتدا، یک نمودار دایره‌ای بر پایهٔ جدول کارمندان به کتاب‌کار Excel اضافه می‌کنیم.

Excel Chart example

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ExcelWorkbookImporter, Presentation, SaveFormat

# یک ارائه PowerPoint ایجاد کنید.
presentation = Presentation()
try:
    # دریافت مجموعهٔ اشکال اسلاید اول.
    shapes = presentation.getSlides().get_Item(0).getShapes()

    # نقشه‌ای با نام "Chart 1" را از اولین شیت کتاب‌کار وارد کرده و به مجموعهٔ اشکال اضافه کنید.
    ExcelWorkbookImporter.addChartFromWorkbook(shapes, 10, 10, "TemplateData.xlsx", "Sheet1", "Chart 1", False)

    # ارائهٔ حاصل را در یک فایل ذخیره کنید.
    presentation.save("Chart.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Result

مثال وارد کردن همه نمودارهای Excel

فرض کنید یک کتاب‌کار Excel پر از نمودار دارید و می‌خواهید همهٔ آنها را به یک ارائه وارد کنید. هر نمودار باید در یک اسلاید جدید قرار گیرد.

کد زیر تمام کاربرگ‌های فایل Excel منبع را می‌گرداند، نمودارهای هر کاربرگ را استخراج می‌کند و هر نمودار را با استفاده از یک طرح اسلاید خالی به یک اسلاید جداگانه اضافه می‌کند. در ارائهٔ نهایی، فقط دادهٔ نمودارها جاسازی می‌شوند، نه کل کتاب‌کار.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ExcelDataWorkbook, ExcelWorkbookImporter, Presentation, SaveFormat, SlideLayoutType

# بارگذاری کتاب‌کار اکسل حاوی داده‌های کارمندان.
workbook = ExcelDataWorkbook("ExcelWithCharts.xlsx")

# یک ارائه PowerPoint ایجاد کنید.
presentation = Presentation()
try:
    # دست‌رسی به طرح اسلاید خالی.
    blank_layout = presentation.getLayoutSlides().getByType(SlideLayoutType.Blank)

    # اسلاید پیش‌فرض را حذف کنید تا نتیجه شامل یک اسلاید برای هر نمودار باشد.
    presentation.getSlides().removeAt(0)

    # دریافت نام‌های تمامی ورق‌های کتاب‌کار اکسل.
    worksheet_names = workbook.getWorksheetNames()

    for name in worksheet_names:
        # دریافت نقشه‌ای که ایندکس‌های نمودار را به نام‌های نمودار برای ورق مرتبط می‌کند.
        worksheet_charts = workbook.getChartsFromWorksheet(name)

        for chart in worksheet_charts:
            # اضافه کردن اسلاید با استفاده از طرح خالی.
            slide = presentation.getSlides().addEmptySlide(blank_layout)

            # وارد کردن نمودار مشخص‌شده از کتاب‌کار اکسل به مجموعهٔ اشکال اسلاید.
            ExcelWorkbookImporter.addChartFromWorkbook(slide.getShapes(), 10, 10, workbook, name, chart.getKey(), False)

    # ذخیرهٔ ارائهٔ نهایی در یک فایل.
    presentation.save("Charts.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

مثال وارد کردن جدول Excel

در این مثال، یک جدول قالب‌بندی‌شده را مستقیم از یک کاربرگ Excel به یک ارائه PowerPoint وارد می‌کنیم.

کاربرگ Excel منبع شامل یک جدول قالب‌بندی‌شده با داده‌های کارمندان است:

Excel Table example

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ExcelWorkbookImporter, Presentation, SaveFormat

# یک ارائه PowerPoint ایجاد کنید.
presentation = Presentation()
try:
    # دریافت اولین اسلاید و مجموعهٔ اشکال آن.
    slide = presentation.getSlides().get_Item(0)
    shapes = slide.getShapes()

    # وارد کردن جدول از اولین شیت کتاب‌کار و افزودن آن به مجموعهٔ اشکال.
    ExcelWorkbookImporter.addTableFromWorkbook(shapes, 10, 10, "TemplateData.xlsx", "Sheet1", "A1:C5")

    # ذخیرهٔ ارائهٔ حاصل در یک فایل.
    presentation.save("FormattedTable.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Result

خلاصه

این مکانیزم که مستقیماً در Aspose.Slides موجود است، کار با داده‌های Excel و ارائه‌ها را در یک جا ترکیب می‌کند. این امکان را می‌دهد تا اسلایدهایی با نمودارهای بصری و داده‌های ارائه‌شده به شکل جداول Excel ایجاد کنید—بدون نیاز به کتابخانه‌های اضافی یا ادغام‌های پیچیده.

محدودیت‌های API