Documentation – Aspose.Cells for Node.js via C++ でピボットテーブルの行フィールドと列フィールドを追加する

Nodejscpp: ラベルまたは値によるピボットテーブルのフィルタリング

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells は、ピボットテーブルに表示されるデータをフィルタリングするための5つの実用的な戦略を提供します。テキストベースの行フィールドまたは列フィールドにラベルフィルタを適用したり、日付と時刻のセルまたは空白のみを含むフィールドに対して日付フィルタを使用したり、集計数値に対して値フィルタを適用したり、値フィールドによってランク付けするトップ10フィルタを使用したり、IsHidden プロパティを使用して個別のピボットアイテムを手動で非表示または再表示したりできます。各戦略は、PivotField クラスと PivotItem クラスの専用 API を通じて公開されています。

はじめに

ピボットテーブルは強力な分析ツールですが、生の集計結果には特定のレポートで提示する必要がある情報をはるかに超えるデータが含まれていることがよくあります。フィルタリングは、ピボットテーブルを特定のレポートにとって重要な行、列、値に絞り込むための主要なメカニズムです。Aspose.Cells for Node.js via C++ は Microsoft Excel で利用できるフィルタリング機能を反映しており、それらをプログラム的に公開することで、レポート生成を完全に自動化できるようにしています。この記事で扱うフィルタリング戦略は以下の通りです。

ラベルフィルタ — 行または列フィールドのアイテムを、テキストラベルに基づいてフィルタリングします。
日付フィルタ — 日時の値（または空白）のみを含む行または列フィールドをフィルタリングします。
値フィルタ — データフィールドの集計値に基づいてアイテムをフィルタリングします。
トップ10フィルタ — 値フィールドでランク付けされた上位または下位N件のアイテムのみを表示します。
ピボットアイテムの非表示/再表示 — フィールド内の各個別アイテムの表示を手動で制御します。各アプローチは、PivotField クラスの異なるメソッド、または PivotItem クラスのプロパティを使用します。フィルタを適用した後、ピボットテーブルのキャッシュデータと計算値が新しいフィルタ状態を反映するように、ピボットテーブル上で refreshData() と calculateData() を呼び出す必要があります。

ラベルフィルタ

ラベルフィルタを使用すると、行または列フィールドのアイテムを、テキストキャプションをパターンと比較することによってフィルタリングできます。これは、特定の文字で始まる名前の製品のみを表示したり、特定の単語を含む製品のみを表示したり、その他のキャプション基準に一致する製品のみを表示したりする場合に便利です。 Aspose.Cells は、PivotField.filterByLabel(PivotFilterType, string) メソッドを通じてラベルフィルタリングを公開しています。PivotFilterType 列挙には、CaptionBeginsWith、CaptionContains、CaptionEndsWith、CaptionDoesNotContain、CaptionIsNotBlank、CaptionIsBlank などの値が含まれます。2番目の引数は、比較に使用されるラベル文字列を指定します。次の例では、既存ピボットテーブルを含むワークブックを読み込み、指定された接頭辞で始まるキャプションを持つアイテムのみが表示されるようにラベルフィルタを適用し、ピボットテーブルを更新して結果を保存します。

let fileName = "sample.xlsx";
let prefix = "B";

// ピボットテーブルを含む既存のブックを読み込む
let workbook = new AsposeCells.Workbook(fileName);

// インデックスでワークシートにアクセスする（最初のワークシート）
let worksheet = workbook.getWorksheets().get(0);

// インデックスでピボットテーブルにアクセスする
let pivotTable = worksheet.getPivotTables().get(0);

// 最初の行の PivotField を取得する
let rowField = pivotTable.getRowFields().get(0);

// ラベルフィルターを適用する — ラベルが指定された接頭辞で始まる行項目のみを表示する
rowField.filterByLabel(AsposeCells.PivotFilterType.CaptionBeginsWith, prefix, "");

// ピボットテーブルのデータを更新して再計算し、フィルターを反映する
pivotTable.getPivotCache().refresh();

