Exporting to XML
Rozszerzenie renderowania w formacie XML zwraca raport w formacie XML.Schemat dla raportu XML dotyczy wyłącznie danego raportu i zawiera tylko dane.Rozszerzenie renderowania w formacie XML nie renderuje informacji dotyczących układu i nie zachowuje podziału na strony.Plik XML wygenerowany przez to rozszerzenie można zaimportować do bazy danych, a także można użyć go jako wiadomości z danymi w formacie XML lub wysłać do aplikacji niestandardowej.
W poniższej tabeli opisano sposób renderowania elementów raportu.
Element |
Zachowanie podczas renderowania |
|---|---|
Report |
Jest renderowany jako element najwyższego poziomu dokumentu XML. |
Obszary danych |
Jest renderowany jak element w obrębie elementu dla odnośnego kontenera. |
Sekcje grupy i szczegółów |
Każde wystąpienie jest renderowane jako element w obrębie elementu dla odnośnego kontenera. |
Pole tekstowe |
Jest renderowane jako atrybut lub element w obrębie odnośnego kontenera. |
Rectangle |
Jest renderowany jako element w obrębie odnośnego kontenera. |
Grupy kolumn macierzy |
Są renderowane jako elementy w obrębie grup wierszy. |
Raporty, które są renderowane przy użyciu kodu XML rozszerzenie renderujące także przestrzegać tych reguł:
Elementy i atrybuty XML są renderowane w kolejności, w jakiej pojawiają się w definicji raportu.
Podział na strony jest ignorowana.
Nagłówki i stopki stron nie są renderowane.
Elementy ukryte, których nie można ustawić jako widocznych za pomocą przełączania, nie są renderowane.Początkowo widoczne elementy i elementy ukryte, które można ustawić jako widoczne za pomocą przełączania, są renderowane.
Images, lines, and custom report items są ignorowane.
Typy danych
Na podstawie wartości wyświetlanych w polu tekstowym do elementu lub atrybutu pola tekstowego jest przypisywany typ danych XSD.
Jeżeli wszystkie wartości pola tekstowego to |
Przypisywany typ danych to |
|---|---|
Int16, Int32, Int64, UInt16, UInt32, UInt64, Byte, SByte |
xsd:integer |
Decimal (lub Decimal i dowolnego typu danych Liczba całkowita lub bajtów) |
xsd:decimal |
Float (lub Decimal i dowolnego typu danych Liczba całkowita lub bajtów) |
xsd:float |
Double (lub Decimal i dowolnego typu danych Liczba całkowita lub bajtów) |
xsd:double |
DateTime or DateTime Offset |
xsd:dateTime |
Time |
xsd:string |
Boolean |
xsd:boolean |
String, Char |
xsd:string |
Inne |
xsd:string |
Reguły renderowania specyficzne dla formatu XML
W poniższych sekcjach opisano, w jaki sposób renderowania rozszerzeń XML interpretuje elementów w raporcie.
Treść raportu
Raport jest renderowany jako element główny dokumentu XML.Nazwa elementu pochodzi z DataElementName Właściwość zestaw w okienku właściwości.
Definicje obszarów nazw XML i atrybuty odwołań do schematu również są uwzględniane w elemencie raportu.Zmienne wyróżniono czcionką pogrubioną:
<Raport xmlns=”Nazwa_schematu” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xsi:Lokalizacja_schematu=”Nazwa_schematuAdres_URL_raportu&rc%3aSchema=true” Name=”Nazwa_raportu”>
Wartości zmiennych są następujące:
Imię i nazwisko |
Wartość |
|---|---|
Report |
Report.DataElementName |
Adres_URL_raportu |
Zakodowany bezwzględny adres URL raportu na serwerze. |
Nazwa_schematu |
Report.SchemaName.Jeśli ta wartość jest równa null, jest używana wartość Report.Name.Jeśli jest używana wartość Report.Name, jest ona najpierw kodowana za pomocą metody XmlConvert.EncodeLocalName. |
ReportName |
Nazwa raportu. |
Pola tekstowe
Pola tekstowe są renderowane jako elementów lub atrybutów zgodnie z DataElementStyle Właściwość RDL. Nazwa elementu lub atrybut pochodzi z TextBox. DataElementName Właściwość RDL.
Wykresy
Wykresy są renderowane w formacie XML.Dane wykresu są strukturalizowane.
Podraporty
Podraport jest renderowany jako element.Nazwa elementu jest pobierana z DataElementName Właściwość RDL. The TextBoxesAsElements właściwość setting of the report overrides that of the podraport. Obszar nazw i atrybuty XSLT nie są dodawane do elementu podraportu.
Prostokąty
Prostokąt jest renderowany jako element.Nazwa elementu jest pobierana z DataElementName Właściwość RDL.
Niestandardowe elementy raportu
CustomReportItems (CRI) nie są widoczne dla rozszerzeń renderowania.Jeśli w raporcie znajduje się niestandardowy element raportu, rozszerzenie renderowania renderuje go jak konwencjonalny element raportu.
Obrazy
Obrazy nie są renderowane.
Lines
Linie nie są renderowane.
Tabele, macierze i listy
Tabele, macierze i listy są renderowane jako elementy.Nazwa elementu pochodzi z Tablix DataElementName Właściwość RDL.
Wiersze i kolumny
Kolumny są renderowane w obrębie wierszy.
Narożnik elementu Tablix
Narożnik nie jest renderowany.Renderowana jest tylko zawartość narożnika.
Komórki elementu tablix
Komórki elementu tablix są renderowane jako elementy.Nazwa elementu jest pobierana z komórka DataElementName Właściwość RDL.
Automatyczne sumy częściowe
Automatyczne sumy częściowe elementu tablix nie są renderowane.
Elementy wierszy i kolumn, które nie są powtarzane w grupie
Elementy, które nie są powtarzane w grupie, takie jak etykiety, sumy częściowe i sumy, są renderowane jako elementy.Nazwa elementu pochodzi z TablixMember. DataElementName Właściwość RDL.
The TablixMember.DataElementOutput Właściwość RDL kontroluje, czy element niepowtarzającym jest renderowane.
Jeśli DataElementName nie podano właściwość element członkowski członkowskiego Tablix, nazwę element członkowski niepowtarzającym dynamicznie jest generowane w tym formularzu:
RowX — Aby niepowtarzającym wiersze, gdzie X jest indeks wiersza od zera w ramach bieżącego obiektu nadrzędnego.
ColumnY — Dla niepowtarzającym kolumn, których indeks ix Y kolumna od zera w ramach bieżącego obiektu nadrzędnego.
Nagłówek niepowtarzającym jest renderowane jako element podrzędność wiersza lub kolumna, które nie będą powtarzane z grupą.
Jeśli niepowtarzający się element członkowski nie ma odpowiadających mu komórek elementu tablix, nie jest renderowany.Może się tak stać w przypadku komórki elementu tablix, która obejmuje więcej niż jedną kolumnę.
Wiersze i kolumny, które są powtarzane w grupie
Wiersze i kolumny, powtarzające się w obrębie grupy są renderowane zgodnie z Tablix. DataElementOutput reguły. Nazwa elementu jest pobierana z DataElementName Właściwość.
Każda unikatowa wartość w grupie jest renderowana jako element podrzędny grupy.Nazwa elementu jest pobierana z Group. DataElementName Właściwość.
Jeśli DataElementOutput wartość właściwość równa Wyjście, element powtarzające się nagłówek jest renderowane jako element podrzędność elementu szczegółów.
Formaty niestandardowe i przekształcenia XSL
Plik XML utworzony przez rozszerzenie renderowania w formacie XML można przekształcić praktycznie do każdego formatu, używając przekształceń XSL (XSLT).Za pomocą tej funkcji można tworzyć dane w formatach, które nie są jeszcze obsługiwane przez istniejące rozszerzenia renderowania.Przed podjęciem próby utworzenia własnego rozszerzenia renderowania należy rozważyć użycie rozszerzenia renderowania w formacie XML.
Zduplikowane nazwy
W przypadku nazw elementów powtarzające się dane w tym samym zakresie, mechanizm renderujący wyświetla komunikat o błędzie.
Przekształcenia XSLT
Moduł renderowania w formacie XML może stosować przekształcenie XSLT po stronie serwera do oryginalnych danych XML.Gdy jest stosowane przekształcenie XSLT, moduł renderowania generuje przekształconą zawartość, a nie oryginalne dane XML.Przekształcenie jest wykonywane na serwerze, a nie na kliencie.
XSLT do danych wyjściowych jest zdefiniowany w pliku definicja raportu z DataTransform właściwość raportu lub z przekształcenia XSLT DeviceInfo parametr. Ustawienie dowolnej z tych wartości spowoduje, że przekształcenie będzie wykonywane przy każdym użyciu modułu renderowania w formacie XML.W przypadku korzystania z subskrypcji, przekształcenie XSLT, musi być zdefiniowana w RDL DataTransform Właściwość.
Jeśli określony plik XSLT, obu DataTransform Definicja właściwość i informacji o urządzeniu zestaw ting przekształcenia XSLT określonego w DataTransform wystąpi jako pierwsze, a po nim przekształcenia XSLT zestaw przez urządzenie informacji zestaw tings.
Ustawienia informacji o urządzeniu
Można zmienić niektóre ustawienia domyślne to moduł renderowania, zmieniając ustawienia informacji o urządzeniu, między innymi następujące:
Przekształcenie (XSLT), które ma zostać zastosowane do danych XML.
Typ MIME dokumentu XML.
Określenie, czy do danych mają być stosowane ciągi formatu.
Określenie, czy dane wyjściowe XML mają być wcinane.
Określenie, czy ma być dołączana nazwa schematu XML.
Kodowanie dokumentu XML.
Rozszerzenie pliku dokumentu XML.
Aby uzyskać więcej informacji zobacz Ustawienia informacji urządzeń usług raportowania.