JavaScript を使用してプレゼンテーションでチャートワークシート数式を適用する

このページの概要

Java 用チャートワークシートを介して Node.js 用 Aspose.Slides で Excel 形式の数式を適用し、値を再計算して、PowerPoint のチャートで結果を使用します。

概要

PowerPoint のチャートは通常、埋め込みのワークシートに元データを保存します。Aspose.Slides for Node.js via Java では、チャートデータワークブックを介してそのワークシートにアクセスし、入力値を書き込み、セルに数式を割り当て、サポートされている数式を計算し、計算結果のセルをチャートデータとして使用できます。

この記事では、チャートの作成、ワークシートへのデータ入力、A1 形式または R1C1 形式の数式の割り当て、再計算、計算結果の取得、セルをチャートシリーズに接続、プレゼンテーションの保存という完全な数式ワークフローを説明します。また、サポートされる数式構文、組み込み関数のサブセット、キャッシュされた値、非対応数式、スプレッドシート固有のエラーについても解説します。

チャートワークシートと数式

チャートワークシートには、チャートで使用されるカテゴリ、シリーズ名、値が含まれます。PowerPoint では、チャートデータエディターを開くことでワークシートを確認できます。

PowerPoint の埋め込みワークシートが開かれたチャートで、カテゴリとシリーズデータを表示しています

Aspose.Slides では、ワークシートは ChartDataWorkbook クラスを通じて公開されています。A1 形式の数式には ChartDataCell.setFormula を、R1C1 形式の数式には ChartDataCell.setR1C1Formula を使用します。入力セルまたは数式を変更したら、ChartDataWorkbook.calculateFormulas を呼び出してサポートされている数式を再計算し、対応するセル値を更新します。

計算されたセルは依然として ChartDataCell.getValue によって結果を取得できます。コード内で数式結果を確認したり、セルをチャートデータポイントとして使用したりする際に重要です。

チャートの作成とワークシート数式の計算

以下の例はエンドツーエンドのワークフローを示しています。クラスター化された縦棒グラフを作成し、サンプルデータをクリアし、四半期ごとの収益と費用の値を書き込み、数式で利益を計算し、結果を読み取り、計算されたセルをチャートの値として使用し、プレゼンテーションを保存します。

const aspose = {};
aspose.slides = require("aspose.slides.via.java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);
    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 50, 50, 600, 350);
    const workbook = chart.getChartData().getChartDataWorkbook();
    const worksheetIndex = 0;

    chart.getChartData().getSeries().clear();
    chart.getChartData().getCategories().clear();
    workbook.clear(worksheetIndex);

    const category1 = workbook.getCell(worksheetIndex, "A2", "Q1");
    const category2 = workbook.getCell(worksheetIndex, "A3", "Q2");
    const category3 = workbook.getCell(worksheetIndex, "A4", "Q3");

    workbook.getCell(worksheetIndex, "B1", "Revenue");
    workbook.getCell(worksheetIndex, "C1", "Expenses");
    workbook.getCell(worksheetIndex, "D1", "Profit");

    workbook.getCell(worksheetIndex, "B2").setValue(120.0);
    workbook.getCell(worksheetIndex, "C2").setValue(80.0);
    workbook.getCell(worksheetIndex, "B3").setValue(150.0);
    workbook.getCell(worksheetIndex, "C3").setValue(95.0);
    workbook.getCell(worksheetIndex, "B4").setValue(135.0);
    workbook.getCell(worksheetIndex, "C4").setValue(110.0);

    const profit1 = workbook.getCell(worksheetIndex, "D2");
    const profit2 = workbook.getCell(worksheetIndex, "D3");
    const profit3 = workbook.getCell(worksheetIndex, "D4");

    profit1.setFormula("B2-C2");
    profit2.setFormula("B3-C3");
    profit3.setFormula("B4-C4");

    workbook.calculateFormulas();

    const q1Profit = profit1.getValue(); // 40
    const q2Profit = profit2.getValue(); // 55
    const q3Profit = profit3.getValue(); // 25

    console.log("Q1 profit: " + q1Profit);
    console.log("Q2 profit: " + q2Profit);
    console.log("Q3 profit: " + q3Profit);

    chart.getChartData().getCategories().add(category1);
    chart.getChartData().getCategories().add(category2);
    chart.getChartData().getCategories().add(category3);

    const profitSeries = chart.getChartData().getSeries().add(workbook.getCell(worksheetIndex, "D1"), chart.getType());
    profitSeries.getDataPoints().addDataPointForBarSeries(profit1);
    profitSeries.getDataPoints().addDataPointForBarSeries(profit2);
    profitSeries.getDataPoints().addDataPointForBarSeries(profit3);
    profitSeries.getLabels().getDefaultDataLabelFormat().setShowValue(true);

    presentation.save("chart-formulas.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

チャートデータポイントは D2:D4 を参照するため、チャートは計算された利益値を使用します。このワークフローでは別途チャートのリフレッシュ呼び出しは必要ありません。まずワークブックを再計算し、次に計算されたセルを指すチャートデータを使用または保存します。

A1 形式数式の使用

A1 表記は列を文字で、行を数字で識別します。A1 形式の式は ChartDataCell.setFormula で割り当てます。

const aspose = {};
aspose.slides = require("aspose.slides.via.java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);
    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 50, 50, 500, 300);
    const workbook = chart.getChartData().getChartDataWorkbook();

    workbook.getCell(0, "C3").setValue(10);
    workbook.getCell(0, "F2").setValue(2);
    workbook.getCell(0, "G2").setValue(3);
    workbook.getCell(0, "H2").setValue(4);

    const cell = workbook.getCell(0, "A2");
    cell.setFormula("C3+SUM(F2:H2)");

    workbook.calculateFormulas();

    const value = cell.getValue(); // 19
} finally {
    presentation.dispose();
}

