Aracılığıyla paylaş

Power BI sayfalandırılmış raporunu XML'ye aktarma (Power BI Rapor Oluşturucusu)

  • Makale

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

XML işleme uzantısı, XML biçiminde bir Power BI sayfalandırılmış raporu döndürür. Rapor XML'sinin şeması rapora özgüdür ve yalnızca verileri içerir. Düzen bilgileri işlenmez ve sayfalandırma XML işleme uzantısı tarafından korunmaz. Bu uzantı tarafından oluşturulan XML bir veritabanına aktarılabilir, XML veri iletisi olarak kullanılabilir veya özel bir uygulamaya gönderilebilir.

Not

Power BI Rapor Oluşturucusu sayfalandırılmış rapor tanımı (.rdl) dosyaları oluşturabilir ve değiştirebilirsiniz.

Rapor öğeleri

Aşağıdaki tabloda rapor öğelerinin nasıl işlendiği açıklanmaktadır.

Kalem İşleme davranışı
Report XML belgesinin en üst düzey öğesi olarak işlenir.
Veri bölgeleri kapsayıcısı için öğesi içinde bir öğe olarak işlenir. Veri bölgeleri, verileri metin ve grafik olarak görüntüleyen tablo, matris ve liste, veri çubukları, mini grafikler, ölçerler ve verileri görselleştiren göstergeler içerir.
Grup ve ayrıntı bölümleri Her örnek, kapsayıcısı için öğesi içinde bir öğe olarak işlenir.
Metin kutusu Kapsayıcısı içinde bir öznitelik veya öğe olarak işlenir.
Dikdörtgen Kapsayıcısı içinde bir öğe olarak işlenir.
Matris sütun grupları Satır grupları içinde öğe olarak işlenir.
Harita kapsayıcısı için öğesi içinde bir öğe olarak işlenir. Harita katmanları haritanın alt öğeleridir ve her harita katmanı, harita üyeleri ve eşleme üyesi öznitelikleri için öğeler içerir.
Grafik kapsayıcısı için öğesi içinde bir öğe olarak işlenir. Seriler grafiğin alt öğeleridir ve kategoriler bir serinin alt öğesidir. Her grafik değeri için tüm grafik etiketlerini işler. Etiketler ve değerler öznitelik olarak eklenir.
Veri çubuğu Bir grafiğe benzer şekilde kapsayıcısı için öğesi içinde bir öğe olarak işlenir. Genellikle, veri çubuğu hiyerarşileri veya etiketleri içermez, yalnızca değerleri içerir.
Mini Grafik Bir grafiğe benzer şekilde kapsayıcısı için öğesi içinde bir öğe olarak işlenir. Mini grafik genellikle hiyerarşileri veya etiketleri içermez, yalnızca değerleri içerir.
Ölçer kapsayıcısı için öğesi içinde bir öğe olarak işlenir. Ölçeğin en düşük ve en yüksek değerleri, aralığın başlangıç ve bitiş değerleri ve işaretçinin değeri öznitelik olarak tek bir öğe olarak işlenir.
Gösterge Bir ölçere benzer şekilde kapsayıcısı için öğesi içinde bir öğe olarak işlenir. Etkin durum adı, kullanılabilir durumlar ve veri değeri öznitelik olarak tek bir öğe olarak işlenir.

XML işleme uzantısı kullanılarak işlenen raporlar da şu kurallara uyar:

  • XML öğeleri ve öznitelikleri, rapor tanımında göründükleri sırayla işlenir.

  • Sayfalandırma yoksayılır.

  • Sayfa üst bilgileri ve alt bilgileri işlenmez.

  • Geçiş ile görünür yapılmayan gizli öğeler işlenmez. Başlangıçta görünür öğeler ve bir geçiş aracılığıyla görünür hale getirilebilen gizli öğeler işlenir.

  • Görüntüler, satırlar ve özel rapor öğeleri yoksayılır.

Veri türleri

