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 では、データラベルを特定のワークブックセルにバインドでき、ラベルテキストは常にセルの値を反映します。以下の例は、セルから値を取得するラベルを有効にし、選択したラベルをチャートのワークブック内のカスタムセルにポイントさせる方法を示しています。

Presentation クラスのインスタンスを作成します。
インデックスでスライドへの参照を取得します。
サンプルデータでバブルチャートを追加します。
チャートシリーズにアクセスします。
ワークブックセルをデータラベルとして使用します。
プレゼンテーションを保存します。

以下の 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 バイナリワークブック (.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)

set_external_workbook メソッドの update_chart_data パラメータは、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 を使用すると、チャートのデータソースを調べ、外部ワークブックであればフルパスを取得できます。

Presentation クラスのインスタンスを作成します。
インデックスでスライドへの参照を取得します。
チャートシェイプへの参照を取得します。
チャートのデータソースを表すソース (ChartDataSourceType) を取得します。
ソースタイプが外部ワークブックデータソースタイプと一致するか確認します。

以下の 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

特定のチャートが外部ワークブックにリンクされているか、埋め込みワークブックにリンクされているかを判定できますか？

はい。チャートには data source type と外部ワークブックへのパスがあり、ソースが外部ワークブックの場合はフルパスを読み取って外部ファイルが使用されているか確認できます。

外部ワークブックへの相対パスはサポートされますか？また、どのように保存されますか？

はい。相対パスを指定すると自動的に絶対パスに変換されます。これはプロジェクトのポータビリティに便利ですが、プレゼンテーションは PPTX ファイル内に絶対パスを保存することに注意してください。

ネットワークリソース/共有上のワークブックを使用できますか？

はい、これらのワークブックは外部データソースとして使用できます。ただし、Aspose.Slides からリモートワークブックを直接編集することはサポートされていません。ソースとしてのみ使用可能です。

プレゼンテーションを保存するときに外部 XLSX が上書きされますか？

いいえ。プレゼンテーションは外部ファイルへのリンクを保存し、データの読み取りに使用します。保存時に外部ファイル自体は変更されません。

外部ファイルがパスワードで保護されている場合はどうすればよいですか？

Aspose.Slides はリンク時にパスワードを受け付けません。一般的な対策は、事前に保護を解除するか、復号化したコピー (例: Aspose.Cells) を作成してそのコピーにリンクすることです。

複数のチャートが同じ外部ワークブックを参照できますか？

はい。各チャートは独自のリンクを保持します。すべてが同じファイルを指していれば、そのファイルの更新は次回データが読み込まれたときに各チャートに反映されます。

Python を使用したプレゼンテーションのチャートの書式設定 Python で PowerPoint チャートをアニメーション化

Pythonでプレゼンテーションのチャートワークブックを管理する

概要

ワークブックからチャート データの読み取りと書き込み

ワークブック セルをチャート データ ラベルとして設定