Sayfalandırılmış raporu XML'ye aktarma (Rapor Oluşturucusu)

Şunlar için geçerlidir: SQL Server Veri Araçları'nda Microsoft Rapor Oluşturucusu (SSRS) Power BI Rapor Oluşturucusu Rapor Tasarımcısı

XML işleme uzantısı, XML biçiminde sayfalandırılmış bir rapor döndürür. Rapor XML'sinin şeması rapora özgüdür ve yalnızca verileri içerir. XML işleme uzantısı düzen bilgilerini işlemez ve sayfalandırmayı korumaz. Bu uzantı tarafından oluşturulan XML bir veritabanına aktarılabilir, XML veri iletisi olarak kullanılabilir veya özel bir uygulamaya gönderilebilir.

Uyarı

Sayfalandırılmış rapor tanımı (.rdl) dosyalarını Microsoft Rapor Oluşturucusu'nda, Power BI Rapor Oluşturucusu'nda ve SQL Server Veri Araçları'ndaki Rapor Tasarımcısı'nda oluşturabilir ve değiştirebilirsiniz.

Rapor Öğeleri

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

Ürün	İş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.
Map	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. Veri çubuğu genellikle 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.
Indicator	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 görüntü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
Other	xsd:string

XML'e Özgü gösterim kuralları

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

Rapor içeriği

Rapor, XML belgesinin kök öğesi olarak işlenir. öğesinin adı DataElementName bölmesinde ayarlanan özellikten gelir.

XML ad alanı tanımları ve şema başvuru öznitelikleri de rapor öğesine eklenir. Değişkenler <> içinde belirtilmiştir.

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

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

İsim	Değer
Report	Report.DataElementName
RaporURL	URL Sunucudaki raporun mutlak URL'sini kodla.
SchemaName	Report.SchemaName. Eğer null ise, o zaman Report.Name. Eğer Report.Name kullanılırsa, değer ilk olarak XmlConvert.EncodeLocalName ile kodlanır.
Rapor Adı	Raporun adı.

Metin kutuları

Metin kutuları RDL özelliğine DataElementStyle göre öğe veya öznitelik olarak işlenir. Öğenin veya özniteliğin adı RDL özelliğinden TextBox.DataElementName 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ı RDL özelliğinden DataElementName alınır. Raporun TextBoxesAsElements özellik ayarı, alt raporun özelliğini geçersiz kılar. Ad alanı ve XSLT öznitelikleri alt rapor öğesine eklenmez.

Dikdörtgen

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ı tarafından görülemez. Raporda özel bir rapor öğesi varsa, işleme uzantısı bunu geleneksel bir rapor öğesi olarak işler.

Resimler

Görüntüler işlenmez.

Satır

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. Öğenin 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ı RDL özelliğinden TablixMember.DataElementName gelir.

TablixMember.DataElementOutput RDL özelliği, tekrarlanmayan bir öğenin görüntülenip görüntülenmediğini denetler.

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

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

ColumnY: Tekrarlanmayan sütunlar için, Y'nin geçerli üst öğe içinde sıfır tabanlı bir sütun dizini olduğu durumlarda.

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

Yinelenmeyen bir üyenin karşılık gelen Tablix hücresi yoksa işlenmez. Bu sonuç, birden fazla sütuna yayılan bir Tablix hücresiyse ortaya çıkabilir.

Bir grupla tekrarlanan satırlar ve sütunlar

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

Bir grup içindeki her benzersiz değer, grubun alt öğesi olarak işlenir. öğesinin adı özelliğinden Group.DataElementName 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üştürmeleri

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, rapor tanımı dosyasında tanımlanır. Alternatif olarak, XSLT DeviceInfo parametresiyle belirtilebilir.

Bu değerlerden biri ayarlanırsa dönüştürme, XML işleyicisi her kullanıldığında gerçekleşir. Abonelikleri kullandığınızda, XSLT RDL DataTransform özelliğinde tanımlanmalıdır.

Bir XSLT dosyası belirtilirse, hem DataTransform tanım özelliği hem de cihaz bilgileri ayarı bunu belirtiyorsa, önce DataTransform içinde belirtilen XSLT uygulanır, ardından cihaz bilgileri ayarları tarafından belirlenen XSLT uygulanır.

Cihaz Bilgileri Ayarları

Aşağıdaki ayarlar da 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

• Raporlama Hizmetleri'nde Sayfalandırma (Rapor Oluşturucusu ve SSRS)
• İşleyici davranışları (Rapor Oluşturucusu ve SSRS)
• Farklı rapor işleme uzantıları için etkileşimli işlevsellik (Rapor Oluşturucusu ve SSRS)
• Rapor öğelerini işleme (Rapor Oluşturucusu ve SSRS)
• Tablolar, matrisler ve listeler (Rapor Oluşturucusu ve SSRS)