HTML にレンダリングする (レポート ビルダー)

HTML 表示拡張機能は、ページ分割されたレポートを HTML 形式で表示します。 また、完全な HTML ページを生成することも、他の HTML ページに埋め込むための HTML の一部分を生成することもできます。 すべての HTML は、UTF-8 エンコードで生成されます。

HTML 表示拡張機能は、SQL Server 2016 (13.x) Reporting Services 以降 (SSRS) Web ポータルで実行する場合など、ブラウザーで表示されるレポートの既定の表示拡張機能です。 HTML レンダリング拡張機能は、HTML をフラグメントまたは完全な HTML ドキュメントとしてレンダリングできます。 HTML がフラグメントの場合は、HTML ドキュメントの HEAD、 HTML、 BODY タグが削除されます。 BODY タグの内容のみがレンダリングされます。 この結果は、別のアプリケーションによって生成された HTML に HTML を埋め込む場合に役立ちます。

一部のシナリオでは、レポートパラメーターを使用して、レポートを HTML にレンダリングするときにスクリプトインジェクション攻撃を開始できます。 レポートのセキュリティ保護の詳細については、「レポートとリソースの保護」を参照してください。

ブラウザーの詳細については、「 Reporting Services のブラウザーサポート」を参照してください。

注

ページ分割されたレポートの定義ファイル (.rdl) は、Microsoft レポート ビルダー、Power BI レポート ビルダー、または SQL Server Data Tools のレポート デザイナーを使用して作成および変更できます。

MHTML でのレンダリング

HTML 表示拡張機能では、MHTML (集計 HTML ドキュメントの MIME カプセル化) でレポートをレンダリングすることもできます。 MHTML は HTML を拡張して、画像などのエンコードされたオブジェクトを HTML ドキュメントに埋め込みます。 MHTML 表示拡張機能を使用すると、画像、ドキュメント、その他のバイナリ ファイルなどのリソースを、レポート HTML 内の MIME 構造として 1 つのファイルに埋め込むことができます。 MHTML レポートは、すべてのリソースがレポートに含まれているため、電子メール メッセージ内に埋め込む場合にも役立ちます。 実際には MHTML をレンダリングする HTML レンダリング拡張機能ですが、この機能は MHTML レンダリング拡張機能とも呼ばれます。

ブラウザー サポート

この表示拡張機能では、次のブラウザー バージョンがサポートされています。

  • Internet Explorer 5.5 以降

  • Firefox 1.5 以降

  • Safari 3.0 以降

ブラウザー間の考慮事項により、表示されるレポートはブラウザーによって若干異なる場合があります。 たとえば、テキスト ボックスには WritingMode というプロパティが含まれています。 このプロパティは Firefox ではサポートされていません。

HTML 固有のレンダリング ルール

レンダリング時には、次の HTML 固有のルールが適用されます。

  • レンダラーは HTML テーブル構造を構築し、複数ある場合は各 ReportItems コレクション内のすべてのアイテムを格納します。

  • テーブル構造内のすべての項目は、1 つのセルを占有します。

  • 空のセルをできる限りまとめて HTML のサイズを小さくします。

  • ブラウザーがテーブルをレンダリングできる速度を向上させるために、空のセルの行が上端に追加され、別の列が左端に追加されます。

  • 項目を含まないテーブル行または列には、項目間のギャップだけが、固定幅と高さが指定されます。

  • 他のすべての行と列は、各レポート アイテムのサイズに応じて拡大できます。

  • すべての座標とレポート アイテムのサイズはミリメートルに変換されます。 スタイル プロパティを含む他のすべてのサイズは、元の単位を保持します。 0.2 mm 未満のサイズと位置の違いは、0 mm として扱われます。

対話機能

一部の対話型要素は HTML でサポートされています。 次のセクションでは、具体的な動作について説明します。

表示と非表示

表示を切り替えることができるレポート アイテムは、+/- トグル 画像で表示され、選択可能です。 項目が選択されると、変更された show または hide 状態で出力を再レンダリングするために、サーバーへのコールバックが行われます。

ドキュメント マップ

ドキュメント マップ ラベルがレンダリングされ、ビューアー コントロールのドキュメント マップを使用して移動できます。 省略されたデータ領域ヘッダーの場合、ラベルは最初の子セルに表示されます。 子セルが存在しない場合は、その前の子セルにラベルが表示されます。

Bookmarks

ブックマーク リンクがレンダリングされ、ハイパーリンクとして表示されます。 ブックマーク ターゲットがレンダリングされ、ブックマーク リンクを選択して移動できます。 ブックマーク リンクが選択されると、レポートはターゲット ブックマーク ラベルの最初の出現箇所に移動します。 その後、可能な場合はブラウザーがスクロールされ、ブックマーク リンクがウィンドウの上部に表示されます。 HTML アンカー (<a>) タグは、ブックマーク ターゲットをマークするために使用されます。

インタラクティブな並べ替え

テキスト ボックスにユーザーの並べ替えが定義されている場合、HTML 表示拡張機能はテキスト ボックス内の並べ替えアイコンをコンテンツの右側にレンダリングします。 ユーザーの並べ替えが定義されているテキスト ボックスがレポートに含まれている場合は、JavaScript が表示されます。 並べ替えイメージが選択されると、JavaScript によってサーバーへのポストバックが発生します。

ハイパーリンクとドリルスルー リンクは、定義されているアイテムを囲む HTML アンカー (<a>) タグを使用して、レポート アイテムにハイパーリンクとして表示されます。

検索機能を使用すると、ユーザーはレポート内のテキストの文字列を検索できます。

ReportViewer Web フォーム コントロールには、より多くの検索機能と検索機能が用意されています。

クライアント コンピューターでのフォント

レポート内でカスタム フォントを使用する場合、レポートの表示に使用するコンピューター (クライアント コンピューター) には、レポートが正しく表示されるようにカスタム フォントがインストールされている必要があります。 フォントがクライアント コンピューターにインストールされていない場合、レポートにはカスタム フォントではなくシステムの既定のフォントが表示されます。

デバイス情報設定

デバイス情報の設定を変更することで、レンダリングするモードなど、このレンダラーの既定の設定を変更できます。 詳細については、「 HTML デバイス情報の設定」を参照してください。