// ワークブックをディスクに保存する
workbook.save(fileName);

日付フィルタ

日付フィルタを使用すると、今日、先週、今月、来四半期、特定の日付範囲などの日付ベースの基準によってピボットテーブルを絞り込むことができます。これらは、日時情報を格納するフィールドに対してのみ機能する特殊なフィルタです。

日付フィルタは、行または列エリアに日時セルまたは空白値のみが含まれている場合にのみ機能します。基になるフィールドに数値やテキストなどの他のデータ型が含まれている場合、日付フィルタは期待どおりの結果を生成しません。このフィルタを適用する前に、フィールドが日付として書式設定されており、すべての値が有効な DateTime インスタンスまたは空のセルであることを確認してください。

Aspose.Cells は、PivotField.filterByDate(PivotFilterType, params DateTime[] values) メソッドを通じて日付フィルタリングを公開しています。PivotFilterType 列挙には、Today、Yesterday、LastWeek、ThisWeek、NextWeek、LastMonth、ThisMonth、NextMonth、LastQuarter、ThisQuarter、NextQuarter、LastYear、ThisYear、NextYear、Between などの専用の日付値が含まれます。選択したフィルタタイプに応じて、1つまたは2つの DateTime 値を渡します（Between の場合は開始日と終了日を渡します）。次の例では、行エリアに日付フィールドを含むピボットテーブルを持つワークブックを読み込み、特定の日付範囲に表示されるアイテムを制限する日付フィルタを適用し、ピボットテーブルを更新してワークブックを保存します。

const AsposeCells = require("aspose.cells");
const fs = require("fs");

const inputPath = "sample.xlsx";
const outputPath = "output_filtered.xlsx";

if (!fs.existsSync(inputPath))
{
    throw new Error("Source workbook not found: " + inputPath);
}

// ピボットテーブルを含む既存のワークブックを読み込む
const workbook = new AsposeCells.Workbook(inputPath);

// ピボットテーブルを含むワークシートにインデックスでアクセスする
const worksheet = workbook.getWorksheets().get(0);

// インデックスでピボットテーブルにアクセスする
const pivotTable = worksheet.getPivotTables().get(0);

// 行エリアから日付のピボットフィールドを取得する
// (日付フィルターは、行/列エリアに日時セルまたは空白のみが含まれている場合にのみ機能します)
const dateField = pivotTable.getRowFields().get(0);

// Between フィルターの日付基準を定義する
const startDate = new Date(2020, 0, 1);
const endDate = new Date(2020, 11, 31);

// ピボットフィールドに日付フィルターを適用する
dateField.filterByDate(AsposeCells.PivotFilterType.DateBetween, startDate, endDate);

// フィルターが反映されるようにピボットテーブルを更新して再計算する
pivotTable.getPivotCache().refresh();

// ワークブックを保存する
workbook.save(outputPath);

値フィルタ

値フィルタは、ピボットテーブルがデータエリアで計算する集計値に対して機能します。テキストラベルを照合する代わりに、数値の合計をしきい値と比較します。典型的な使用例としては、売上合計が目標額を超える製品のみを表示したり、取引件数が範囲内にある地域のみを表示したりする場合があります。 Aspose.Cells は、PivotField.filterByValue(PivotField valueField, PivotFilterType filterType, params object[] values) メソッドを通じて値フィルタリングを公開しています。filterType パラメータは、ValueGreaterThan、ValueLessThan、ValueBetween、ValueEqual、ValueNotEqual、ValueGreaterThanOrEqual、ValueLessThanOrEqual などの値を使用します。valueField パラメータは評価対象のデータフィールドを指定し、最後の引数はしきい値（複数可）を指定します。次の例では、ピボットテーブルを含むワークブックを読み込み、集計された売上が数値のしきい値を超えるアイテムのみを保持する値フィルタを適用し、ピボットテーブルを更新してワークブックを保存します。

