適用対象: Microsoft Report Builder (SSRS)
Power BI Report Builder
SQL Server Data Tools の レポート デザイナー
CSV (コンマ区切り値) 表示拡張機能では、レポートのデータを平面的に表して、標準化されたプレーンテキスト形式でページ分割されたレポートを表示します。プレーンテキスト形式のレポートは、多くのアプリケーションで簡単に読み取ったり変換したりすることができます。
CSV 表示拡張機能は、文字による区切り記号を使用してフィールドと行を分けます。この区切り記号には、コンマ以外の文字を使用するように構成できます。 エクスポートされたファイルは、Microsoft Excel などのスプレッドシート プログラムで開いたり、他のプログラムのインポート形式として使用できます。 エクスポートされたレポートは .csv ファイルとなり、MIME の種類として text/csvを返します。
グラフ、データ バー、スパークライン、ゲージ、インジケーターに関連するデータを Microsoft Excel で操作する場合は、レポートを CSV ファイルにエクスポートし、そのファイルを Microsoft Excel で開きます。
CSV 形式へのエクスポート方法の詳細については、「レポートのエクスポート (Report Builder および SSRS)」を参照してください。
注
ページ分割されたレポートの定義ファイル (.rdl) は、Microsoft レポート ビルダー、Power BI レポート ビルダー、または SQL Server Data Tools のレポート デザイナーを使用して作成および変更できます。
CSV レンダリング
既定の設定を使用して表示された場合、CSV 形式のレポートは次のような特徴のレポートになります。
既定のフィールド区切り記号は、コンマ (
,) です。注
フィールド区切り記号を任意の文字 (タブなど) に変更するには、デバイス情報設定を変更します。 詳しくは、CSV のデバイス情報設定に関する記事をご覧ください。
レコード区切り記号は、キャリッジ リターンとライン フィードの組み合わせ (
<cr><lf>) です。テキスト修飾子は、引用符 (
") です。CSV レンダラーは、すべての文字列の周りに修飾子を追加するわけではありません。 テキスト修飾子が追加されるのは、値に区切り文字が含まれている場合、または値に改行が含まれている場合のみです。
テキストに区切り記号や修飾子が埋め込まれている場合は、テキスト修飾子でテキストが囲まれ、テキスト中に埋め込まれた修飾子は 2 つ重ねて使用されます。
書式およびレイアウトは無視されます。
表示中は次のアイテムが無視されます。
ページヘッダー
ページフッター
カスタムレポート項目
線
Image
長方形
自動小計
残りのレポート アイテムは、上から下、次に左から右の順に並べ替えられます。 その後、各アイテムが列に生成されます。 レポートに一覧やテーブルなどの入れ子になったアイテムがある場合は、親アイテムが各レコードに繰り返し使用されます。
次の表では、表示した際のレポート アイテムの外観について説明します。
| 項目 | レンダリングの挙動 |
|---|---|
| テキスト ボックス | テキスト ボックスの内容を表示します。 既定のモードでは、アイテムは、そのアイテムの書式設定プロパティに基づいて書式が設定されます。 準拠モードでは、デバイス情報設定によって書式設定を変更できます。 CSV レンダリング モードの詳細については、この記事で後述します。 |
| 表 | テーブルを展開して表示します。最も詳細なレベルでの各行と列に対応した、行と列が作成されます。 集計の行と列には、列見出しまたは行見出しは付けられません。 ドリルスルー レポートはサポートされていません。 |
| Matrix | マトリックスを展開して表示します。最も詳細なレベルでの各行と列に対応した、行と列が作成されます。 集計の行と列には、列見出しまたは行見出しは付けられません。 |
| リスト | 一覧の詳細行またはインスタンスそれぞれに対応するレコードが表示されます。 |
| サブレポート | 親アイテムは、コンテンツのインスタンスごとに繰り返し表示されます。 |
| グラフ | 各グラフ値およびメンバー ラベルに対して行を作成して表示します。 階層内の系列およびカテゴリのラベルは、フラット化され、グラフ値の行内に含まれています。 |
| データバー | グラフのように表示されます。 通常、データ バーには階層またはラベルは含まれません。 |
| スパークライン | グラフのように表示されます。 通常、スパークラインには階層またはラベルは含まれません。 |
| ゲージ | 線形スケールの最小値/最大値、範囲の開始値/終了値、およびポインターの値を含む単一のレコードとして表示されます。 |
| インジケーター | アクティブな状態名、使用可能な状態、およびデータ値を持つ単一のレコードとして表示されます。 |
| マップ | マップ レイヤーのマップ メンバーごとにラベルと値のある行を表示します。 マップに複数のレイヤーがある場合、同じマップ データ領域を使用しているか、異なるマップ データ領域を使用しているかによって行の値が変化します。 複数のマップ レイヤーが同じデータ領域を使用している場合、行にはすべてのレイヤーからのデータが含まれます。 |
階層とグループ化のデータ
階層データとグループ化データは、CSV 形式で表示するためにフラット化する必要があります。
表示拡張機能では、レポートをフラット化して、データ領域内で入れ子になっているグループを表すツリー構造にします。 レポートをフラット化する手順は次のとおりです。
行階層は列階層より先にフラット化されます。
列が並べ替えられます。本文中のテキスト ボックスが左から右、上から下に並べ替えられた後、データ領域が左から右、上から下に並べ替えられます。
データ領域内の列が、コーナーのメンバー、行階層メンバー、列階層メンバー、セルの順に並べ替えられます。
ピア データ リージョンは、共通のデータ リージョンまたは動的祖先を共有するデータ リージョンまたは動的グループです。 ピア データがフラットなツリーの分岐で識別されます。
詳細については、テーブル、マトリックス、および一覧 (レポート ビルダーおよび SSRS) に関するページをご覧ください。
レンダリング モード
CSV 表示拡張機能は 2 つのモードで操作できます。1 つは Excel に最適なモード、もう 1 つは、RFC 4180 の CSV 仕様に厳密に準拠することが要求される Microsoft 以外のアプリケーションに最適なモードです。 使用するモードによって、ピア データ領域の処理は異なります。
既定モード
既定のモードは Excel 向けに最適化されたモードです。 既定のモードで表示された場合、CSV 表示データの複数のセクションが含まれた CSV ファイルとしてレポートが表示されます。 各ピア データ領域は空の行で区切られます。 レポート本文内のピア データ領域は、CSV ファイル内で個別のデータ ブロックとして表示されます。 その結果、CSV ファイル内は次のようになります。
レポート本文内の個々のテキスト ボックスは、CSV ファイル内の最初のデータ ブロックとして 1 回表示されます。
レポート本文内の最上位レベルのピア データ領域はそれぞれ、独自のデータ ブロック内に表示されます。
入れ子になったデータ領域は、同じデータ ブロックで対角線上に表示されます。
形式
数値は、書式設定された状態で表示されます。 Excel は、通貨、パーセンテージ、日付などの書式設定された数値を認識できます。また、CSV ファイルをインポートする場合、セルの書式を適切に設定します。
準拠モード
準拠モードは、Microsoft 以外のアプリケーション向けに最適化されます。
データ領域
ファイルの最初の行のみに列ヘッダーが含まれます。また、各行の列数は同じになります。
形式
値の書式は設定されていません。
対話機能
このレンダラーは、生成された CSV 形式での対話機能をサポートしていません。 次の対話型要素は表示されません。
ハイパーリンク
表示/非表示
見出しマップ
ドリルスルーまたはクリックスルーのリンク
エンドユーザーによる並べ替え
ヘッダーを修正
ブックマーク
デバイス情報設定
このレンダラーの既定の設定を変更できます。 この設定には、表示モード、区切り記号として使用する文字、テキスト修飾子の既定の文字として使用する文字が含まれます。 これらの設定は、デバイス情報の設定を変更することで変更できます。 詳しくは、CSV のデバイス情報設定に関する記事をご覧ください。