Quản lý sổ làm việc biểu đồ trong bản trình chiếu bằng Python

Trang này nói về điều gì

Khám phá Aspose.Slides cho Python qua .NET: dễ dàng quản lý sổ làm việc biểu đồ trong các định dạng PowerPoint và OpenDocument để tối ưu hoá dữ liệu bản trình chiếu của bạn.

Tổng quan

Bài viết này giải thích cách làm việc với sổ làm việc biểu đồ trong Aspose.Slides. Nó cho thấy cách đọc và ghi dữ liệu biểu đồ thông qua luồng sổ làm việc, sử dụng các ô trong sổ làm việc làm nhãn dữ liệu biểu đồ, truy cập bộ sưu tập worksheet, và chỉ định loại nguồn dữ liệu cho các giá trị biểu đồ.

Nó cũng đề cập đến việc làm việc với sổ làm việc bên ngoài như là nguồn dữ liệu cho biểu đồ. Các ví dụ minh họa cách tạo và gán một sổ làm việc bên ngoài, lấy đường dẫn của sổ làm việc bên ngoài được liên kết với biểu đồ, và chỉnh sửa dữ liệu biểu đồ khi sổ làm việc có sẵn.

Đọc và Ghi Dữ liệu Biểu đồ từ Sổ làm việc

Aspose.Slides cung cấp các phương thức để đọc và ghi sổ dữ liệu biểu đồ (chứa dữ liệu biểu đồ đã được chỉnh sửa bằng Aspose.Cells). Lưu ý: Dữ liệu biểu đồ phải được tổ chức theo cùng cách hoặc có cấu trúc tương tự nguồn.

import aspose.slides as slides

with slides.Presentation("chart.pptx") as presentation:
    chart = presentation.slides[0].shapes[0]

    data_stream = chart.chart_data.read_workbook_stream()

    chart.chart_data.series.clear()
    chart.chart_data.categories.clear()

    data_stream.seek(0)
    chart.chart_data.write_workbook_stream(data_stream)

Xác thực Bố cục Biểu đồ Sau Khi Sửa Đổi Sổ làm việc

Khi bạn thay thế sổ làm việc nhúng bằng một sổ đã được chỉnh sửa, biểu đồ vẫn giữ lại các series và category gốc. Sự không khớp này có thể khiến IChart.validate_chart_layout gặp lỗi chỉ số ngoài phạm vi. Hãy xóa các series và category hiện có trước khi ghi lại sổ đã cập nhật vào biểu đồ.

# Sau khi chỉnh sửa luồng sổ làm việc (ví dụ: sử dụng Aspose.Cells)
updated_workbook = chart_data.read_workbook_stream()

# Xóa các tham chiếu dữ liệu hiện có.
chart_data.series.clear()
chart_data.categories.clear()

updated_workbook.seek(0)
chart_data.write_workbook_stream(updated_workbook)

chart.validate_chart_layout()

Việc xóa các bộ sưu tập đảm bảo cấu trúc dữ liệu biểu đồ nhất quán với sổ mới, cho phép validate_chart_layout hoàn thành mà không gặp lỗi.

Đặt Ô WorkBook làm Nhãn Dữ liệu Biểu đồ

Đôi khi bạn cần nhãn biểu đồ lấy trực tiếp từ các ô trong sổ dữ liệu nền. Aspose.Slides cho phép bạn liên kết nhãn dữ liệu với các ô cụ thể trong sổ làm việc để văn bản nhãn luôn phản ánh giá trị của ô. Ví dụ dưới đây cho thấy cách bật nhãn giá trị từ ô và chỉ định các nhãn đã chọn tới các ô tùy chỉnh trong sổ làm việc của biểu đồ.

Tạo một thể hiện của lớp Presentation.
Lấy tham chiếu tới slide theo chỉ mục.
Thêm một biểu đồ bubble với dữ liệu mẫu.
Truy cập series của biểu đồ.
Sử dụng một ô trong sổ làm việc làm nhãn dữ liệu.
Lưu bản trình chiếu.

import aspose.slides as slides
import aspose.slides.charts as charts

