PHP を使用したプレゼンテーションでのチャートワークブックの管理

このページの概要

Java 経由で PHP 用 Aspose.Slides を発見しましょう：PowerPoint と OpenDocument 形式でチャートワークブックを簡単に管理し、プレゼンテーションデータを効率化します。

概要

この記事では、Aspose.Slides でチャートブック（ワークブック）を操作する方法を説明します。ワークブックストリームを介してチャートデータを読み書きする方法、ワークブックセルをチャートデータラベルとして使用する方法、ワークシートコレクションにアクセスする方法、そしてチャート値のデータソースタイプを指定する方法を示します。

また、外部ワークブックをチャートデータソースとして使用する方法も取り上げています。サンプルでは、外部ワークブックの作成と割り当て、チャートにリンクされた外部ワークブックのパス取得、そしてワークブックが利用可能な場合のチャートデータの編集方法を示しています。

ワークブックからチャートデータを読み書きする

Aspose.Slides は、readWorkbookStream および writeWorkbookStream メソッドを提供しており、これらを使用してチャートデータワークブック（Aspose.Cells で編集されたチャートデータを含む）を読み書きできます。注意：チャートデータは同じ方式で構成されているか、元データに類似した構造である必要があります。

この PHP コードはサンプル操作を示しています:

  $pres = new Presentation("chart.pptx");
  try {
    $chart = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0);
    $data = $chart->getChartData();
    $stream = $data->readWorkbookStream();
    $data->getSeries()->clear();
    $data->getCategories()->clear();
    $data->writeWorkbookStream($stream);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

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

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

// ワークブック ストリームを変更した後（例: Aspose.Cells を使用）
$updatedWorkbook = $chartData->readWorkbookStream();

// 既存のデータ参照をクリアします。
$chartData->getSeries()->clear();
$chartData->getCategories()->clear();

$chartData->writeWorkbookStream($updatedWorkbook);

$chart->validateChartLayout();

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

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

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

