レポート定義言語 (RDL) は、SQL Server Reporting Services レポート定義の XML 表現です。 レポート定義には、レポートのデータ取得とレイアウト情報が含まれています。 RDL は、 Reporting Services用に作成された XML 文法に準拠する XML 要素で構成されます。 レポート定義ファイル内のコード アセンブリにアクセスすることで、レポート項目の値、スタイル、および書式設定をコントロールする独自のカスタム関数を追加できます。
RDL は、レポート定義の交換を可能にする共通スキーマを定義することで、商用レポート製品の相互運用性を促進します。 XML で使用できるプロトコルまたはプログラム インターフェイスは RDL で使用できます。 RDL は次のように定義できます。
レポート定義の XML スキーマ
ビジネスおよびサード パーティ用の交換形式
追加の名前空間とカスタム要素をサポートする拡張可能で開かれたスキーマ。
RDL の仕様
特定のスキーマ バージョンの仕様をダウンロードするには、「 レポート定義言語の仕様」を参照してください。
RDL XML スキーマ定義
SQL Server Reporting Services レポート定義言語 (RDL) ファイルは、XML スキーマ定義 (XSD) ファイルを使用して検証されます。 スキーマでは、.rdl ファイル内で RDL 要素を使用できる場所に関する規則を定義しています。 要素には、そのデータ型とカーディナリティ、つまり許可される出現回数が含まれます。 要素には、単純なものも複雑なものもあります。 単純な要素には、子要素または属性がありません。 複合要素には子要素があり、必要に応じて属性も持ちます。
たとえば、スキーマには、複合型ReportParametersTypeである RDL 要素ReportParametersが含まれています。 慣例により、要素の複合型は、 Typeという単語の後に続く要素の名前です。
ReportParameters要素は、Report要素 (複合型) に含めることができます。また、ReportParameter要素を含めることができます。
ReportParameterTypeは、Boolean、DateTime、Integer、Float、またはStringのいずれかの単純型です。 XML スキーマ データ型の詳細については、「 XML スキーマ第 2 部: データ型 (第 2 版)」を参照してください。
RDL XSD は、ReportDefinition.xsd ファイルから入手できます。このファイルは製品 CD-ROM の Extras フォルダーにあります。 レポート サーバーでは、次の URL を使用して使用することもできます。 https://servername/reportserver/reportdefinition.xsd.
RDL の作成
RDL のオープンで拡張可能な性質により、XML スキーマに基づいて RDL を生成するさまざまなツールやアプリケーションを構築できます。
Reporting Services には、RDL ファイルを作成するための複数のツールが用意されています。 詳細については、「 Reporting Services ツール」を参照してください。
アプリケーションから RDL を生成する最も簡単な方法の 1 つは、 System.Xml 名前空間と System.Linq 名前空間の Microsoft .NET Framework クラスを使用することです。 特に、1 つのクラスである XmlTextWriter クラスを使用して RDL を記述できます。 XmlTextWriterを使用すると、任意の .NET Framework アプリケーションで完全なレポート定義を最初から最後まで生成できます。 開発者は、カスタム プロパティを使用してカスタム レポート アイテムを追加することで、RDL を拡張することもできます。 XmlTextWriter クラスと System.Xml 名前空間の詳細については、Microsoft .NET Framework 開発者ガイドを参照してください。 Language-Integrated クエリ (LINQ) の詳細については、MSDN で 「LINQ to XML」を検索してください。
レポート定義ファイルの標準ファイル拡張子は .rdl です。 拡張子が .rdlc のクライアント レポート定義ファイルを開発することもできます。 どちらの拡張子の場合も、MIME の種類は text/xml です。 レポートの詳細については、「 Reporting Services レポート (SSRS)」を参照してください。
RDL 型
次の表に、RDL 要素および属性で使用される型を示します。
| タイプ | 説明 |
|---|---|
Binary |
base-64 でエンコードされたバイナリ値を持つプロパティです。 |
Boolean |
オブジェクトの値として true または false を持つプロパティ。 特に指定しない限り、省略可能な Boolean オブジェクトの値は False。 |
Date |
ISO8601 の日付形式 (YYYY-MM-DD[THH:MM[:SS[.S]]]) で指定した、完全指定の日付または datetime の値を持つプロパティです。 |
Enum |
文字列テキストの値を持つプロパティです。値は指定値の一覧のうちのいずれかである必要があります。 |
Float |
浮動小数点数値を持つプロパティです。 オプションの 10 進区切り記号として、ピリオド (.) が使用されます。 |
Integer |
整数 (int32) 値を持つプロパティです。 |
Language |
米国英語を表す "en-us" などの言語文化コードを含むテキスト値を持つプロパティです。 値は、特定の言語か、Microsoft .NET Framework でデフォルトの言語が定義されたニュートラル言語である必要があります。 |
Name |
文字列テキストの値を持つプロパティです。 名前は、アイテムの名前空間内で一意である必要があります。 指定しない場合、名前を持つ最も内側のオブジェクトが、アイテムの名前空間となります。 |
NormalizedString |
正規化された文字列テキスト値を持つプロパティ。 |
Size |
size 要素には数値を含む必要があります (省略可能な小数点区切り記号としてピリオド文字が使用されます)。 数値の後に、cm、mm、in、pt、pc などの CSS 長さ単位の指定子が続く必要があります。 数値と指定子の間のスペースは省略可能です。 サイズ指定子の詳細については、 CSS 長さ単位リファレンスを参照してください。 RDL では、 Size の最大値は 160 インチです。 最小サイズは 0 インチです。 |
String |
文字列テキストの値を持つプロパティです。 |
UnsignedInt |
符号なし整数 (uint32) 値を持つプロパティです。 |
Variant |
任意の単純な XML 型を持つプロパティです。 |
RDL データ型
DataType 列挙型は、RDL の属性、式、またはパラメーターのデータ型を定義します。 次の表に、共通言語ランタイム (CLR) データ型と RDL データ型の対応を示します。
| CLR 型 | 対応するデータ型 |
|---|---|
| ボーリアン | ボーリアン |
| DateTime、DateTimeOffset | 日付と時間 |
| Int16、Int32、UInt16、Byte、SByte | 整数 |
| Single、Double | 浮く |
| String、Char、GUID、Timespan | 糸 |
こちらもご覧ください
レポート定義スキーマのバージョンの検索 (SSRS)
レポートでのカスタム アセンブリの使用
カスタム レポート アイテム