次の方法で共有

レポート定義言語 (RDL)

  • [アーティクル]

適用対象: Power BI Report Builder Power BI Desktop

レポート定義言語 (RDL) は、改ページ対応レポートの定義の XML 表現です。 レポート定義には、レポートのデータ取得とレイアウトの情報が含まれます。 RDL は、Power BI 用に作成された XML 文法と一致する XML 要素で構成されます。 レポート定義ファイル内のコード ブロックにアクセスすることによって、レポート アイテムの値、スタイル、書式設定を制御するための独自のカスタム機能を追加できます。

RDL は、レポート定義の交換を可能にする共通スキーマを定義することで、商用レポート製品の相互運用性を促進します。 XML で使用できるプロトコルまたはプログラム インターフェイスは RDL で使用できます。 RDL は次のように定義できます。

  • レポート定義の XML スキーマ
  • ビジネスおよびサード パーティ用の交換形式
  • 追加の名前空間とカスタム要素をサポートする拡張可能で開放型のスキーマ

RDL の仕様

特定のスキーマ バージョンの仕様をダウンロードするには、「 レポート定義言語の仕様」を参照してください。

RDL XML スキーマ定義

レポート定義言語 (RDL) ファイルは、XML スキーマ定義 (XSD) ファイルを使って検証されます。 スキーマでは、.rdl ファイル内で RDL 要素を使用できる場所に関する規則を定義しています。 要素には、データ型とカーディナリティ (要素を使用できる回数) が含まれます。 要素には、単純なものも複雑なものもあります。 単純な要素には、子要素または属性がありません。 複雑な要素には、子要素のほか、必要に応じて属性を指定できます。

たとえば、スキーマには、 ReportParametersType複合型の RDL 要素 ReportParametersが含まれます。 通常、要素の複合型の名前は、要素名の後に Typeという単語が続きます。 ReportParameters 要素は、 Report 要素 (複合型) に含めることができ、 ReportParameter 要素を含むことができます。 ReportParameterType は単純型で、 Boolean、 DateTime、 Integer、 Float、または Stringのいずれかの値のみを指定できます。 XML スキーマ データ型の詳細については、「 XML スキーマ第 2 部: データ型 (第 2 版)」を参照してください。

RDL の作成

RDL は開放型で拡張可能な性質を持つため、XML スキーマに基づき RDL を生成するさまざまなツールとアプリケーションを作成できます。

Power BI Report Builder は、RDL ベースの改ページ対応レポートを作成するための推奨される方法です。

アプリケーションから RDL を生成する最も簡単な方法の 1 つは、Microsoft .NET Framework 名前空間と System.Xml 名前空間の System.Linq クラスを使用することです。 特に、 XmlTextWriter クラスは RDL の記述に使用できます。 XmlTextWriterを使用すると、任意の .NET Framework アプリケーションで完全なレポート定義を最初から最後まで生成できます。 開発者は、カスタム プロパティを持つカスタム レポート アイテムを追加して、RDL を拡張することもできます。 XmlTextWriter クラスおよび System.Xml 名前空間の詳細については、「Microsoft .NET Framework 開発者ガイド」を参照してください。 言語統合クエリ (LINQ) の詳細については、MSDN で「LINQ to XML」を検索してください。

レポート定義の標準的なファイル拡張子は .rdl です。 MIME の種類は text/xml です。

RDL の型

次の表に、RDL 要素および属性で使用される型を示します。

型 説明
Binary base-64 でエンコードされたバイナリ値を持つプロパティです。
Boolean オブジェクトの値として true または false を持つプロパティです。 特に指定しない限り、オプションのブール値オブジェクトを省略した場合の値は Falseです。
日付 ISO8601 の日付形式 (YYYY-MM-DD[THH:MM[:SS[.S]]]) で指定した、完全指定の日付または datetime の値を持つプロパティです。
Enum 文字列テキストの値を持つプロパティです。値は指定値の一覧のうちのいずれかである必要があります。
Float 浮動小数点数値を持つプロパティです。 オプションの 10 進区切り記号として、ピリオド (.) が使用されます。
整数 整数 (int32) 値を持つプロパティです。
Language 米国英語を表す "en-us" などの言語文化コードを含むテキスト値を持つプロパティです。 値は、特定の言語か、Microsoft .NET Framework で既定の言語が定義されたニュートラル言語である必要があります。
名前 文字列テキストの値を持つプロパティです。 名前は、アイテムの名前空間内で一意である必要があります。 指定しない場合、名前を持つ最も内側のオブジェクトが、アイテムの名前空間となります。
NormalizedString 正規化された文字列テキストの値を持つプロパティです。
Size サイズ要素には、数値が含まれている必要があります (小数点としてピリオドを使用)。 数値の後には、cm、mm、in、pt、pc など、CSS 長さ単位の指定子を入力する必要があります。 数値と指定子の間のスペースは省略可能です。 サイズ指定子の詳細については、「CSS Values and Units Reference (CSS の値と単位のリファレンス)」を参照してください。

RDL では、 Size の最大値は 160 インチで、 最小サイズは 0 インチです。
String 文字列テキストの値を持つプロパティです。
UnsignedInt 符号なし整数 (uint32) 値を持つプロパティです。
Variant 任意の単純な XML 型を持つプロパティです。

RDL のデータ型

DataType 列挙は、RDL で属性、式、またはパラメーターのデータ型を定義します。 次の表に、共通言語ランタイム (CLR) データ型と RDL データ型の対応を示します。

CLR 型 対応するデータ型
Boolean Boolean
DateTime、DateTimeOffset DateTime
Int16、Int32、UInt16、Byte、SByte Integer
Single、Double Float
String、Char、GUID、Timespan String

関連するコンテンツ