Udostępnij za pośrednictwem

  • Artykuł

Składnia ścieżki elementu umożliwiająca określanie danych raportu w formacie XML (program Report Builder 2.0)

W programie Report Builder 2.0 można określić pochodzące ze źródła danych XML dane, które będą używane w raporcie, definiując ścieżkę elementu, w której jest rozróżniana wielkość liter.Ścieżka elementu wskazuje sposób przejścia przez hierarchiczne węzły XML i ich atrybuty w źródle danych XML.Aby użyć domyślnej ścieżka elementu, należy pozostawić zestawu danych kwerendy lub pliku XML ElementPath XML Query puste. Gdy dane są pobierane ze źródła danych XML, węzły elementów mające wartości tekstowe i atrybuty węzłów elementów stają się kolumnami w zestawie wyników.Po uruchomieniu zapytania wartości węzłów i atrybutów stają się danymi wierszy.Kolumny są wyświetlane w okienku Dane raportu jako kolekcja pól zestawu danych.W tym temacie opisano składnię ścieżki elementu.

Uwaga

Składnia ścieżki elementu jest niezależna od obszaru nazw.Aby użyć obszarów nazw w ścieżce elementu, należy użyć składni kwerendy XML, który zawiera XML ElementPath element opisaną w Składnia zapytania XML umożliwiająca określanie danych raportu w formacie XML (program Report Builder 2.0).

W poniższej tabeli opisano konwencje używane do definiowania ścieżki elementu.

Konwencja

Zastosowanie

pogrubienie

Tekst, który należy wpisać dokładnie tak jak pokazano.

| (pionowa kreska)

Rozdziela elementy składni.Można wybrać tylko jeden z elementów.

[ ] (nawiasy kwadratowe)

Opcjonalne elementy składni.Nie należy wpisywać nawiasów kwadratowych.

{ } (w nawiasach klamrowych)

Rozdziela elementy składni parametrów.

[,...n]

Wskazuje, można powtórzyć poprzedni element n Liczba określająca, ile razy. Wystąpienia są rozdzielane przecinkami.

 
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.

Remarks

W poniższej tabeli podsumowano terminy dotyczące ścieżki elementu.Przykłady w tej tabeli odwołują się do przykładowego dokumentu XML o nazwie Customers.xml, który wchodzi w skład sekcji Przykłady w tym temacie.

Uwaga

W tagach XML jest rozróżniana wielkość liter.Element ElementNode określony w ścieżce elementu musi dokładnie pasować do tagów XML w źródle danych.

Termin

Definicja

Ścieżka elementu

Definiuje kolejność węzłów na przechodzenie przez w dokumencie XML do pobierania pole danych dla danych ze urządzenie źródłowe danych XML.

ElementNode

Węzeł XML w dokumencie XML.Węzły są wyznaczane przez tagi i mają hierarchiczną relację z innymi węzłami.Na przykład <Klienci> to węzeł elementu głównego. <Odbiorcy> jest podelement z <Klienci>.

XMLName

Nazwa węzła.Na przykład nazwa węzła Customers to Customers.An XMLName can be prefixed with a namespace identifier to uniquely name every node.

Encoding

Wskazuje, że Value dla tego elementu jest zakodowany XML i potrzeb być dekodowane i zawarte w podelemencie tego elementu.

FieldList

Definiuje zestaw elementów i atrybutów, które będą używane do pobierania danych.

Jeśli ten element nie zostanie określony, wszystkie atrybuty i podelementy będą używane jako pola.Jeśli lista puste pole jest określony){}), są używane nie pola z tego węzła.

A FieldList nie może zawierać zarówno Value a Element lub ElementNode.

Field

Określa dane, które są pobierane jako pole danych.

Attribute

Para nazwa wartość, w ramach ElementNode. Na przykład w węzeł elementu <Identyfikator klienta = "1">, ID jest to atrybut i @ID(Integer)Zwraca wartość "1" jako typ liczby całkowitej w odpowiednich pole danych ID.

Value

The value of the element.Value can only be used on the last ElementNode in the element path.Na przykład ponieważ <Zwrot> jest węzłem liść, jeśli zostanie ona umieszczona na końcu ścieżka elementu, wartość Return {@} jest Chair.