一般的な A1 参照形態は次のとおりです。

参照	相対	絶対	混合
セル	`A2`	`$A$2`	`A$2`, `$A2`
行	`2:2`	`$2:$2`	—
列	`A:A`	`$A:$A`	—
範囲	`A2:C4`	`$A$2:$C$4`	`A$2:$C4`, `$A2:C$4`

相対参照は数式がスプレッドシートアプリケーションで移動またはコピーされたときに変化します。絶対参照は両方の座標を固定し、混合参照は行または列のいずれかだけを固定します。

R1C1 形式数式の使用

R1C1 表記は行と列を数値で識別します。相対参照は角括弧でオフセットを表します。この構文は ChartDataCell.setR1C1Formula で割り当てます。

const aspose = {};
aspose.slides = require("aspose.slides.via.java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);
    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 50, 50, 500, 300);
    const workbook = chart.getChartData().getChartDataWorkbook();

    workbook.getCell(0, "B2").setValue(12);
    workbook.getCell(0, "C2").setValue(5);

    const cell = workbook.getCell(0, "D2");
    cell.setR1C1Formula("RC[-2]-RC[-1]");

    workbook.calculateFormulas();

    const value = cell.getValue(); // 7
} finally {
    presentation.dispose();
}

一般的な R1C1 参照形態は次のとおりです。

参照	相対	絶対	混合
セル	`R[2]C[3]`	`R2C3`	`R2C[3]`, `R[2]C3`
行	`R[2]`	`R2`	—
列	`C[3]`	`C3`	—
範囲	`R[2]C[3]:R[5]C[7]`	`R2C3:R5C7`	`R2C3:R[5]C[7]`, `R[2]C3:R5C[7]`

たとえば、セル D2 で RC[-2] は「同じ行の左に 2 列あるセル」（B2）を意味します。

数式の定数と演算子

組み込みの数式評価エンジンは、論理値、数値リテラル、文字列、スプレッドシートエラー値、算術演算子、比較演算子をサポートします。

定数とリテラル

種類	例	備考
論理	`TRUE`, `FALSE`	`A2=TRUE` のような論理式で直接使用できます。
数値	`1`, `0.5`, `.3`, `1E-2`	通常表記と指数表記の両方がサポートされます。
文字列	`"abc"`, `"2/3/2020 12:00"`	文字列リテラルは数式内で二重引用符で囲みます。
エラー結果	`#DIV/0!`, `#N/A`, `#REF!`	正常な結果ではなくスプレッドシートエラー値になることがあります。