let dataFieldIndex = -1;
for (let i = 0; i < pivotTable.getDataFields().getCount(); i++) {
    if (pivotTable.getDataFields().get(i) === dataField) {
        dataFieldIndex = i;
        break;
    }
}

if (dataFieldIndex >= 0) {
    rowField.filterByValue(dataFieldIndex, AsposeCells.PivotFilterType.ValueGreaterThan, 5000, Number.MAX_VALUE);
}

pivotTable.getPivotCache().refresh();

workbook.save("output.xlsx");

トップ10フィルタ

トップ10フィルタは、選択した値フィールドに基づいて最高または最低のN件のアイテムのみを保持する値フィルタの特殊な形式です。「売上高によるトップ10製品」や「販売件数によるワースト5地域」などのランキングレポートで一般的に使用されます。

トップ10フィルタは、ピボットテーブルのデータエリアに1つ以上の値ピボットフィールドがある場合にのみ有効です。少なくとも1つの値フィールドがないと、アイテムをランク付けするための集計された指標が存在しないため、フィルタを適用できません。

Aspose.Cells は、PivotField.filterTop10(int itemCount, bool isTop, PivotField valueField, PivotFilterType filterType) メソッドを通じてトップ10フィルタリングを公開しています。itemCount パラメータは保持するアイテム数を定義し、isTop は上位アイテムを保持するかどうか（true）または下位アイテムを保持するかどうか（false）を示し、valueField はランク付けに使用されるデータフィールドを参照し、filterType は値の計算方法を制御します（通常は Sum ですが、Count や Percent も可能です）。次の例では、値フィールドを含むピボットテーブルを持つワークブックを読み込み、売上合計による上位10件のアイテムのみを保持するトップ10フィルタを適用し、ピボットテーブルを更新してワークブックを保存します。

const AsposeCells = require("aspose.cells");

// ピボットテーブルを含む既存のワークブックを読み込む
const inputPath = "input.xlsx";
const outputPath = "output.xlsx";
const workbook = new AsposeCells.Workbook(inputPath);

// ピボットテーブルを含むワークシートにアクセスする (インデックス0)
const worksheet = workbook.getWorksheets().get(0);

// インデックスでピボットテーブルにアクセスする
const pivotTable = worksheet.getPivotTables().get(0);

// データエリアに少なくとも1つの値PivotFieldがあることを確認する
if (pivotTable.getDataFields().getCount() === 0) {
    throw new Error("Pivot table has no value (data) PivotField.");
}
const valueField = pivotTable.getDataFields().get(0);

// 対象の行PivotFieldを取得する (Top 10を適用するフィールド)
const rowField = pivotTable.getRowFields().get(0);

// 最初(かつ唯一の)データフィールドはインデックス0にある; Top 10はこれでランク付けする。
const valueFieldIndex = 0;

// 行フィールドにTop 10フィルタを適用する:
//   - itemCount   = 10
//   - filterType  = PivotFilterType.Sum
//   - isTop       = true (上位N件; falseは下位N件)
//   - valueFieldIndex = アイテムをランク付けするために使用されるデータフィールドのインデックス
rowField.filterTop10(10, AsposeCells.PivotFilterType.Sum, true, valueFieldIndex);

// ピボットテーブルのデータを更新し、フィルタが反映されるように再計算する
pivotTable.getPivotTableCache().refresh();

// ワークブックを保存する
workbook.save(outputPath);

ピボットアイテムの非表示/再表示によるフィルタリング

構造化されたフィルタ API に加えて、Aspose.Cells では各個別ピボットアイテムの表示を直接制御することもできます。PivotField の PivotItems コレクションを反復処理し、IsHidden プロパティを切り替えることで、数式ベースのフィルタを適用せずに特定のアイテムを選択的に非表示にできます。IsHidden = true を設定するとアイテムがピボットテーブルから非表示になり、IsHidden = false を設定すると再表示されて再び見えるようになります。このアプローチは、フィルタリングルールが不規則またはアイテム固有の場合（特定のレポートに表示すべきではない少数の名前付きカテゴリを非表示にする場合など）に便利です。以下の例では、ピボットテーブルを読み込み、名前で特定のアイテムを非表示にし、再表示する方法を実演し、ピボットテーブルを更新してワークブックを保存します。

