Управление книгами диаграмм в презентациях с помощью Python

Обзор

В этой статье объясняется, как работать с книгами диаграмм в Aspose.Slides. Показано, как читать и записывать данные диаграмм через потоки книги, использовать ячейки книги в качестве меток данных, получать доступ к коллекциям листов и указывать тип источника данных для значений диаграмм.

Также рассматривается работа с внешними книгами в качестве источников данных диаграмм. Примеры демонстрируют, как создавать и назначать внешнюю книгу, получать путь к внешней книге, связанной с диаграммой, и редактировать данные диаграммы, когда книга доступна.

Чтение и запись данных диаграммы из книги

Aspose.Slides предоставляет методы для чтения и записи книг данных диаграмм (которые содержат данные, отредактированные с помощью Aspose.Cells). Примечание: Данные диаграммы должны быть организованы одинаково или иметь структуру, аналогичную источнику.

Ниже приведён пример кода на Python:

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)

Установить ячейку рабочей книги в качестве метки данных диаграммы

Иногда нужно, чтобы метки диаграммы напрямую получали значения из ячеек основной книги данных. Aspose.Slides позволяет привязывать метки данных к конкретным ячейкам книги, чтобы текст метки всегда отражал значение ячейки. Пример ниже показывает, как включить метки «значение из ячейки» и направить выбранные метки к пользовательским ячейкам в книге диаграммы.

  1. Создайте экземпляр класса Presentation.
  2. Получите ссылку на слайд по индексу.
  3. Добавьте пузырчатую диаграмму с примерными данными.
  4. Получите доступ к рядам диаграммы.
  5. Используйте ячейку книги в качестве метки данных.
  6. Сохраните презентацию.

Ниже показан пример кода на Python, который устанавливает ячейку книги в качестве метки данных диаграммы:

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

# Создайте экземпляр класса Presentation, представляющего файл презентации.
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)

Управление листами

Ниже приведён пример кода на Python, демонстрирующий использование свойства worksheets для доступа к коллекции листов:

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)

Указание типа источника данных

Ниже показан пример кода на Python, который задаёт тип источника данных:

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)

Обнаружение неподдерживаемых форматов встроенных книг

Aspose.Slides не поддерживает формат Excel binary workbook (.xlsb), который может быть встроен в некоторые диаграммы. Вы можете использовать свойство embedded_workbook_type объекта ChartData вместе с перечислением WorkbookType для обнаружения неподдерживаемых форматов и пропуска соответствующих диаграмм.

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):
            # Встроенная книга находится в формате .xlsb, который не поддерживается.
            continue

        # Здесь можно читать или изменять данные книги диаграммы.

Внешние книги

Aspose.Slides поддерживает использование внешних книг в качестве источника данных для диаграмм.

Установить внешние книги

С помощью метода ChartData.set_external_workbook вы можете назначить внешнюю книгу диаграмме в качестве её источника данных. Этот метод также может обновлять путь к внешней книге, если она была перемещена.

Хотя редактировать данные в книгах, хранящихся на удалённых ресурсах, нельзя, их всё равно можно использовать как внешние источники данных. Если указать относительный путь к внешней книге, он автоматически преобразуется в полный путь.

Ниже показан пример кода на Python, который устанавливает внешнюю книгу:

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)
    chart.chart_data.set_external_workbook("external_workbook.xlsx")

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

Параметр update_chart_data метода set_external_workbook определяет, будет ли Excel‑книга загружена.

  • Когда update_chart_data установлен в False, обновляется только путь к книге; данные диаграммы не загружаются и не обновляются из целевой книги. Используйте эту настройку, когда целевая книга отсутствует или недоступна.
  • Когда update_chart_data установлен в True, данные диаграммы загружаются и обновляются из целевой книги.

Создать внешние книги

С помощью методов read_workbook_stream и set_external_workbook вы можете либо создать внешнюю книгу с нуля, либо преобразовать внутреннюю книгу во внешнюю.

Этот пример кода на Python демонстрирует процесс создания внешней книги:

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)

Получить путь к внешней книге‑источнику данных для диаграммы

Иногда данные диаграммы связаны с внешней книгой Excel, а не с встроенными данными презентации. С помощью Aspose.Slides можно проверить источник данных диаграммы и, если это внешняя книга, прочитать её полный путь.

  1. Создайте экземпляр класса Presentation.
  2. Получите ссылку на слайд по его индексу.
  3. Получите ссылку на объект диаграммы.
  4. Получите источник (ChartDataSourceType), представляющий источник данных диаграммы.
  5. Проверьте, соответствует ли тип источника типу внешней книги.

Ниже показан пример кода на Python, демонстрирующий эту операцию:

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)

Редактировать данные диаграммы

Вы можете редактировать данные во внешних книгах так же, как и во внутренних. Если внешняя книга не может быть загружена, будет выброшено исключение.

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)

FAQ

Могу ли я определить, привязана ли конкретная диаграмма к внешней или встроенной книге?

Да. У диаграммы есть тип источника данных и путь к внешней книге; если источник — внешняя книга, можно считать полный путь, чтобы убедиться, что используется внешний файл.

Поддерживаются ли относительные пути к внешним книгам и как они хранятся?

Да. При указании относительного пути он автоматически преобразуется в абсолютный. Это удобно для переносимости проекта, однако презентация сохраняет абсолютный путь в файле PPTX.

Можно ли использовать книги, расположенные на сетевых ресурсах/общих папках?

Да, такие книги могут использоваться как внешний источник данных. Однако прямое редактирование удалённых книг из Aspose.Slides не поддерживается — их можно только использовать как источник.

Перезаписывает ли Aspose.Slides внешний XLSX при сохранении презентации?

Нет. Презентация сохраняет ссылку на внешний файл и использует её для чтения данных. Сам внешний файл не изменяется при сохранении презентации.

Что делать, если внешний файл защищён паролем?

Aspose.Slides не принимает пароль при связывании. Обычно снимают защиту заранее или создают расшифрованную копию (например, с помощью Aspose.Cells) и связываются с этой копией.

Могут ли несколько диаграмм ссылаться на одну и ту же внешнюю книгу?

Да. Каждая диаграмма хранит собственную ссылку. Если они указывают на один и тот же файл, обновление этого файла будет отражено во всех диаграммах при следующей загрузке данных.

Форматирование диаграмм в презентациях с использованием Python Анимировать диаграммы PowerPoint в Python