Metin kutusu öğesine veya özniteliğine, metin kutusunun görüntülediği değerlere göre bir XSD veri türü atanır.

Tüm metin kutusu değerleri Atanan veri türü:
Int16, Int32, Int64, UInt16, UInt32, UInt64, Byte, SByte xsd:integer
Ondalık (veya Ondalık ve herhangi bir tamsayı veya bayt veri türü) xsd:decimal
Float (veya Ondalık ve herhangi bir tamsayı veya bayt veri türü) xsd:float
Çift (veya Ondalık ve herhangi bir tamsayı veya bayt veri türü) xsd:double
DateTime veya DateTime Uzaklığı xsd:dateTime
Time xsd:string
Boolean xsd:boolean
Dize, Karakter xsd:string
Diğer xsd:string

XML'e özgü işleme kuralları

Aşağıdaki bölümlerde, XML işleme uzantılarının rapordaki öğeleri nasıl yorumlediği açıklanmaktadır.

Rapor gövdesi

Rapor, XML belgesinin kök öğesi olarak işlenir. öğesinin adı, Özellikler bölmesindeki DataElementName özellik kümesinden gelir.

XML ad alanı tanımları ve şema başvuru öznitelikleri de rapor öğesine eklenir. Değişkenler kalın yüz türünde belirtilir:

<Report xmlns="SchemaName" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="SchemaNameReportURL&rc%3aSchema=true" Name="ReportName">

Değişkenlerin değerleri aşağıdaki gibidir:

Veri Akışı Adı Değer
Report Report.DataElementName
Reporturl URL Sunucudaki raporun mutlak URL'sini kodla.
SchemaName Report.SchemaName. Null ise Report.Name. Report.Name kullanılırsa, ilk olarak XmlConvert.EncodeLocalName ile kodlanır.
Raporadı Raporun adı.

Metin kutuları

Metin kutuları DataElementStyle RDL özelliğine göre öğe veya öznitelik olarak işlenir. Öğenin veya özniteliğin adı TextBox.DataElementName RDL özelliğinden gelir.

Grafikler, veri çubukları ve mini grafikler

Grafikler, veri çubukları ve mini grafikler XML'de işlenir. Veriler yapılandırılmıştır.

Ölçerler ve göstergeler

Ölçerler ve göstergeler XML olarak işlenir. Veriler yapılandırılmıştır.

Alt raporlar

Alt rapor bir öğe olarak işlenir. öğesinin adı DataElementName RDL özelliğinden alınır. Raporun TextBoxesAsElements özellik ayarı, alt raporun ayarını geçersiz kılar. Ad alanı ve XSLT öznitelikleri alt rapor öğesine eklenmez.

Dikdörtgenler

Dikdörtgen bir öğe olarak işlenir. öğesinin adı DataElementName RDL özelliğinden alınır.

Özel rapor öğeleri

CustomReportItems (CRI) işleme uzantısına görünmez. Raporda özel bir rapor öğesi varsa, işleme uzantısı bunu geleneksel bir rapor öğesi olarak işler.

Görüntüler

Görüntüler işlenmez.

Hatlar

Satırlar işlenmez.

Tablolar, matrisler ve listeler

Tablolar, matrisler ve listeler bir öğe olarak işlenir. öğesinin adı Tablix DataElementName RDL özelliğinden gelir.

Satırlar ve sütunlar

Sütunlar satırlar içinde işlenir.

Tablix köşesi

Köşe işlenmedi. Yalnızca köşenin içeriği işlenir.

Tablix hücreleri

Tablix hücreleri öğe olarak işlenir. öğesinin adı, hücrenin DataElementName RDL özelliğinden alınır.

Otomatik alt toplamlar

Tablix otomatik alt toplamları işlenmez.

Grupla yinelenmeyen satır ve sütun öğeleri

Etiketler, alt toplamlar ve toplamlar gibi bir grupla yinelenmemiş öğeler öğe olarak işlenir. öğesinin adı TablixMember.DataElementName RDL özelliğinden gelir.

