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

このページの概要

Aspose.Slides for Python via .NET をご紹介します。PowerPoint および OpenDocument 形式でチャートワークブックを簡単に管理し、プレゼンテーションデータを効率化できます。

概要

この記事では、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)

ワークブック変更後のチャートレイアウトの検証

埋め込みワークブックを変更済みのものに置き換えると、チャートは元のシリーズとカテゴリコレクションを保持したままになります。この不一致により、IChart.validate_chart_layout がインデックス範囲外エラーで失敗することがあります。更新されたワークブックをチャートに書き戻す前に、既存のシリーズとカテゴリをクリアしてください。

# ワークブック ストリームを変更した後（例: Aspose.Cells を使用）
updated_workbook = chart_data.read_workbook_stream()

# 既存のデータ参照をクリアします。
chart_data.series.clear()
chart_data.categories.clear()

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

chart.validate_chart_layout()

コレクションをクリアすることで、チャートデータ構造が新しいワークブックと一致し、validate_chart_layout がエラーなく完了できるようになります。

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

場合によっては、基になるデータワークブックのセルから直接取得したチャートラベルが必要になることがあります。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) 形式をサポートしていません。ChartData の embedded_workbook_type プロパティと 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)
    # False を渡すとパスだけが保存されます: 対象のワークブックはまだ存在している必要はありません。
    chart.chart_data.set_external_workbook("external_workbook.xlsx", False)

    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（デフォルト）に設定されている場合、チャートデータは対象ワークブックからロードされ、更新されます。そのワークブックを開くことができない場合、メッセージが “External workbook is not available” の例外がスローされます。

外部ワークブックの作成

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)

チャートキャッシュからワークブックを復元

チャートが欠落または利用できない外部ワークブックを使用している場合、Aspose.Slides はプレゼンテーションにキャッシュされたデータからチャートワークブックを再構築できます。LoadOptions を作成し、プレゼンテーションを開く前に LoadOptions.spreadsheet_options を介して SpreadsheetOptions.recover_workbook_from_chart_cache を有効にします。

以下の Python の例は、チャートが利用できない外部ワークブックを参照しているプレゼンテーションを開き、Chart.chart_data と 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

    # ここで復元されたワークブック データを読み取るまたは変更します。

外部ワークブックが利用できず、復元が無効になっている場合、Aspose.Slides は例外をスローします。キャッシュされたチャートデータの使用が許容できるフォールバックである場合にのみ復元を有効にしてください。キャッシュには、プレゼンテーションが最後に更新された後に外部ワークブックで行われた変更が含まれていない可能性があります。

よくある質問

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

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

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

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

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

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

プレゼンテーションを保存すると、Aspose.Slides は外部 XLSX を上書きしますか？

チャートデータを編集した場合にのみ上書きされます。プレゼンテーションは link to the external file を保存し、データの読み取りに使用するため、プレゼンテーションを開いて保存してもワークブックは変更されません。ただし、チャートデータを通じて変更した値（上記の Edit Chart Data を参照）は、プレゼンテーションを保存する際に外部ワークブックに書き戻されます。元のファイルを保持する必要がある場合は、コピーで作業してください。

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

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

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

はい。各チャートは独自のリンクを保持します。すべてが同じファイルを指している場合、そのファイルを更新すると、次回データがロードされる際に各チャートに反映されます。

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

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

このページの概要

概要

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

ワークブック変更後のチャート レイアウトの検証

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