const AsposeCells = require("aspose.cells");

// ピボットテーブルを含む既存のワークブックを読み込む
const workbook = new AsposeCells.Workbook("pivot_table_sample.xlsx");

// ピボットテーブルを含む最初のワークシートにアクセスする
const sheet = workbook.getWorksheets().get(0);

// インデックスでピボットテーブルにアクセスする（シート上の最初のピボットテーブル）
const pivotTable = sheet.getPivotTables().get(0);

// 対象の PivotField を取得する（項目を非表示/表示する最初の行ラベルフィールド）
const pivotField = pivotTable.getRowFields().get(0);

// 選択した PivotField の PivotItems コレクションを反復処理する
const itemCount = pivotField.getPivotItems().getCount();
for (let i = 0; i < itemCount; i++)
{
    const item = pivotField.getPivotItems().get(i);

    // 特定の名前/条件に一致するピボット項目を非表示にする
    if (item.getName() == "Item1" || item.getName() == "Item2")
    {
        item.setIsHidden(true);
    }

    // 非表示解除のデモ：以前に非表示にしたピボット項目を再表示する
    if (item.getName() == "Item3")
    {
        item.setIsHidden(false);
    }
}

// 変更が反映されるようにピボットテーブルを更新して再計算する
pivotTable.getPivotCache().refreshData();

// ワークブックを保存する — 非表示の項目は基になるデータには残るが、
// 表示されるピボットテーブルの出力からは除外される
workbook.save("output_pivot_filtered.xlsx");

まとめ

Aspose.Cells for Node.js via C++ は、Microsoft Excel で利用できるものと一致する完全なピボットテーブルのフィルタリング機能を提供します。ラベル、日付、値フィルタは最も一般的な分析シナリオをカバーし、トップ10フィルタはランキングレポートを処理します。フィルタリングルールが不規則な場合は、PivotItem.IsHidden プロパティが柔軟性のあるアイテムレベルのフォールバックを提供します。これらの戦略を組み合わせること（たとえば、ラベルフィルタを適用してから特定のアイテムを非表示にする）により、ピボットテーブルのレポートを完全にコードから正確にターゲットして構築できます。

Nodejscpp: ピボットアイテムの絶対位置を指定する

Mon, 01 Jan 0001 00:00:00 +0000

時には、ユーザーがピボットアイテムの絶対位置を指定する必要があり、Aspose.Cells for Node.js via C++ APIはこれを実現するための新しいプロパティとメソッドをいくつか公開しています。

親ノードに関係なくすべてのPivotItemsの位置インデックスを指定するために使用できるPivotItem.setPositionプロパティが追加されました。- 同じ親ノード内のPivotItemsの位置インデックスを指定するために使用できるPivotItem.setPositionInSameParentNodeプロパティが追加されました。
PivotItemを移動するためのPivotItem.moveメソッドが追加されました。こちらでは、移動する位置数（count）に基づいてアイテムを上または下に移動します。count値がゼロ未満の場合、アイテムは上に移動し、count値がゼロより大きい場合は、PivotItemは下に移動します。isSameParentパラメータは、移動操作を同じ親ノード内で実行するかどうかを指定します。
*PivotItem.move(int count)*メソッドは廃止されたため、新たに追加されたPivotItem.move(number, boolean)メソッドを代わりに使用することを推奨します。

次のサンプルコードは、ピボットテーブルを作成し、その後、同じ親ノード内でのPivot Itemsの位置を指定しています。参照のために、ソースExcelおよび出力Excelファイルをダウンロードできます。出力Excelファイルを開くと、「K11」の親での0番目の位置に「4H12」アイテムが、3番目の位置に「DIF400」が表示されます。同様に、CA32は1番目の位置にあり、AAA3は2番目の位置にあります。