# Khởi tạo lớp Presentation đại diện cho tệp bản trình chiếu.
with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    chart = slide.shapes.add_chart(charts.ChartType.BUBBLE, 50, 50, 600, 400, True)

    series = chart.chart_data.series[0]

    series.labels.default_data_label_format.show_label_value_from_cell = True

    workbook = chart.chart_data.chart_data_workbook

    series.labels[0].value_from_cell = workbook.get_cell(0, "A10", "Label 0")
    series.labels[1].value_from_cell = workbook.get_cell(0, "A11", "Label 1")
    series.labels[2].value_from_cell = workbook.get_cell(0, "A12", "Label 2")

    presentation.save("chart.pptx", slides.export.SaveFormat.PPTX)

Quản lý Bảng tính

Đoạn mã Python sau trình bày cách sử dụng thuộc tính worksheets để truy cập bộ sưu tập worksheet:

import aspose.slides as slides
import aspose.slides.charts as charts

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    chart = slide.shapes.add_chart(charts.ChartType.PIE, 50, 50, 400, 500)

    workbook = chart.chart_data.chart_data_workbook
    for i in range(len(workbook.worksheets)):
        print(workbook.worksheets[i].name)

Xác định Loại Nguồn Dữ liệu

Đoạn mã Python sau cho thấy cách chỉ định loại nguồn dữ liệu:

import aspose.slides as slides
import aspose.slides.charts as charts

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    chart = slide.shapes.add_chart(charts.ChartType.COLUMN_3D, 50, 50, 600, 400, True)

    series_name = chart.chart_data.series[0].name
    series_name.data_source_type = slides.charts.DataSourceType.STRING_LITERALS
    series_name.data = "LiteralString"

    series_name = chart.chart_data.series[1].name
    series_name.data = chart.chart_data.chart_data_workbook.get_cell(0, "B1", "NewCell")

    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Phát hiện Định dạng Sổ làm việc Nhúng không Hỗ trợ

Aspose.Slides không hỗ trợ định dạng sổ Excel nhị phân (.xlsb) có thể được nhúng trong một số biểu đồ. Bạn có thể sử dụng thuộc tính embedded_workbook_type trên ChartData kết hợp với enumeration WorkbookType để phát hiện các định dạng không được hỗ trợ và bỏ qua các biểu đồ đó.

import aspose.slides as slides
import aspose.slides.charts as charts

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]

    for shape in slide.shapes:
        if not isinstance(shape, charts.Chart):
            continue

        chart = shape
        chart_data = chart.chart_data

        if (chart_data.data_source_type == charts.ChartDataSourceType.INTERNAL_WORKBOOK and
                chart_data.embedded_workbook_type == charts.WorkbookType.WORKBOOK_BINARY_MACRO):
            # Sổ làm việc nhúng ở định dạng .xlsb, không được hỗ trợ.
            continue

        # Đọc hoặc chỉnh sửa dữ liệu sổ làm việc biểu đồ tại đây.

Sổ làm việc Ngoài

Aspose.Slides hỗ trợ việc sử dụng sổ làm việc bên ngoài làm nguồn dữ liệu cho biểu đồ.

Đặt Sổ làm việc Ngoại

Bằng cách sử dụng phương thức ChartData.set_external_workbook, bạn có thể gán một sổ làm việc bên ngoài cho biểu đồ như là nguồn dữ liệu của nó. Phương thức này cũng có thể cập nhật đường dẫn tới sổ làm việc bên ngoài nếu nó đã được di chuyển.

Mặc dù bạn không thể chỉnh sửa dữ liệu trong các sổ làm việc được lưu trên các vị trí hoặc tài nguyên từ xa, bạn vẫn có thể sử dụng các sổ đó làm nguồn dữ liệu bên ngoài. Nếu bạn cung cấp một đường dẫn tương đối cho sổ làm việc bên ngoài, nó sẽ tự động được chuyển thành đường dẫn đầy đủ.

Đoạn mã Python sau cho thấy cách đặt một sổ làm việc bên ngoài:

import aspose.slides as slides
import aspose.slides.charts as charts

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    chart = slide.shapes.add_chart(charts.ChartType.PIE, 50, 50, 400, 600, False)
    # Truyền False để chỉ lưu đường dẫn: sổ làm việc mục tiêu không cần tồn tại ngay.
    chart.chart_data.set_external_workbook("external_workbook.xlsx", False)

    presentation.save("chart_with_external_workbook.pptx", slides.export.SaveFormat.PPTX)

Tham số update_chart_data của phương thức set_external_workbook chỉ định liệu sổ Excel sẽ được tải hay không.

Khi update_chart_data được đặt thành False, chỉ đường dẫn sổ làm việc được cập nhật; dữ liệu biểu đồ không được tải hoặc làm mới từ sổ mục tiêu. Sử dụng cài đặt này khi sổ mục tiêu không tồn tại hoặc không khả dụng.
Khi update_chart_data được đặt thành True (mặc định), dữ liệu biểu đồ được tải và cập nhật từ sổ mục tiêu. Nếu sổ đó không thể mở, một ngoại lệ với thông báo “External workbook is not available” sẽ được ném ra.

Tạo Sổ làm việc Ngoài

Bằng cách sử dụng các phương thức read_workbook_stream và set_external_workbook, bạn có thể tạo một sổ làm việc bên ngoài từ đầu hoặc chuyển đổi một sổ làm việc nội bộ thành sổ làm việc bên ngoài.

Đoạn mã Python này minh họa quá trình tạo sổ làm việc bên ngoài:

import pathlib
import aspose.slides as slides
import aspose.slides.charts as charts

workbook_path = "external_workbook.xlsx"

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    chart = slide.shapes.add_chart(charts.ChartType.PIE, 50, 50, 400, 600)

    workbook_data = chart.chart_data.read_workbook_stream().read()

    with open(workbook_path, "wb") as file_stream:
        file_stream.write(workbook_data)

    full_path = str(pathlib.Path(workbook_path).resolve())
    chart.chart_data.set_external_workbook(full_path)

    presentation.save("chart_with_external_workbook.pptx", slides.export.SaveFormat.PPTX)

Lấy Đường dẫn Sổ làm việc Nguồn Dữ liệu Ngoài cho một Biểu đồ

Đôi khi dữ liệu của một biểu đồ được liên kết tới một sổ Excel bên ngoài thay vì dữ liệu nhúng của bản trình chiếu. Với Aspose.Slides, bạn có thể kiểm tra nguồn dữ liệu của biểu đồ và, nếu đó là sổ làm việc bên ngoài, đọc đường dẫn đầy đủ của sổ.

Tạo một thể hiện của lớp Presentation.
Lấy tham chiếu tới slide theo chỉ mục của nó.
Lấy tham chiếu tới shape biểu đồ.
Lấy nguồn (ChartDataSourceType) đại diện cho nguồn dữ liệu của biểu đồ.
Kiểm tra xem loại nguồn có khớp với loại nguồn dữ liệu sổ làm việc bên ngoài hay không.

import aspose.slides as slides
import aspose.slides.charts as charts

with slides.Presentation("chart_with_external_workbook.pptx") as presentation:
    chart = presentation.slides[0].shapes[0]
    source_type = chart.chart_data.data_source_type
    if source_type == charts.ChartDataSourceType.EXTERNAL_WORKBOOK:
        print(chart.chart_data.external_workbook_path)

Chỉnh sửa Dữ liệu Biểu đồ

Bạn có thể chỉnh sửa dữ liệu trong sổ làm việc bên ngoài tương tự như cách chỉnh sửa dữ liệu trong sổ làm việc nội bộ. Nếu một sổ làm việc bên ngoài không thể tải, một ngoại lệ sẽ được ném ra.

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    chart = presentation.slides[0].shapes[0]
    chart.chart_data.series[0].data_points[0].value.as_cell.value = 100
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Khôi phục Sổ làm việc từ Bộ nhớ đệm Biểu đồ

Nếu một biểu đồ sử dụng sổ làm việc bên ngoài bị mất hoặc không khả dụng, Aspose.Slides có thể tái tạo sổ làm việc của biểu đồ từ dữ liệu đã được lưu trong bản trình chiếu. Tạo LoadOptions, sau đó bật SpreadsheetOptions.recover_workbook_from_chart_cache thông qua LoadOptions.spreadsheet_options trước khi mở bản trình chiếu.