この例は複数の定数タイプを使用しています。

const aspose = {};
aspose.slides = require("aspose.slides.via.java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);
    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 50, 50, 500, 300);
    const workbook = chart.getChartData().getChartDataWorkbook();

    workbook.getCell(0, "A2").setValue(false);
    workbook.getCell(0, "B2").setFormula("A2=TRUE");
    workbook.getCell(0, "C2").setFormula("1+0.5");
    workbook.getCell(0, "D2").setFormula(".3*1E-2");
    workbook.getCell(0, "E2").setFormula("\"abc\"");
    workbook.getCell(0, "F2").setFormula("2/0");

    workbook.calculateFormulas();

    const logicalValue = workbook.getCell(0, "B2").getValue(); // false
    const numericValue = workbook.getCell(0, "C2").getValue(); // 1.5
    const scientificValue = workbook.getCell(0, "D2").getValue(); // 0.003
    const stringValue = workbook.getCell(0, "E2").getValue(); // abc
    const errorValue = workbook.getCell(0, "F2").getValue(); // #DIV/0!
} finally {
    presentation.dispose();
}

算術演算子

演算子	意味	例
`+`	加算または単項プラス	`2+3`
`-`	減算または単項マイナス	`2-3`, `-3`
`*`	乗算	`2*3`
`/`	除算	`2/3`
`%`	パーセンテージ	`30%`
`^`	累乗	`2^3`

評価順序を明示したい場合は括弧を使用します。例: (A2+B2)*C2.

比較演算子

比較式は論理値を返します。

演算子	意味	例
`=`	等しい	`A2=3`
`<>`	等しくない	`A2<>3`
`>`	大きい	`A2>3`
`>=`	大きいまたは等しい	`A2>=3`
`<`	小さい	`A2<3`
`<=`	小さいまたは等しい	`A2<=3`

サポートされる組み込み関数

Aspose.Slides はチャートワークシート用の組み込み数式評価エンジンを提供しますが、完全な Excel 計算エンジンではありません。ドキュメント化されている関数は以下の一覧に限られます。任意の Excel 関数が ChartDataWorkbook.calculateFormulas で再計算できると想定しないでください。

関数	目的またはサポート形式	例
`ABS`	絶対値	`ABS(A2)`
`AVERAGE`	算術平均	`AVERAGE(B2:B5)`
`CEILING`	指定した倍数に切り上げ	`CEILING(A2,5)`
`CHOOSE`	インデックスで値を選択	`CHOOSE(A2,"Low","High")`
`CONCAT`	テキスト結合	`CONCAT(A2,B2)`
`CONCATENATE`	テキスト結合	`CONCATENATE(A2," ",B2)`
`DATE`	1900 日付システムで日付値を作成	`DATE(2026,8,19)`
`DAYS`	2 つの日付間の日数を返す	`DAYS(B2,A2)`
`FIND`	テキスト内で別のテキストを検索	`FIND("-",A2)`
`FINDB`	バイト指向テキスト検索	`FINDB("a",A2)`
`IF`	条件結果	`IF(A2>0,A2,0)`
`INDEX`	参照形式	`INDEX(A2:C4,2,3)`
`LOOKUP`	ベクトル形式	`LOOKUP(A2,B2:B5,C2:C5)`
`MATCH`	ベクトル形式	`MATCH(A2,B2:B5,0)`
`MAX`	最大値	`MAX(B2:B5)`
`SUM`	合計	`SUM(B2:B5)`
`VLOOKUP`	縦方向検索	`VLOOKUP(A2,B2:D10,3,FALSE)`

表に示された制限は重要です。INDEX は参照形式で、LOOKUP と MATCH はベクトル形式でのみサポートされます。DATE は 1900 日付システムを使用します。ここに記載されていない機能や関数は、Aspose.Slides の数式評価エンジンではサポートされていないと見なしてください。

優先カルチャーで数式を計算する

一部のワークブック関数はカルチャ固有のルールに従ってテキストを解釈します。特に DBCS（ダブルバイト文字セット）を使用する言語向け関数で重要です。正しく計算するには、LoadOptions を作成し、SpreadsheetOptions.setPreferredCulture で優先カルチャーを設定し、LoadOptions.setSpreadsheetOptions でスプレッドシートオプションを割り当てたうえでプレゼンテーションをロードします。