注意: PivotItem.setPosition、PivotItem.setPositionInSameParentNodeプロパティおよびPivotItem.moveメソッドを使用する前に、PivotTable.RefreshDataおよびPivotTable.CalculateDataメソッドを呼び出す必要があります。

Nodejscpp: PivotTableのPivotFieldのDisplayNameによってCellオブジェクトを取得する

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells for Node.js via C++は、ピボットフィールドの表示名からセルオブジェクトにアクセスできる PivotTable.getCellByDisplayName(string) メソッドを提供します。このメソッドは、ピボットフィールドのヘッダーをハイライトしたり書式設定したいときに役立ちます。この記事では、データフィールドの表示名からセルオブジェクトを取得し、その後書式設定を適用する方法について説明します。

PivotTableのPivotFieldのDisplayNameによってCellオブジェクトを取得する方法

以下のコードは、ワークシートの最初のピボットテーブルにアクセスし、ピボットテーブルの2番目のデータフィールドのDisplay名によるセルを取得します。そして、セルの塗りつぶし色とフォント色をそれぞれライトブルーとブラックに変更します。以下のスクリーンショットは、コードの実行前と後のピボットテーブルの様子を示しています。

ピボットテーブル - 実行前

ピボットテーブル - 実行後

Nodejscpp: ピボットテーブル内のPivot Fieldをグループ化

Mon, 01 Jan 0001 00:00:00 +0000

可能な使用シナリオ

Microsoft Excelでは、ピボットフィールドをグループ化できます。大量のデータが関連する場合にセクションにまとめることが有効です。Aspose.Cells for Node.js via C++もこの機能をPivotTable.groupBy()メソッドで提供しています。

Pivot TableでPivot Fieldsをグループ化する方法

以下のサンプルコードは、サンプルExcelファイルをロードし、PivotTable.groupBy()メソッドを使用して最初のピボットフィールドにグループ化を行います。それからピボットテーブルのデータをリフレッシュして計算し、ブックを出力Excelファイルとして保存します。スクリーンショットは、サンプルコードのサンプルExcelファイルに対する効果を示しています。スクリーンショットに示されているように、最初のピボットフィールドは現在月ごとと四半期ごとにグループ化されています。

サンプルコード

Nodejscpp: ピボットテーブルのデータを非表示にしたり並べ替えたり

Mon, 01 Jan 0001 00:00:00 +0000

ピボットテーブルのデータを非表示にしたり並べ替えたり

Aspose.Cells for Node.js via C++は、ピボットテーブル内のデータを非表示や並べ替えすることをサポートしています。以下のコードスニペットは、Score列を降順に並べ替え、60未満のスコアの行を非表示にする例です。

コードスニペットで使用されているソースと出力のExcelファイルは、参照用に添付されています。

ソースファイル

出力ファイル

Nodejscpp: ピボットテーブルにフィルタを追加する

Mon, 01 Jan 0001 00:00:00 +0000

可能な使用シナリオ

既知のデータでピボットテーブルを作成し、そのフィルターを設定したい場合、フィルターの利用方法を学び、使用してください。これによりデータの絞り込みが効果的に行えます。Aspose.Cells for Node.js via C++のAPIを使えば、フィールド値にフィルターを追加できます。

ピボットテーブルにフィルターを追加する Aspose.Cells for Node.js via C++

次のサンプルコードを参照してください。データを設定し、それに基づいてPivotTableを作成します。次に、ピボットテーブルの行フィールドにフィルタを追加します。最後に、output XLSX形式でブックを保存します。サンプルコードを実行した後は、ワークシートにトップ10フィルタが追加されたピボットテーブルが表示されます。

サンプルコード

Nodejscpp: ピボットテーブルのカスタムソート

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells for Node.js via C++ライブラリを使用してピボットテーブルのカスタム並べ替えを設定する方法。