Element

Wartość nazwanego podelementu.Na przykład użycie ścieżki Customers {}/Customer {}/LastName spowoduje pobranie wartości tylko dla elementu LastName.

Type

Wpisz dane opcjonalne dla pole utworzone z tego elementu.

NamespacePrefix

NamespacePrefix jest zdefiniowany w elemencie XML kwerendy.Jeśli żaden element XML kwerendy, obszary nazw w pliku XML ElementPath są ignorowane. Jeśli istnieje element XML kwerendy XML ElementPath ma atrybut opcjonalny IgnoreNamespaces. Jeśli IgnoreNamespaces jest true, obszary nazw w pliku XML ElementPath i dokumentu XML, są ignorowane. Aby uzyskać więcej informacji zobaczSkładnia zapytania XML umożliwiająca określanie danych raportu w formacie XML (program Report Builder 2.0).

Przykład — brak obszarów nazw

W następujących przykładach użyto Customers.xml dokumentu XML.W tej tabela pokazano przykłady składni ścieżka elementu oraz wyniki kwerendy, która definiuje zestaw danych, na podstawie dokumentu XML jako urządzenie źródłowe danych przy użyciu ścieżka elementu.

Uwaga

Ścieżka elementu jest pusta, domyślna ścieżka elementu używanych przez kwerendę: pierwsza ścieżka do kolekcja węzeł liścia. W pierwszym przykładzie pozostawienie pustej ścieżki elementu jest równoznaczne z określeniem ścieżki elementu /Customers/Customer/Orders/Order.Wszystkie wartości i atrybuty węzłów w ścieżce są zwracane w zestawie wyników, a nazwy węzłów i nazwy atrybutów są wyświetlane jako pola zestawu danych.

Przykład

Pola w zestawie danych

Pusta ścieżka
OrderQtyIdentyfikatorFirstNameLastNameCustomer.IDxmlns
Chair61BobbyMoore11https://www.adventure-works.com
Table12BobbyMoore11https://www.adventure-works.com
Sofa28CrystalHu20https://www.adventure-works.com
EndTables215WyattDiaz33https://www.adventure-works.com

Customers {}/Customer
FirstNameLastNameIdentyfikator
BobbyMoore11
CrystalHu20
WyattDiaz33

Customers {}/Customer {}/LastName
LastName
Moore
Hu
Diaz

Customers {}/Customer {}/Orders/Order {@,@Qty}
OrderQty
Chair6
Table1
Sofa2
EndTables2

Customers {}/Customer/Orders/Order{ @ID(Integer)}
Order.IDFirstNameLastNameIdentyfikator
1BobbyMoore11
2BobbyMoore11
8CrystalHu20
15WyattDiaz33

Dokument XML: Customers.XML

Wypróbować przykłady ścieżka elementu w poprzedniej sekcji, skopiuj ten XML i zapisać go na adres URL, który jest dostępny przez Konstruktora raportów, a następnie użyć dokument XML jako urządzenie źródłowe danych XML: na przykład, 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>

Można także utworzyć źródło danych XML bez parametrów połączenia i osadzić plik Customers.XML w zapytaniu, używając następującej procedury:

Aby osadzić plik Customers.XML w zapytaniu

  1. Utwórz źródło danych XML z pustymi parametrami połączenia.

  2. Utwórz nowy zestaw danych dla źródła danych XML.

  3. W Właściwości zestawów danych okno dialogowe kliknijprojektant kwerend.Zostanie otwarte okno dialogowe tekstowego projektanta zapytań.

  4. W okienku zapytania wprowadź dwa następujące wiersze:

    <Query>

    <XmlData>

  5. Customers.XML skopiować i wkleić tekst w okienku kwerendy po <XmlData>.

  6. W okienku kwerendy usuń pierwszego wiersza, które zostały skopiowane z Customers.XML: <?xml version="1.0"?>

  7. Na końcu zapytania dodaj dwa następujące wiersze:

    <XmlData>

    <Query>

  8. Kliknij przycisk Uruchom kwerendę (!).

    Zestaw wyników zawiera 4 wiersze danych w następujących kolumnach: xmlns, Customer.ID, FirstName, LastName, ID, Qty, Order.

  9. Click OK.