この PHP コードは、ワークブックセルをチャートデータラベルとして設定する方法を示しています:

  $lbl0 = "Label 0 cell value";
  $lbl1 = "Label 1 cell value";
  $lbl2 = "Label 2 cell value";
  # プレゼンテーション ファイルを表すプレゼンテーション クラスのインスタンスを作成します
  $pres = new Presentation("chart2.pptx");
  try {
    $slide = $pres->getSlides()->get_Item(0);
    $chart = $slide->getShapes()->addChart(ChartType::Bubble, 50, 50, 600, 400, true);
    $series = $chart->getChartData()->getSeries();
    $dataLabelCollection = $series->get_Item(0)->getLabels();
    $dataLabelCollection->getDefaultDataLabelFormat()->setShowLabelValueFromCell(true);
    $wb = $chart->getChartData()->getChartDataWorkbook();
    $dataLabelCollection->get_Item(0)->setValueFromCell($wb->getCell(0, "A10", $lbl0));
    $dataLabelCollection->get_Item(1)->setValueFromCell($wb->getCell(0, "A11", $lbl1));
    $dataLabelCollection->get_Item(2)->setValueFromCell($wb->getCell(0, "A12", $lbl2));
    $pres->save("resultchart.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

ワークシートの管理

この PHP コードは、ChartDataWorkbook::getWorksheets メソッドを使用してワークシートコレクションにアクセスする操作を示しています:

  $pres = new Presentation();
  try {
    $chart = $pres->getSlides()->get_Item(0)->getShapes()->addChart(ChartType::Pie, 50, 50, 400, 500);
    $wb = $chart->getChartData()->getChartDataWorkbook();
    for($i = 0; $i < java_values($wb->getWorksheets()->size()) ; $i++) {
      echo($wb->getWorksheets()->get_Item($i)->getName());
    }
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

データソースタイプの指定

この PHP コードは、データソースのタイプを指定する方法を示しています:

  $pres = new Presentation();
  try {
    $chart = $pres->getSlides()->get_Item(0)->getShapes()->addChart(ChartType::Column3D, 50, 50, 600, 400, true);
    $val = $chart->getChartData()->getSeries()->get_Item(0)->getName();
    $val->setDataSourceType(DataSourceType::StringLiterals);
    $val->setData("LiteralString");
    $val = $chart->getChartData()->getSeries()->get_Item(1)->getName();
    $val->setData($chart->getChartData()->getChartDataWorkbook()->getCell(0, "B1", "NewCell"));
    $pres->save("pres.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

サポートされていない埋め込みワークブック形式の検出

Aspose.Slides は、一部のチャートに埋め込むことができる Excel バイナリワークブック（.xlsb）形式をサポートしていません。ChartData の getEmbeddedWorkbookType メソッドと WorkbookType 列挙体を組み合わせて、サポートされていない形式を検出し、該当チャートをスキップできます。

$presentation = new Presentation("sample.pptx");
try {
  $slide = $presentation->getSlides()->get_Item(0);
  $shapes = $slide->getShapes();

  for ($shapeIndex = 0; $shapeIndex < java_values($shapes->size()); $shapeIndex++) {
    $shape = $shapes->get_Item($shapeIndex);

    if (!java_instanceof($shape, new JavaClass("com.aspose.slides.IChart"))) {
      continue;
    }

    $chart = $shape;
    $chartData = $chart->getChartData();

    if (java_values($chartData->getDataSourceType()) == ChartDataSourceType::InternalWorkbook &&
        java_values($chartData->getEmbeddedWorkbookType()) == WorkbookType::WorkbookBinaryMacro) {
      # 埋め込みワークブックは .xlsb 形式です。この形式はサポートされていません。
      continue;
    }

    # ここでチャート ワークブック データを読み取るか、変更してください。
  }
} finally {
  $presentation->dispose();
}

外部ワークブック

Aspose.Slides は、外部ワークブックをチャートのデータソースとしてサポートしています。

外部ワークブックの作成

readWorkbookStream と setExternalWorkbook メソッドを使用すると、外部ワークブックを新規に作成するか、既存の内部ワークブックを外部化することができます。

この PHP コードは、外部ワークブック作成プロセスを示しています:

  $pres = new Presentation();
  $Array = new java_class("java.lang.reflect.Array");
  try {
    $workbookPath = "externalWorkbook1.xlsx";
    $chart = $pres->getSlides()->get_Item(0)->getShapes()->addChart(ChartType::Pie, 50, 50, 400, 600);
    $fileStream = new Java("java.io.FileOutputStream", $workbookPath);
    $Array = new java_class("java.lang.reflect.Array");
    try {
      $workbookData = $chart->getChartData()->readWorkbookStream();
      $fileStream->write($workbookData, 0, $Array->getLength($workbookData));
    } finally {
      if (!java_is_null($fileStream)) {
        $fileStream->close();
      }
    }
    $chart->getChartData()->setExternalWorkbook($workbookPath);
    $pres->save("externalWorkbook.pptx", SaveFormat::Pptx);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

外部ワークブックの設定

setExternalWorkbook メソッドを使用すると、外部ワークブックをチャートのデータソースとして割り当てることができます。このメソッドは、外部ワークブックのパスが変更された場合（移動された場合）に更新することにも使用できます。

リモート位置やリソースに保存されているワークブックのデータを直接編集することはできませんが、外部データソースとして使用することは可能です。外部ワークブックの相対パスが指定された場合、自動的にフルパスに変換されます。

この PHP コードは、外部ワークブックを設定する方法を示しています:

  # Presentation クラスのインスタンスを作成します
  $pres = new Presentation("chart.pptx");
  try {
    $chart = $pres->getSlides()->get_Item(0)->getShapes()->addChart(ChartType::Pie, 50, 50, 400, 600, false);
    $chartData = $chart->getChartData();
    $chartData->setExternalWorkbook("externalWorkbook.xlsx");
    $chartData->getSeries()->add($chartData->getChartDataWorkbook()->getCell(0, "B1"), ChartType::Pie);
    $chartData->getSeries()->get_Item(0)->getDataPoints()->addDataPointForPieSeries($chartData->getChartDataWorkbook()->getCell(0, "B2"));
    $chartData->getSeries()->get_Item(0)->getDataPoints()->addDataPointForPieSeries($chartData->getChartDataWorkbook()->getCell(0, "B3"));
    $chartData->getSeries()->get_Item(0)->getDataPoints()->addDataPointForPieSeries($chartData->getChartDataWorkbook()->getCell(0, "B4"));
    $chartData->getCategories()->add($chartData->getChartDataWorkbook()->getCell(0, "A2"));
    $chartData->getCategories()->add($chartData->getChartDataWorkbook()->getCell(0, "A3"));
    $chartData->getCategories()->add($chartData->getChartDataWorkbook()->getCell(0, "A4"));
    $pres->save("Presentation_with_externalWorkbook.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

setExternalWorkbook メソッドの ChartData パラメータは、Excel ワークブックをロードするかどうかを指定するために使用されます。

ChartData の値が false に設定されている場合、ワークブックのパスだけが更新され、チャートデータは対象ワークブックからロードまたは更新されません。対象ワークブックが存在しない、または利用できない状況でこの設定を使用すると便利です。
ChartData の値が true に設定されている場合、チャートデータが対象ワークブックから更新されます。

  # Presentation クラスのインスタンスを作成します
  $pres = new Presentation("chart.pptx");
  try {
    $chart = $pres->getSlides()->get_Item(0)->getShapes()->addChart(ChartType::Pie, 50, 50, 400, 600, true);
    $chartData = $chart->getChartData();
    $chartData->setExternalWorkbook("http://path/doesnt/exists", false);
    $pres->save("Presentation_with_externalWorkbookWithUpdateChartData.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

チャートの外部データソースワークブックパスの取得

Presentation クラスのインスタンスを作成します。
インデックスを使用してスライドの参照を取得します。
チャートシェイプのオブジェクトを作成します。
チャートのデータソースを表すソース（ChartDataSourceType）オブジェクトを作成します。
ソースタイプが外部ワークブックデータソースタイプと同じであるかどうかの条件を指定します。

この PHP コードは、操作を示しています:

  # Presentation クラスのインスタンスを作成します
  $pres = new Presentation("chart.pptx");
  try {
    $slide = $pres->getSlides()->get_Item(1);
    $chart = $slide->getShapes()->get_Item(0);
    $sourceType = $chart->getChartData()->getDataSourceType();
    if ($sourceType == ChartDataSourceType::ExternalWorkbook) {
      $path = $chart->getChartData()->getExternalWorkbookPath();
    }
    # プレゼンテーションを保存します
    $pres->save("result.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

チャートデータの編集

外部ワークブックのデータは、内部ワークブックの内容を変更するのと同様に編集できます。外部ワークブックをロードできない場合は例外がスローされます。

この PHP コードは、上記プロセスの実装例です:

  # Presentation クラスのインスタンスを作成します
  $pres = new Presentation("chart.pptx");
  try {
    $chart = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0);
    $chartData = $chart->getChartData();
    $chartData->getSeries()->get_Item(0)->getDataPoints()->get_Item(0)->getValue()->getAsCell()->setValue(100);
    $pres->save("presentation_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

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

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

以下の PHP サンプルは、外部ワークブックが利用できないチャートを含むプレゼンテーションを開き、Chart::getChartData と ChartData::getChartDataWorkbook を使用して復元されたデータにアクセスします:

$spreadsheetOptions = new SpreadsheetOptions();
$spreadsheetOptions->setRecoverWorkbookFromChartCache(true);

$loadOptions = new LoadOptions();
$loadOptions->setSpreadsheetOptions($spreadsheetOptions);

$presentation = new Presentation("presentation.pptx", $loadOptions);
try {
    $chart = $presentation->getSlides()->get_Item(0)->getShapes()->get_Item(0);
    $recoveredWorkbook = $chart->getChartData()->getChartDataWorkbook();

    # ここで復元されたワークブック データを読み取りまたは変更します。
} finally {
    $presentation->dispose();
}

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

FAQ

特定のチャートが外部ワークブックまたは埋め込みワークブックのどちらにリンクされているか判別できますか？
はい。チャートには data source type と path to an external workbook があり、ソースが外部ワークブックである場合はフルパスを読み取り、外部ファイルが使用されていることを確認できます。

外部ワークブックへの相対パスはサポートされますか？また、どのように保存されますか？
はい。相対パスを指定すると自動的に絶対パスに変換されます。これはプロジェクトのポータビリティに便利ですが、PPTX ファイルには絶対パスが保存される点に注意してください。

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

プレゼンテーションを保存する際に Aspose.Slides は外部 XLSX を上書きしますか？
いいえ。プレゼンテーションは外部ファイルへのリンクを保存し、データの読み取りに使用します。プレゼンテーションを保存しても外部ファイル自体は変更されません。

外部ファイルがパスワードで保護されている場合はどうすればよいですか？
Aspose.Slides はリンク時にパスワードを受け付けません。一般的な対策としては、事前に保護を解除するか、復号化したコピー（例: Aspose.Cells を使用）を用意してそのコピーにリンクすることがあります。

複数のチャートが同じ外部ワークブックを参照できますか？
はい。各チャートは独自のリンクを保持します。すべてが同じファイルを指している場合、そのファイルを更新すると次回データが読み込まれる際に各チャートに反映されます。

PHPでプレゼンテーションチャートをフォーマットする PHPでPowerPointチャートをアニメーション化

PHP を使用したプレゼンテーションでのチャート ワークブックの管理

このページの概要

概要

ワークブックからチャート データを読み書きする

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

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