TablixMember.DataElementOutput RDL özelliği, yinelenmeyen bir öğenin işlenip işlenmediğini denetler.

Tablix üyesinin DataElementName özelliği sağlanmamışsa, yinelenmeyen öğe için dinamik olarak şu biçimde bir ad oluşturulur:

RowX Yinelenen olmayan satırlar için, burada X geçerli üst öğe içinde sıfır tabanlı bir satır dizinidir.

SütunY Geçerli üst öğe içinde sıfır tabanlı bir sütun dizinini Y'nin katladığı, yinelenmeyen sütunlar için.

Yinelenmeyen üst bilgi, bir grupla yinelenmeyen satırın veya sütunun alt öğesi olarak işlenir.

Yinelenen olmayan bir üyenin karşılık gelen Tablix hücresi yoksa işlenmez. Bu, birden fazla sütuna yayıldığı bir Tablix hücresinde ortaya çıkabilir.

Bir grupla tekrarlanan satırlar ve sütunlar

Bir grup içinde yinelenen satırlar ve sütunlar Tablix.DataElementOutput kurallarına göre işlenir. öğesinin adı DataElementName özelliğinden alınır.

Bir grup içindeki her benzersiz değer, grubun alt öğesi olarak işlenir. Öğesinin adı Group.DataElementName özelliğinden alınır.

DataElementOutput özellik değeri Output değerine eşitse, yinelenen öğenin üst bilgisi ayrıntı öğesinin alt öğesi olarak işlenir.

Özel biçimler ve XSL Dönüşümleri

XML işleme uzantısı tarafından üretilen XML dosyaları, XSL Dönüştürmeleri (XSLT) kullanılarak hemen her biçime dönüştürülebilir. Bu işlev, mevcut işleme uzantıları tarafından desteklenmeyen biçimlerde veri üretmek için kullanılabilir. Kendi işleme uzantınızı oluşturmaya çalışmadan önce XML işleme uzantısını ve XSLT'yi kullanmayı göz önünde bulundurun.

Yinelenen adlar

Aynı kapsamda yinelenen veri öğesi adları varsa, işleyici bir hata iletisi görüntüler.

XSLT dönüştürmeleri

XML işleyicisi, özgün XML verilerine sunucu tarafı XSLT dönüşümü uygulayabilir. XSLT uygulandığında, işleyici özgün XML verileri yerine dönüştürülmüş içeriği verir. Dönüştürme istemcide değil sunucuda gerçekleşir.

Çıkışa uygulanacak XSLT, raporun DataTransform özelliğiyle veya XSLT DeviceInfo parametresiyle rapor tanımı dosyasında tanımlanır. Bu değerlerden biri ayarlanırsa dönüştürme, XML işleyicisi her kullanıldığında gerçekleşir. Abonelikleri kullanırken, XSLT RDL DataTransform özelliğinde tanımlanmalıdır.

Bir XSLT dosyası belirtilirse, hem DataTransform tanımı özelliği hem de cihaz bilgileri ayarı tarafından DataTransform'da belirtilen XSLT önce gerçekleşir, ardından cihaz bilgileri ayarları tarafından ayarlanan XSLT gerçekleşir.

Cihaz bilgileri ayarları

Aşağıdakiler de dahil olmak üzere cihaz bilgileri ayarlarını değiştirerek bu işleyici için bazı varsayılan ayarları değiştirebilirsiniz:

  • XML'ye uygulanacak bir dönüştürme (XSLT).

  • XML belgesinin MIME türü.

  • Verilere biçim dizelerinin uygulanıp uygulanmayacağı.

  • XML çıkışının girintilenip girintili olmaması.

  • XML şema adının eklenip eklenmeyeceği.

  • XML belgesinin kodlaması.

  • XML belgesinin dosya uzantısı.

Daha fazla bilgi için bkz . XML cihaz bilgileri ayarları.

İlgili içerik