Aspose.Cells for Node.js via C++ APIを使用して、ピボットテーブルのフィールド値で並べ替えが可能です。以下のコードスニペットは、サンプルExcelファイルを読み込み、3つのピボットテーブルを追加します。最初のピボットテーブルはカスタム並べ替えなし、2つ目は「SeaFood」行フィールド値で並べ替え、3つ目は「28/07/2000」列フィールド値で並べ替えられます。

サンプルソースファイルと出力ファイルは、テスト用のサンプルコードをダウンロードできます:

元のExcelファイル

出力Excelファイル

[出力PDFファイル]（98107430.pdf)

サンプルコード

Nodejscpp: ピボットテーブルのフィルタをクリアする

Mon, 01 Jan 0001 00:00:00 +0000

可能な使用シナリオ

既知のデータでピボットテーブルを作成し、フィルタリングしたい場合、フィルタを学び、使用する必要があります。これにより、必要なデータを効果的に抽出できます。Aspose.Cells for Node.js via C++ APIを使用して、ピボットテーブルのフィールド値に対して操作できます。

Excelのピボットテーブルでフィルターをクリアする方法

Excelでピボットテーブルのフィルタをクリアするには、以下の手順に従います：

クリアしたいPivotTableを選択します。
ピボットテーブルでクリアしたいフィルタのドロップダウン矢印をクリックします。
ドロップダウンメニューから「フィルタをクリア」を選択します。
ピボットテーブルからすべてのフィルタをクリアしたい場合は、ExcelのリボンのPivotTable Analyzeタブで「フィルタをクリア」ボタンをクリックすることもできます。

Aspose.Cells for Node.js via C++を使用してピボットテーブルのフィルタをクリアする方法。

Aspose.Cells for Node.js via C++を使用してピボットテーブルのフィルタをクリアしてください。以下のサンプルコードを参照してください。

データを設定し、それに基づいてPivotTableを作成します。
ピボットテーブルの行フィールドにフィルタを追加します。
output XLSX形式でブックを保存します。サンプルコードを実行した後は、ワークシートにトップ10フィルタが追加されたピボットテーブルが表示されます。
特定のピボットフィールドのフィルタをクリアします。フィルタをクリアするコードを実行した後、特定のピボットフィールドのフィルタがクリアされます。output XLSXをご確認ください。

Documentation – Aspose.Cells for Node.js via C++ でピボットテーブルの行フィールドと列フィールドを追加する

Nodejscpp: ラベルまたは値によるピボットテーブルのフィルタリング

はじめに

ラベルフィルタ

日付フィルタ

値フィルタ

トップ10フィルタ

ピボットアイテムの非表示/再表示によるフィルタリング

まとめ

関連記事

Nodejscpp: ピボットアイテムの絶対位置を指定する

Nodejscpp: PivotTableのPivotFieldのDisplayNameによってCellオブジェクトを取得する

PivotTableのPivotFieldのDisplayNameによってCellオブジェクトを取得する方法

Nodejscpp: ピボットテーブル内のPivot Fieldをグループ化

可能な使用シナリオ

Pivot TableでPivot Fieldsをグループ化する方法

サンプルコード

Nodejscpp: ピボットテーブルのデータを非表示にしたり並べ替えたり

ピボットテーブルのデータを非表示にしたり並べ替えたり

Nodejscpp: ピボットテーブルにフィルタを追加する

可能な使用シナリオ

ピボットテーブルにフィルターを追加する Aspose.Cells for Node.js via C++

サンプルコード

Nodejscpp: ピボットテーブルのカスタムソート

Aspose.Cells for Node.js via C++ライブラリを使用してピボットテーブルのカスタム並べ替えを設定する方法。

サンプルコード

Nodejscpp: ピボットテーブルのフィルタをクリアする

可能な使用シナリオ

Excelのピボットテーブルでフィルターをクリアする方法

Aspose.Cells for Node.js via C++を使用してピボットテーブルのフィルタをクリアする方法。

サンプルコード