ピボット テーブルを作成 (ワークブック)

UiPath.Excel.Activities.Business.CreatePivotTable

指定のブックの範囲または表からピボット テーブルを作成し、データの計算、要約、および分析を支援します。このアクティビティを追加すると、ピボット テーブルのフィールドを、行、列、フィルター、または要約フィールドとして追加できます。このアクティビティは、親の [Excel ファイルを使用] アクティビティで選択した Excel ファイルまたはプロジェクト ノートブックに使用できます。

注: サポートされているブックの形式は、.xls、.xlsm、.xltm、.xlsx、.xltx です。

このアクティビティの使い方については、「チュートリアル: ピボット テーブルを作成する」をご覧ください。

プロジェクトの対応 OS

Windows | クロスプラットフォーム

構成

• ファイル (ローカル パス) - ブックのフル ローカル パスです。ファイル リソースに切り替えるには、プラス記号のアイコンを選択し、[ファイル リソースを使用] を選択します。現在のフィールドが [ファイル] に変更され、リソース ブックのフル パスを指定できます。
• テーブル ソースを使用 - このオプションは既定では無効化されています。有効化すると、[元のシート] フィールドと [元の範囲] フィールドが [元の表の名前] に置き換えられます。
• 元の表の名前 - ピボットの元の表の名前です。
• 元のシート - ピボット テーブルのソース データのシートです。
• 元の範囲 - ピボット テーブルのソース データの範囲です。指定しない場合、シート全体が使用されます。
• ピボットのシート名 - ピボット テーブルを配置するシートです。シートが存在しない場合は、作成されます。
• ピボットの配置セル - ピボット テーブル (フィルターを含む) の左上のセルです。既定値は A1 です。
• ピボット テーブル名 - ピボット テーブルの名前です。
• ピボット テーブルのフィールド - ピボット テーブルのフィールドです。

プロパティ

入力

• レイアウト - ピボット テーブルのレイアウトと書式を指定します。以下のオプションから選択できます。
  • コンパクト - テーブルが見やすく表示されます。
  • 表 - ファイルのヘッダーが含まれます。
  • 概要 - ファイルのヘッダーが含まれます。

  既定値は [compact] です。

• 次として値を追加 - ピボット テーブルに値を追加する方法 ([列] または [行]) を選択します。既定のオプションは [列] です。

オプション

• パスワード - 任意で、ブックのパスワードを入力します。

ブックを使用する

• ブック - 使用する既存のブックです。

既知の制限事項

制限事項 1

ブックにすでに存在するピボット テーブルを作成しようとした場合、[ピボット テーブルを作成 (ワークブック)] アクティビティは正しく機能しません。

基になる ClosedXML ライブラリの制限のため、次のシナリオは完全にはサポートされません。

• 既存のピボット テーブルを削除する
• ピボット テーブルを含むシートを削除する

既存のピボット テーブルを同じブック内に再作成すると、Excel ファイルが破損したり、実行時エラーが発生したりする可能性があります。

回避策

• 目的の名前を持つピボット テーブルが存在しない場合は、通常どおり作成されます。
• 目的の名前を持つピボット テーブルが存在していて、ソース データが同じである場合、既存のピボット テーブルが更新されます。
• 目的の名前を持つピボット テーブルが存在しても、ソース データが異なる場合、例外がスローされます。

制限事項 2

このアクティビティは、ピボット テーブルの外部ソースをサポートしていません。