Đoạn ví dụ Python sau mở một bản trình chiếu mà biểu đồ của nó tham chiếu tới một sổ làm việc bên ngoài không khả dụng và truy cập dữ liệu đã được khôi phục qua Chart.chart_data và ChartData.chart_data_workbook:

import aspose.slides as slides

load_options = slides.LoadOptions()
load_options.spreadsheet_options.recover_workbook_from_chart_cache = True

with slides.Presentation("presentation.pptx", load_options) as presentation:
    chart = presentation.slides[0].shapes[0]
    recovered_workbook = chart.chart_data.chart_data_workbook

    # Đọc hoặc chỉnh sửa dữ liệu sổ làm việc đã khôi phục tại đây.

Nếu sổ làm việc bên ngoài không khả dụng và chế độ khôi phục bị tắt, Aspose.Slides sẽ ném ra một ngoại lệ. Chỉ bật khôi phục khi việc sử dụng dữ liệu biểu đồ đã được lưu trong bộ nhớ đệm là một lựa chọn chấp nhận được, vì bộ nhớ đệm có thể không chứa các thay đổi được thực hiện trên sổ làm việc bên ngoài sau lần cập nhật cuối cùng của bản trình chiếu.

Câu hỏi thường gặp

Tôi có thể xác định một biểu đồ cụ thể được liên kết tới sổ làm việc ngoại hay nhúng không?

Có. Một biểu đồ có một data source type và một path to an external workbook; nếu nguồn là sổ làm việc bên ngoài, bạn có thể đọc đường dẫn đầy đủ để chắc chắn rằng một tệp bên ngoài đang được sử dụng.

Liệu các đường dẫn tương đối tới sổ làm việc bên ngoài có được hỗ trợ không, và chúng được lưu như thế nào?

Có. Nếu bạn chỉ định một đường dẫn tương đối, nó sẽ tự động được chuyển thành đường dẫn tuyệt đối. Điều này thuận lợi cho việc di động dự án; tuy nhiên, hãy lưu ý rằng bản trình chiếu sẽ lưu đường dẫn tuyệt đối trong tệp PPTX.

Tôi có thể sử dụng sổ làm việc nằm trên các tài nguyên/mạng chia sẻ không?

Có, các sổ như vậy có thể được dùng làm nguồn dữ liệu bên ngoài. Tuy nhiên, việc chỉnh sửa trực tiếp các sổ làm việc từ xa bằng Aspose.Slides không được hỗ trợ — chúng chỉ có thể dùng làm nguồn.

Aspose.Slides có ghi đè lên tệp XLSX bên ngoài khi lưu bản trình chiếu không?

Chỉ khi bạn đã chỉnh sửa dữ liệu biểu đồ. Bản trình chiếu lưu một link to the external file và dùng nó để đọc dữ liệu, vì vậy việc mở và lưu bản trình chiếu không làm thay đổi sổ làm việc. Tuy nhiên, các giá trị bạn thay đổi qua dữ liệu biểu đồ (xem Edit Chart Data ở trên) sẽ được ghi lại vào sổ làm việc bên ngoài khi bản trình chiếu được lưu — hãy làm việc trên một bản sao nếu tệp gốc phải được giữ nguyên.

Nếu tệp bên ngoài được bảo vệ bằng mật khẩu, tôi nên làm gì?

Aspose.Slides không chấp nhận mật khẩu khi liên kết. Một cách phổ biến là gỡ bỏ bảo vệ trước hoặc chuẩn bị một bản sao đã giải mã (ví dụ, sử dụng Aspose.Cells) và liên kết tới bản sao đó.

Nhiều biểu đồ có thể tham chiếu cùng một sổ làm việc bên ngoài không?

Có. Mỗi biểu đồ lưu trữ liên kết riêng của mình. Nếu chúng đều trỏ tới cùng một tệp, việc cập nhật tệp sẽ được phản ánh trong mỗi biểu đồ khi dữ liệu được tải lần tiếp theo.

Định dạng biểu đồ trong bản thuyết trình bằng Python Tạo hoạt ảnh cho biểu đồ PowerPoint trong Python