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

UiPath.Excel.Activities.Business.CreatePivotTable

Creates a pivot table from a specified workbook range or table to help you calculate, summarize, and analyze data. Once added, you can add pivot table fields as rows, columns, filters, or summary fields. You can use the activity with an Excel file selected for a parent Use Excel File activity or with the Project Notebook.

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

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

プロジェクトの対応 OS

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

構成

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

プロパティ

入力

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

  既定値は [compact] です。

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

オプション

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

ブックを使用する

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

既知の制限事項

制限事項 1

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

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

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

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

回避策

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

制限事項 2

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