以下の例は日本語カルチャを選択し、構成済みロードオプションでプレゼンテーションを開き、すべてのチャートワークブックに対して ChartDataWorkbook.calculateFormulas を呼び出します。

const aspose = {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

const japaneseCulture = java.newInstanceSync("java.util.Locale", "ja", "JP");

const spreadsheetOptions = new aspose.slides.SpreadsheetOptions();
spreadsheetOptions.setPreferredCulture(japaneseCulture);

const loadOptions = new aspose.slides.LoadOptions();
loadOptions.setSpreadsheetOptions(spreadsheetOptions);

const presentation = new aspose.slides.Presentation("presentation.pptx", loadOptions);
try {
    const slides = presentation.getSlides();
    for (let slideIndex = 0; slideIndex < slides.size(); slideIndex++) {
        const shapes = slides.get_Item(slideIndex).getShapes();
        for (let shapeIndex = 0; shapeIndex < shapes.size(); shapeIndex++) {
            const shape = shapes.get_Item(shapeIndex);
            if (java.instanceOf(shape, "com.aspose.slides.IChart")) {
                shape.getChartData().getChartDataWorkbook().calculateFormulas();
            }
        }
    }
} finally {
    presentation.dispose();
}

優先カルチャーはプレゼンテーションのロード設定の一部なので、Presentation インスタンスを作成する前に指定します。ワークブックの数式で期待されるカルチャを使用してください。例: 日本語 DBCS 計算ルールに従う数式には ja-JP を使用します。

再計算とキャッシュされた値

スプレッドシートファイルは通常、数式と直近の計算結果の両方を保存します。Aspose.Slides はプレゼンテーションがロードされ、該当チャートデータが変更されていない場合、ChartDataCell.getValue からキャッシュされた値を読み取ることができます。

入力セルや数式を変更したら、古いキャッシュ結果に依存しないでください。計算された値を読み取る前や、計算結果に依存するチャートデータを保存する前に、必ず ChartDataWorkbook.calculateFormulas を呼び出してください。

サポート外の数式については、Aspose.Slides が数式の解析や依存関係の確立に失敗する可能性があります。ワークブックが変更された場合、以前のキャッシュ値はもはや信頼できません。そのような状況で非対応データを含むセルの値を取得しようとすると、CellUnsupportedDataException がスローされることがあります。

チャートが Aspose.Slides で評価できない Excel 関数に依存している場合は、外部のスプレッドシートエンジンで数式を計算し、結果の値をチャートワークブックに書き戻してください。非対応数式を推測した値で置き換えてはいけません。

数式エラーの処理

区別すべき問題は 2 種類あります。

数式は有効でも、#DIV/0!, #N/A, #NAME?, #NULL!, #NUM!, #REF!, #VALUE! といったスプレッドシートエラー結果を返すことがあります。この場合、エラートークンはセルの結果であり、ChartDataCell.getValue から取得できます。

数式がパース、参照、依存関係、またはサポートデータのレベルで失敗することもあります。Aspose.Slides はこれらの場合に以下のスプレッドシート固有例外を提供します: CellInvalidFormulaException, CellInvalidReferenceException, CellCircularReferenceException, および CellUnsupportedDataException。

テンプレートやユーザー入力から数式が供給される場合は、再計算と値アクセスの周囲でエラーを捕捉してください。エラー詳細は基礎となるスプレッドシートの問題を特定します。

const aspose = {};
aspose.slides = require("aspose.slides.via.java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);
    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 50, 50, 500, 300);
    const workbook = chart.getChartData().getChartDataWorkbook();
    const cell = workbook.getCell(0, "A2");
    cell.setFormula("SUM(B2:B5)");

    try {
        workbook.calculateFormulas();
        console.log(cell.getValue());
    } catch (error) {
        console.error("Formula processing error: " + error.message);
    }
} finally {
    presentation.dispose();
}

実用上の制限

チャートワークシートにおける数式サポートは、完全な Excel 互換性を目指したものではなく、定義されたサブセットの計算を対象としています。レポートワークフローを設計する際は次の点に注意してください。

