Aracılığıyla paylaş

Rapor Tanımı Dili (RDL)

ŞUNLAR IÇIN GEÇERLIDIR: Power BI Desktop Rapor Oluşturucusu Power BI

Rapor Tanımı Dili (RDL), sayfalandırılmış rapor tanımının XML gösterimidir. Rapor tanımı, raporun veri alma ve düzen bilgilerini içerir. RDL, Power BI için oluşturulan XML dil bilgisi ile eşleşen XML öğelerinden oluşur. Rapor tanımı dosyalarındaki kod bloklarına erişerek rapor öğesi değerlerini, stillerini ve biçimlendirmesini denetlemek için kendi özel işlevlerinizi ekleyebilirsiniz.

RDL, rapor tanımlarının değişimini sağlayan ortak bir şema tanımlayarak ticari raporlama ürünlerinin birlikte çalışabilirliğini teşvik eder. XML ile çalışan herhangi bir protokol veya program arabirimi RDL ile kullanılabilir. RDL:

  • Rapor tanımları için bir XML şeması.
  • İşletmeler ve üçüncü taraflar için değişim biçimi.
  • Ek ad alanlarını ve özel öğeleri destekleyen genişletilebilir ve açık bir şema.

RDL belirtimleri

Belirli şema sürümlerine ilişkin belirtimleri indirmek için bkz . Rapor Tanımı Dil Belirtimi.

RDL XML şema tanımı

Rapor Tanımı Dili (RDL) dosyası bir XML Şema Tanımı (XSD) dosyası kullanılarak doğrulanır. Şema, RDL öğelerinin bir .rdl dosyasında nerede gerçekleşebileceğine ilişkin kuralları tanımlar. Bir öğe veri türünü ve kardinalitesini, yani izin verilen oluşum sayısını içerir. Bir öğe basit veya karmaşık olabilir. Basit bir öğenin alt öğeleri veya öznitelikleri yoktur. Karmaşık bir öğenin alt öğeleri ve isteğe bağlı olarak öznitelikleri vardır.

Örneğin şema, ReportParametersType karmaşık türü olan ReportParameters RDL öğesini içerir. Kurala göre, bir öğe için karmaşık bir tür, Tür sözcüğünün izlediği öğenin adıdır. ReportParameters öğesi Report öğesi (karmaşık bir tür) tarafından bulunabilir ve ReportParameter öğelerini içerebilir. ReportParameterType şu değerlerden yalnızca biri olabilecek basit bir türdür: Boole, DateTime, Integer, Float veya String. XML Şeması veri türleri hakkında daha fazla bilgi için bkz . XML Şeması Bölüm 2: Datatypes second Edition.

RDL oluşturma

RDL'nin açık ve genişletilebilir yapısı nedeniyle, XML şemasına göre RDL oluşturan çeşitli araçlar ve uygulamalar oluşturulabilir.

Power BI Rapor Oluşturucusu, RDL tabanlı sayfalandırılmış raporlar yazmanın tercih edilen yoludur.

Bir uygulamadan RDL oluşturmanın en kolay yollarından biri, ad alanı ve System.Linq ad alanının Microsoft .NET Framework sınıflarını System.Xml kullanmaktır. Özellikle bir sınıf olan XmlTextWriter sınıfı, RDL yazmak için kullanılabilir. XmlTextWriter ile herhangi bir .NET Framework uygulamasında baştan sona eksiksiz bir rapor tanımı oluşturabilirsiniz. Geliştiriciler ayrıca özel özelliklere sahip özel rapor öğeleri ekleyerek RDL'nin kapsamını genişletebilir. XmlTextWriter sınıfı ve System.Xml ad alanı hakkında daha fazla bilgi için bkz. Microsoft .NET Framework Geliştirici Kılavuzu. Dil Tümleşik Sorgusu (LINQ) hakkında daha fazla bilgi için MSDN'de "LINQ to XML" araması yapın.

Rapor tanımı dosyaları için standart dosya uzantısı .rdl'dir. MIME türü metin/xml'dir.

RDL türleri

Aşağıdaki tabloda RDL öğelerinde ve özniteliklerinde kullanılan türler listelenmiştir.

Type Açıklama
İkili Base-64 kodlanmış ikili değerine sahip bir özellik.
Boolean Nesnenin değeri olarak true veya false içeren bir özellik. Aksi belirtilmedikçe, atlanmış isteğe bağlı Boole nesnesinin değeri False'tur.
Date Tam olarak belirtilen tarih veya tarih saat değeri ISO8601 tarih biçiminde belirtilen bir özellik: YYYY-AA-GG[SS:DD[SS[:SS[. S]]].
Sabit Listesi Belirlenmiş değerler listesinden biri olması gereken dize metin değerine sahip bir özellik.
Yüzmek Kayan değere sahip bir özellik. İsteğe bağlı ondalık ayırıcı olarak nokta (.) kullanılır.
Tamsayı Tamsayı (int32) değerine sahip bir özellik.
Dil ABD İngilizcesi için "en-us" gibi bir dil ve kültür kodu içeren metin değerine sahip bir özellik. Değerin, Microsoft .NET Framework'te varsayılan bir dilin tanımlandığı belirli bir dil veya nötr bir dil olması gerekir.
Ad Dize metin değerine sahip bir özellik. Adlar öğenin ad alanında benzersiz olmalıdır. Belirtilmezse, bir öğenin ad alanı, adı olan en içteki nesnedir.
NormalizedString Normalleştirilmiş dize metin değerine sahip bir özellik.
Büyüklük Boyut öğesi bir sayı içermelidir (isteğe bağlı ondalık ayırıcı olarak kullanılan nokta karakteriyle). Sayıyı cm, mm, in, pt veya pc gibi bir CSS uzunluk birimi için bir belirleyici takip etmelidir. Sayı ve belirleyici arasındaki boşluk isteğe bağlıdır. Boyut belirleyicileri hakkında daha fazla bilgi için bkz . CSS Değerleri ve Birim Başvurusu.

RDL'de Boyut için maksimum değer 160 in'dir. En küçük boyut 0 in'dir.
Dize Dize metin değerine sahip bir özellik.
UnsignedInt İşaretsiz tamsayı (uint32) değerine sahip bir özellik.
Varyant Herhangi bir basit XML türüne sahip bir özellik.

RDL veri türleri

DataType Numaralandırması, RDL'de bir özniteliğin, ifadenin veya parametrenin veri türünü tanımlar. Aşağıdaki tabloda, ortak dil çalışma zamanı (CLR) veri türlerinin RDL veri türlerine nasıl karşılık olduğu gösterilmektedir.

CLR Türleri İlgili Veri Türü
Boolean Boolean
DateTime, DateTimeOffset DateTime
Int16, Int32, UInt16, Byte, SByte Tamsayı
Tek, Çift Satışa Arz
Dize, Karakter, GUID, Zaman Aralığı String

İlgili içerik