Öğesi Path sözdizimi için xml raporu verileri (ssrs)

Rapor Tasarımcısı rapor xml veri kaynağından bir duyarlı öğesi yolu tanımlayarak kullanmak için veri belirtin. Öğe yolu, XML hiyerarşik düğümlerinin ve bunların özniteliklerinin XML veri kaynağına nasıl geçirileceğini belirtir. Varsayılan öğe yolunu kullanmak için, veritabanı sorugusunu veya XML Query için XML ElementPath öğesini boş bırakın. XML veri kaynağından veri alındığında, metin değerlerine ve öğe düğümü özniteliklerine sahip öğe düğümleri sonuç kümesinin sütunları olur. Sorguyu çalıştırdığınızda, düğümlerin ve özniteliklerin değerleri satır verileri haline gelir. Sütunlar, Rapor Verileri bölmesinde veri kümesi alanı koleksiyonu olarak görülür. Bu konu, öğe yolu sözdizimini açıklamaktadır.

[!NOT]

Öğe yolu sözdizimi ad alanından bağımsızdır. Öğe yolunda ad alanları kullanmak için, bir XML ElementPath öğesi içeren XML sorgu sözdizimini kullanın (xml sorgu sözdizimi için xml raporu verileri (ssrs) konusunda açıklanmıştır).

Aşağıdaki tabloda, öğe yolu tanımlamak için kullanılan kurallar açıklanmaktadır.

Sözdizimi

Element path ::=
    ElementNode[/Element path]
ElementNode ::=
    XMLName[(Encoding)][{[FieldList]}]
XMLName ::=
    [NamespacePrefix:]XMLLocalName
Encoding ::=
        HTMLEncoded | Base64Encoded
FieldList ::=
    Field[,FieldList]
Field ::=
    Attribute | Value | Element | ElementNode
Attribute ::=
        @XMLName[(Type)]
Value ::=
        @[(Type)]
Element ::=
    XMLName[(Type)]
Type ::=
        String | Integer | Boolean | Float | Decimal | Date | XML 
NamespacePrefix ::=
    Identifier that specifies the namespace.
XMLLocalName :: =
    Identifier in the XML tag. 

Açıklamalar

Aşağıdaki tabloda öğe yolu deyimleri özetlenmektedir. Tablodaki örnekler, bu konunun Örnekler bölümünde verilen Müşteriler.xml adlı örnek XML belgesine başvurmaktadır.

[!NOT]

XML etiketleri büyük/küçük harfe duyarlıdır. Öğe yolunda bir ElementNode belirttiğinizde, veri kaynağında XML etiketlerini tam olarak eşleştirmelisiniz.

Örnek - Ad Alanları Yok

Aşağıdaki örneklerde, xml belgesini Customers.xml kullanın. Bu tablo, sorguda veri kaynağı olarak xml belgesini temel alan bir veri kümesi tanımlayan öğe yolu kullanmanın sonuçları ve öğesi path sözdizimi örnekleri gösterir.

[!NOT]

Sorgu öğesi yolu boş olduğunda, varsayılan öğe yolu kullanır: yaprak düğüm koleksiyonu ilk yolu. İlk örnekte, öğe yolunun boş bırakılması /Müşteriler/Müşteri/Siparişler/Sipariş öğe yolunun belirtilmesiyle eşdeğerdir. Yol içindeki tüm düğüm değer ve öznitelikleri sonuç kümesinde döndürülür ve düğüm adları ve öznitelik adları veri kümesi alanları olarak görünür.

XML belgesi: Müşteriler.xml

Önceki bölümde öğesi yolu örnekleri denemek için size bu xml kopyalayıp rapor Tasarımcısı tarafından erişilebilen bir URL'ye kaydedin ve sonra xml belgesini bir xml veri kaynağı olarak kullanabilirsiniz: Örneğin, https://localhost/Customers.xml.

<?xml version="1.0"?>
<Customers xmlns="https://www.adventure-works.com">
   <Customer ID="11">
      <FirstName>Bobby</FirstName>
      <LastName>Moore</LastName>
      <Orders>
         <Order ID="1" Qty="6">Chair</Order>
         <Order ID="2" Qty="1">Table</Order>
      </Orders>
      <Returns>
         <Return ID="1" Qty="2">Chair</Return>
      </Returns>
   </Customer>
   <Customer ID="20">
      <FirstName>Crystal</FirstName>
      <LastName>Hu</LastName>
      <Orders>
         <Order ID="8" Qty="2">Sofa</Order>
      </Orders>
      <Returns/>
   </Customer>
   <Customer ID="33">
      <FirstName>Wyatt</FirstName>
      <LastName>Diaz</LastName>
      <Orders>
         <Order ID="15" Qty="2">EndTables</Order>
      </Orders>
      <Returns/>
   </Customer>
</Customers>

<?xml version="1.0"?>
<Customers xmlns="https://www.adventure-works.com">
   <Customer ID="11">
      <FirstName>Bobby</FirstName>
      <LastName>Moore</LastName>
      <Orders>
         <Order ID="1" Qty="6">Chair</Order>
         <Order ID="2" Qty="1">Table</Order>
      </Orders>
      <Returns>
         <Return ID="1" Qty="2">Chair</Return>
      </Returns>
   </Customer>
   <Customer ID="20">
      <FirstName>Crystal</FirstName>
      <LastName>Hu</LastName>
      <Orders>
         <Order ID="8" Qty="2">Sofa</Order>
      </Orders>
      <Returns/>
   </Customer>
   <Customer ID="33">
      <FirstName>Wyatt</FirstName>
      <LastName>Diaz</LastName>
      <Orders>
         <Order ID="15" Qty="2">EndTables</Order>
      </Orders>
      <Returns/>
   </Customer>
</Customers>

Alternatif olarak, bağlantı dizesi olmayan bir XML veri kaynağı oluşturabilir ve Müşteri.XML’yi sorguya katıştırırken aşağıdaki yordamı kullanabilirsiniz:

Müşteri.XML’yi sorguya katıştırmak için:

1. Boş bağlantı dizeli bir XML veri kaynağı oluşturun.

2. XML veri kaynağı için yeni bir veri kümesi oluşturun.

3. Veri Kümesi Özellikleri iletişim kutusunda Sorgu Tasarımcısı’nı tıklatın. Metin tabanlı sorgu tasarımcısı iletişim kutusu açılır.

4. Sorgu bölmesine aşağıdaki iki satırı girin:

   <Query>

   <XmlData>

5. Müşteriler.XML’yi kopyalayın ve metni sorgu bölmesinde <XmlData>’dan sonraya yapıştırın.

6. Sorgu bölmesinde, Müşteriler.XML’den kopyaladığınız ilk satırı silin: <?xml version="1.0"?>

7. Sorgunun sonuna aşağıdaki iki satırı ekleyin:

   <XmlData>

   <Query>

8. Sorguyu Çalıştır’ı tıklatın (!).

   Sonuç kümesi, şu sütunları içeren 4 satır verisi görüntüler: xmlns, Customer.ID, FirstName, LastName, ID, Qty, Order.

9. Tamam’ı tıklatın.

Ayrıca bkz.

Görevler

Rapor Verileri Bölmesinde Alan Ekleme, Düzenleme, Yenileme (Rapor Oluşturucusu ve SSRS)

Kavramlar

odbc bağlantı türü (ssrs)

Diğer Kaynaklar

Tutorials (Reporting Services)