Aspose.Slides が数式を再計算できるように、ドキュメント化された定数、演算子、参照、関数のみを使用してください。
式結果が依存するセルを変更したら必ず再計算してください。
ロードされたプレゼンテーションから取得したキャッシュ値はスナップショットと考え、編集後の再計算の代替にはしないでください。
既存テンプレートの数式は、特にドキュメント外の関数を使用している場合、計算結果に依存する前にテストしてください。
完全なスプレッドシート計算エンジンが必要な数式は外部で計算し、チャートワークブックに結果の値を更新してください。

FAQ

ChartDataCell.setFormula と ChartDataCell.setR1C1Formula の違いは何ですか？

ChartDataCell.setFormula は B2-C2 のような A1 形式の式を保存します。ChartDataCell.setR1C1Formula は RC[-2]-RC[-1] のような R1C1 形式の式を保存します。生成またはコピーする数式に最も適した表記を使用してください。

計算後にセルそのものとその値のどちらを読む必要がありますか？

ChartDataWorkbook.getCell は ChartDataCell を返します。再計算後に計算結果を取得するには、そのセルの ChartDataCell.getValue メソッドを呼び出してください。

ChartDataWorkbook.calculateFormulas はいつ呼び出すべきですか？

入力値または数式を変更した直後、計算結果に依存する前に ChartDataWorkbook.calculateFormulas を呼び出してください。これにより、組み込み評価エンジンがサポートする数式の値が更新されます。

Aspose.Slides はすべての Excel 関数をサポートしていますか？

いいえ。組み込み評価エンジンはドキュメント化されたサブセットの関数のみをサポートします。サブセット外の関数は正しく再計算できると想定しないでください。完全な Excel 数式互換性が必要な場合は、適切なスプレッドシートエンジンで計算し、最終的な値をチャートワークブックに書き込んでください。

ロードされたプレゼンテーションに非対応の数式が含まれていた場合はどうなりますか？

チャートデータが変更されていなければ、ワークブックは以前に計算されたキャッシュ値を保持している場合があります。関連データが変更された後は、そのキャッシュ値は無効になる可能性があります。処理できない数式を持つセルにアクセスすると、CellUnsupportedDataException がスローされることがあります。

数式エラー値は例外と同じですか？

いいえ。#DIV/0! のような結果は、有効な計算によって生成されたスプレッドシート値です。一方、CellInvalidFormulaException や CellCircularReferenceException といった例外は、数式が正常に処理できないことを示します。

数式セルが変更されたときにチャートは自動的に更新されますか？

チャートシリーズはワークブックセルを参照できます。まずワークブックを再計算し、次にプレゼンテーションを保存またはレンダリングしてください。データポイントが計算されたセルを参照していれば、チャートは更新されたセル値を使用します。別途チャートのリフレッシュメソッドは必要ありません。

チャートは外部の Excel ワークブックを使用できますか？

はい、チャートデータはチャートデータ API を通じて外部ワークブックを使用するように構成できます。ただし、本記事で説明した数式計算ワークフローはチャートデータワークブックと Aspose.Slides が評価できる数式サブセットに限定されます。ChartDataWorkbook.calculateFormulas が外部 XLSX ファイルの任意の数式を完全に再計算するとは想定しないでください。

別シートまたは別ブックを参照する数式を使用できますか？

Excel 形式の参照はチャートワークブック内に存在する可能性がありますが、数式評価はサポートされているパーサと関数セットに制限されます。クロスシートや外部参照が必須の場合は、対象の Aspose.Slides バージョンで正確に評価できるか検証してください。広範な Excel 参照互換性が必要なワークフローでは、ワークブックを外部で計算し、解決された値をチャートデータに書き戻すことを検討してください。

数式文字列は = で始める必要がありますか？

Aspose.Slides API の例では、B2-C2 や SUM(B2:B5) のように先頭の = を付けずに式を割り当てます。その形で数式を設定すると、ドキュメント化された API の例と整合性が保たれます。

プレゼンテーションビューア JavaScript でプレゼンテーションのビュープロパティを取得および更新する

JavaScript を使用してプレゼンテーションでチャート ワークシート数式を適用する