Beim Ris-OGDService (Version 1.3.1) handelt es sich um ein Web-Service, welches maschinelle Anfragen an einzelne RIS-Dokumente unter der Url http://data.bka.gv.at/ris/OGDService.asmx ermöglicht. Es stehen drei Methoden zur Verfügung:
- version Gibt die aktuelle Versionsnummer zurück
- request Suche von Dokumenten
- getDocument Abrufen eines einzelnen Dokuments
Sowohl für die Abfrage (Suche von Dokumenten), als auch für die Rückgabe der Ergebnisse werden XML-Strukturen verwendet, die folgenden XML-Schema-Dateien entsprechen müssen:
- Abfrage (request) http://data.bka.gv.at/RIS/XSD/OGD_Request.xsd
- Ergebnis (request) http://data.bka.gv.at/RIS/XSD/OGD_ResponseList.xsd mit http://data.bka.gv.at/RIS/XSD/OGD_ResponseList_Type.xsd inkludiert
- Ergebnis (getDocument) http://data.bka.gv.at/RIS/XSD/OGD_DocumentResponse.xsd mit http://data.bka.gv.at/RIS/XSD/RISDok.xsd inkludiert darunter. mit http://data.bka.gv.at/RIS/XSD/RISJudikaturNutzdaten.xsd inkludiert
Die Erreichbarkeit des RIS-OGD-Service kann mit der Methode „version“ getestet werden. Nachfolgend ein Beispiel für den entsprechenden SOAP-Request:
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<version xmlns="http://data.bka.gv.at/"/>
</soap:Body>
</soap:Envelope>
Als Ergebnis erhalten Sie einen SOAP-Response mit folgendem Inhalt:
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<versionResponse xmlns="http://ogd.bka.gv.at/">
<versionResult>OGD_1.3.0</versionResult>
</versionResponse>
</soap:Body>
</soap:Envelope>
##Suche von Dokumenten Die Methode request erfordert zwei Parameter:
- application Derzeit immer „Br“ (Bundesrecht konsolidiert)
- query Beinhaltet die Suchabfrage als XML-Struktur, gemäß dem Schema http://data.bka.gv.at/RIS/XSD/OGD_Request.xsd
Eine Request XML-Struktur gliedert sich in drei Abschnitte:
Es stehen folgende Suchkriterien zur Verfügung:
- Suchworte Suche über den gesamten Inhalt des Dokuments. Typ: PhraseSearchExpression
- Titel Suche nach Titel oder Abkürzung der Rechtsvorschrift. Typ: PhraseSearchExpression
- Index Suche nach der Indexnummer gemäß dem „Systematischen Verzeichnis des Bundesrechts“. Typ: PhraseSearchExpression
- Abschnitt Suche nach der Nummer bzw. dem Buchstaben der Gliederungseinheit ("Artikel", "Paragraph", "Anlage") NummerVon (Typ: integer) - NummerBis (Typ: integer) BuchstabeVon (Typ: string) - BuchstabeBis (Typ: string) Typ (NormabschnittTyp: "Alle", "Artikel", "Paragraph", "Anlage")
- FassungVom Angabe jenes Datums, zu dem sich die Rechtsvorschrift in Kraft befinden soll. Wird kein Datum eingetragen, werden alle Dokumente zurückgegeben, unabhängig davon, ob sie in Kraft sind. Typ: date
- Kundmachungsorgan Suche nach dem Kundmachungsorgan (z.B. "BGBl. I Nr. ", "BGBl. II Nr. ", "BGBl. III Nr. ", "JGS Nr."). Typ: PhraseSearchExpression
- Kundmachungsorgannummer Suche nach der Nummer des Kundmachungsorgans (z.B. 25/2012). Typ: PhraseSearchExpression
- ImRisSeit Suche nach dem Zeitpunkt, zu dem das Dokument erstmals in das RIS aufgenommen oder geändert wurde. ChangeSetInterval: "Undefined", "EinerWoche", "ZweiWochen", "EinemMonat", "DreiMonaten", "SechsMonaten", "EinemJahr"
Als Suchoperatoren stehen folgende Möglichkeiten zur Verfügung:
- UND Um eine UND-Verknüpfung zu erzielen, muss die entsprechende „SearchExpression“ vom Typ „AndSearchExpression“ verwendet werden.
<SearchExpression xsi:type="AndSearchExpression">
<Expressions xsi:type="ArrayOfSearchExpression">
<SearchExpression xsi:type="PhraseSearchExpression">
<Value>Kind</Value>
</SearchExpression>
<SearchExpression xsi:type="PhraseSearchExpression">
<Value>Ehe</Value>
</SearchExpression>
</Expressions>
</SearchExpression>
- ODER Um eine ODER-Verknüpfung zu erzielen, muss die entsprechende „SearchExpression“ vom Typ „OrSearchExpression“ verwendet werden.
<SearchExpression xsi:type="OrSearchExpression">
<Expressions xsi:type="ArrayOfSearchExpression">
<SearchExpression xsi:type="PhraseSearchExpression">
<Value>Scheidung</Value>
</SearchExpression>
<SearchExpression xsi:type="PhraseSearchExpression">
<Value>Ehe</Value>
</SearchExpression>
</Expressions>
</SearchExpression>
- NICHT Um eine Suche abzusetzen, in deren Ergebnis ein Begriff nicht enthalten sein soll, muss die entsprechende „SearchExpression“ vom Typ „NotSearchExpression“ verwendet werden.
<Expressions xsi:type="ArrayOfSearchExpression">
<SearchExpression xsi:type="PhraseSearchExpression">
<Value>Scheidung</Value>
</SearchExpression>
<SearchExpression xsi:type="NotSearchExpression">
<Expression xsi:type="PhraseSearchExpression">
<Value>Ehe</Value>
</Expression>
</SearchExpression>
</Expressions>
- Maskierung mit Stern Es werden Begriffe gefunden, die statt „*“ ein oder mehrere Zeichen enthalten. Die Maskierung ist nur am Ende eines Suchbegriffes zulässig.
<SearchExpression xsi:type="PhraseSearchExpression">
<Value>Kind*</Value>
</SearchExpression>
Das Ergebnis der Abfrage wird in Seiten aufgeteilt zurückgegeben. Mittels des Elements „DokumenteProSeite“ können Sie die Anzahl der gefundenen Dokumente pro Seite festlegen. Im Element „Seitennummer“ geben Sie an, welche Seite retourniert werden soll.
- DokumenteProSeite Typ: string "Ten", "Twenty", "Fifty", "OneHundred"
- Seitennummer Typ: integer
Im Element „Sortierung" wird definiert, in welcher Sortierreihenfolge bzw. nach welchem Element sortiert werden soll.
- SortDirection Typ: string "Ascending", "Descending"
- SortedByColumn Typ: string "ArtikelParagraphAnlage", "Kurzinformation"
Nachfolgend ein Beispiel für einen Request, der die meisten der möglichen Suchoptionen beinhaltet.
<OGDSearchRequest xmlns="http://ris.bka.gv.at/Search/1.3/OGD" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Suchworte xsi:type="OrSearchExpression">
<Expressions xsi:type="ArrayOfSearchExpression">
<SearchExpression xsi:type="AndSearchExpression">
<Expressions xsi:type="ArrayOfSearchExpression">
<SearchExpression xsi:type="PhraseSearchExpression">
<Value>Kind</Value>
</SearchExpression>
<SearchExpression xsi:type="PhraseSearchExpression">
<Value>Ehe</Value>
</SearchExpression>
</Expressions>
</SearchExpression>
<SearchExpression xsi:type="PhraseSearchExpression">
<Value>Scheidung</Value>
</SearchExpression>
</Expressions>
</Suchworte>
<Titel xsi:type="PhraseSearchExpression">
<Value>Allgemeines bürgerliches Gesetzbuch</Value>
</Titel>
<Index xsi:type="PhraseSearchExpression">
<Value>20/01</Value>
</Index>
<Abschnitt>
<NummerVon>161</NummerVon>
<NummerBis>180</NummerBis>
<Typ>Paragraph</Typ>
</Abschnitt>
<FassungVom>2012-04-10</FassungVom>
<Kundmachungsorgan xsi:type="PhraseSearchExpression">
<Value>JGS Nr.</Value>
</Kundmachungsorgan>
<Kundmachungsorgannummer xsi:type="PhraseSearchExpression">
<Value>946/1811 </Value>
</Kundmachungsorgannummer>
<ImRisSeit>Undefined</ImRisSeit>
<DokumenteProSeite>Twenty</DokumenteProSeite>
<Seitennummer>1</Seitennummer>
<Sortierung>
<SortDirection>Ascending</SortDirection>
<SortedByColumn>Kurzinformation</SortedByColumn>
</Sortierung>
</OGDSearchRequest>
Hier finden Sie den SOAP-Request, anhand des obigen Beispiels. Das Request-XML wird HTML-enkodiert dem Parameter „query“ übergeben.
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<request xmlns="http://ogd.bka.gv.at/">
<application>Br</application>
<query>
<OGDSearchRequest xmlns="http://ris.bka.gv.at/Search/1.3/OGD"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> ...
.
.
.
... </OGDSearchRequest>
</query>
</request>
</soap:Body>
</soap:Envelope>
Falls in einem Suchbegriff das Zeichen „&“ verwendet wird, ist folgende HTML-Enkodierung erforderlich.
<SearchExpression xsi:type="PhraseSearchExpression">
<Value>'Gmbh &amp; Co.'</Value>
</SearchExpression>
Als Ergebnis erhalten Sie einen entsprechenden SOAP-Response mit folgendem, ebenfalls HTML-enkodiertem Inhalt („requestResult“):
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<requestResponse xmlns="http://ogd.bka.gv.at/">
<requestResult>
<?xml version="1.0" encoding="utf-8"?>
<OGDSearchResult status="ok" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SearchDocumentsResult>
<Hits pageNumber="1" pageSize="20"
xmlns="http://ris.bka.gv.at/Search/1.3/OGD">4</Hits>
<DocumentReferences xmlns="http://ris.bka.gv.at/Search/1.3/OGD">
<OGDDocumentReference>
<Applikation>Bundesrecht</Applikation>
<Dokumentnummer>NOR40052761</Dokumentnummer>
<ArtikelParagraphAnlage>§ 161</ArtikelParagraphAnlage>
<Kurzinformation>Allgemeines bürgerliches Gesetzbuch</Kurzinformation>
<DokumentUrl><![CDATA[http://www.ris.bka.gv.at/Dokument.wxe?Abfrage=Bundesnormen&a
mp;Dokumentnummer=NOR40052761]]></DokumentUrl>
</OGDDocumentReference>
<OGDDocumentReference>
<Applikation>Bundesrecht</Applikation>
<Dokumentnummer>NOR40013328</Dokumentnummer>
<ArtikelParagraphAnlage>§ 175</ArtikelParagraphAnlage>
<Kurzinformation>Allgemeines bürgerliches Gesetzbuch</Kurzinformation>
<DokumentUrl><![CDATA[http://www.ris.bka.gv.at/Dokument.wxe?Abfrage=Bundesnormen&a
mp;Dokumentnummer=NOR40013328]]></DokumentUrl>
</OGDDocumentReference>
<OGDDocumentReference>
<Applikation>Bundesrecht</Applikation>
<Dokumentnummer>NOR40013331</Dokumentnummer>
<ArtikelParagraphAnlage>§ 177</ArtikelParagraphAnlage>
<Kurzinformation>Allgemeines bürgerliches Gesetzbuch</Kurzinformation>
<DokumentUrl><![CDATA[http://www.ris.bka.gv.at/Dokument.wxe?Abfrage=Bundesnormen&a
mp;Dokumentnummer=NOR40013331]]></DokumentUrl>
</OGDDocumentReference>
<OGDDocumentReference>
<Applikation>Bundesrecht</Applikation>
<Dokumentnummer>NOR40013332</Dokumentnummer>
<ArtikelParagraphAnlage>§ 177a</ArtikelParagraphAnlage>
<Kurzinformation>Allgemeines bürgerliches Gesetzbuch</Kurzinformation>
<DokumentUrl><![CDATA[http://www.ris.bka.gv.at/Dokument.wxe?Abfrage=Bundesnormen&a
mp;Dokumentnummer=NOR40013332]]></DokumentUrl>
</OGDDocumentReference>
</DocumentReferences>
</SearchDocumentsResult>
</OGDSearchResult>
</requestResult>
</requestResponse>
</soap:Body>
</soap:Envelope>
Im Element „Hits“ wird angezeigt, dass im konkreten Fall vier Treffer zurückgegeben werden. Aus den Attributen „pageNumber“ und „pageSize“ ist ersichtlich, dass die Seite 1 retourniert wurde bzw. max. 20 Dokumente pro Seite ausgegeben werden. Die pro Treffer angezeigten Metadaten werden jeweils im Element „OGDDocumentReference“ dargestellt. Folgende Informationen stehen pro gefundenem Dokument zur Verfügung:
- Applikation Derzeit immer „Bundesrecht“
- Dokumentnummer Eindeutige Bezeichnung des Dokuments, mit welcher die Methode „getDocument“ aufgerufen werden kann, um den gesamten Dokumentinhalt abzurufen
- ArtikelParagraphAnlage Nummer und allenfalls Buchstabe der Gliederungseinheit
- Kurzinformation Kurztitel der Rechtsnorm
- DokumentUrl Link zum Dokument im RIS (http://www.ris.bka.gv.at/...)
Die Methode „getDocument“ dient dazu, um den gesamten Dokumentinhalt abzurufen. Folgende Parameter sind zu übergeben:
- Application Derzeit immer „Br“ (Bundesrecht konsolodiert)
- docId Beinhaltet die Dokumentnummer
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<getDocument xmlns="http://ogd.bka.gv.at/">
<application>Br</application>
<docId>NOR40091435</docId>
</getDocument>
</soap:Body>
</soap:Envelope>
Das Ergebnis des Aufrufs „getDocument“ ist ein SOAP-Response mit enkodiertem Inhalt („DocumentResult“). Dieser gliedert sich in zwei Teile, die Metadaten (beschreibende Informationen zum Dokument) und die Nutzdaten (formatierter Text der Rechtsnorm). Sofern der Aufruf erfolgreich abgearbeitet wurde, beinhaltet das Attribut „status“ im Element „DocumentResult“ den Wert „ok“. Ein Fehlerfall wird weiter unten dargestellt.
- Applikation Derzeit immer „Bundesrecht“
- Dokumentnummer Eindeutige Bezeichnung des Dokuments
- Kurztitel Kurztitel der Rechtsnorm
- Kundmachungsorgan Hinweis auf das Kundmachungsorgan z.B. BGBl. Nr.
- Typ Typ der Rechtsvorschrift z.B. BG (Bundesgesetz), V (Verordnung), K (Kundmachung)
- ArtikelParagraphAnlage Gliederungsart der Rechtsvorschrift z.B. § 5, Art. 10, Anl. 2
- Inkrafttretedatum Datum des Inkrafttretens der Rechtsvorschrift
- Ausserkrafttretedatum Datum des Ausserkrafttretens der Rechtsvorschrift
- Abkuerzung Abkürzung der Rechtsvorschrift z.B. StVO, ABGB
- Unterzeichnungsdatum Unterzeichnungsdatum eines Staatsvertrages
- Indizes Index des österreichischen Bundesrechts z.B. 16/02 Rundfunk
- Uebergangsrecht Hinweis, dass es sich bei dieser Rechtsvorschrift um ein Übergangsrecht handelt
- BeachteZurGanzenRechtsvorschrift Beachte gilt für alle Dokumente (= Paragraph/Artikel/Anlage) einer Rechtsnorm
- Beachte Beachte für die konkrete Rechtsvorschrift
- Aenderung Angabe der BGBl-Nummern, welche die konkrete Rechtsnorm novelliert haben
- Langtitel Langtitel der Rechtsvorschrift
- Sprachen Angabe der authentischen Sprachen, in denen ein Staatsvertrag abgeschlossen wurde
- Staaten Angabe der Staaten, die dem Staatsvertrag beigetreten sind
- AnmerkungZurGanzenRechtsvorschrift Anmerkung gilt für alle Dokumente (=Paragraph/Artikel/Anlage) einer Rechtsnorm
- Anmerkung Anmerkung für die konkrete Rechtsvorschrift
- Schlagworte Schlagworte für die konkrete Rechtsvorschrift
- Veroeffentlichungsdatum Datum, an dem das Dokument erstmalig im RIS veröffentlicht wurde
- Aenderungsdatum Datum, an dem das Dokument zuletzt im RIS aktualisiert wurde
- Gesetzesnummer Angabe zur nichtamtlichen Gesetzesnummer einer Rechtsnorm, wobei alle Dokumente, die Teil dieser Rechtsnorm sind, die gleiche Gesetzesnummer haben
- AlteDokumentnummer Hinweis auf eine frühere interne Dokumentnummer
Das Element „Dokumentinhalt“ enthält die formatierten Nutzdaten. In den meisten Fällen wird der gesamte Inhalt der Rechtsvorschrift in einem Dokument (Hauptdokument) dargestellt. Es kann jedoch auch vorkommen, dass es zu einem Hauptdokument eine oder mehrere Anlagen gibt. In diesem Fall kommt das Element „ContentReference“ mehrfach vor.
- ContentType Kann die Werte „MainDocument“ oder „Attachment“ beinhalten.
- Name Im Element „Name“ ist entweder der Wert „Hauptdokument“ oder die individuelle Bezeichnung einer Anlage (z.B. „Anlage 1“, Anlage A“) enthalten.
- DataType Im Element „DataType“ befindet sich die Angabe zum Dateiformat, wobei das Hauptdokument immer den Wert „Xml“ aufweist. Bei Anlagen sind folgende Werte möglich (Xml, Pdf, Gif, Jpg, Tiff, Png).
Die formatierten Nutzdaten sind im Element „nutzdaten“ zu finden und entsprechen dem Schema „RISJudikaturNutzdaten.xsd“.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<getDocumentResponse xmlns="http://ogd.bka.gv.at/">
<getDocumentResult>
<DocumentResult status="ok">
<OGDDocumentMetadata>
<Applikation>Bundesrecht</Applikation>
<Dokumentnummer>NOR40091435</Dokumentnummer>
<Kurztitel>Elektrizitätsstatistikverordnung 2007</Kurztitel>
<Kundmachungsorgan>BGBl. II Nr. 284/2007</Kundmachungsorgan>
<Typ>V</Typ>
<ArtikelParagraphAnlage>§ 5</ArtikelParagraphAnlage>
<Inkrafttretedatum>2007-11-01</Inkrafttretedatum>
<Ausserkrafttretedatum xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
/>
<Unterzeichnungsdatum xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
/>
<Indizes>
<item>58/02 Energierecht</item>
</Indizes>
<Schlagworte>Wärmeabgabe</Schlagworte>
<Veroeffentlichungsdatum xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-
instance" />
<Aenderungsdatum xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" />
<Gesetzesnummer>20005498</Gesetzesnummer>
<Dokumentinhalt>
<ContentReference>
<ContentType>MainDocument</ContentType>
Stand: 30.10.2012
Seite 9RIS-OGDServices Handbuch
<Name>Hauptdokument</Name>
<DataType>Xml</DataType>
<risdok>
<metadaten />
<nutzdaten>
<abschnitt nr="1" typ="ns" paperf="h" endnhier="true"><kzinhalt typ="p"><absatz typ="kz"
halign="j"><tab align="z" position="212,65" leader="o" /><tab align="r" position="425,25" leader="o"
/>Bundesrecht</absatz></kzinhalt><kzinhalt typ="f"><absatz typ="kz"
halign="j"><tab align="z" position="212,65" leader="o" /><tab align="r" position="425,25" leader="o"
/>Bundesrecht</absatz></kzinhalt><fzinhalt typ="p"><absatz typ="fz"
halign="j">www.ris.bka.gv.at<tab align="z" position="212,65" leader="o" /><tab align="r"
position="425,25" leader="o" />Seite <feld code="+PAGE++%5C%2A+MERGEFORMAT+">1</feld>
von <feld
code="+NUMPAGES++%5C%2A+MERGEFORMAT+">1</feld></absatz></fzinhalt><fzinhalt
typ="f"><absatz typ="fz" halign="j">www.ris.bka.gv.at<tab align="z" position="212,65" leader="o"
/><tab align="r" position="425,25" leader="o" />Seite <feld
code="+PAGE++%5C%2A+MERGEFORMAT+">1</feld> von <feld
code="+NUMPAGES++%5C%2A+MERGEFORMAT+">1</feld></absatz></fzinhalt><uebersch
rift typ="titel" halign="j">Kurztitel</ueberschrift><absatz typ="erltext" ct="kurztitel"
halign="j">Elektrizitätsstatistikverordnung 2007</absatz><ueberschrift typ="titel"
halign="j">Kundmachungsorgan</ueberschrift><absatz typ="erltext" ct="kundmachungsorgan"
halign="j">BGBl. II Nr. 284/2007</absatz><ueberschrift typ="titel"
halign="j">§/Artikel/Anlage</ueberschrift><absatz typ="erltext" ct="artikel_anlage" halign="j">§
5</absatz><ueberschrift typ="titel" halign="j">Inkrafttretensdatum</ueberschrift><absatz
typ="erltext" halign="j">01.11.2007</absatz><ueberschrift typ="titel"
halign="j">Text</ueberschrift><absatz typ="erltext" ct="text"
halign="c"><b>Monatswerte</b></absatz><abstand ct="text" halign="l" /><absatz
typ="abs" ct="text" halign="j">§ 5. (1) Die Netzbetreiber mit einer unmittelbaren Abgabe an Endverbraucher
von zumindest 40 GWh im vergangenen Kalenderjahr haben für die Erhebungsperiode jeweils eines
Kalendermonats zu erheben:</absatz><liste><ziffernliste ebene="1"><listelem
ct="text"><symbol stellen="2">1.</symbol>die gesamte eingespeiste Erzeugung elektrischer
Energie aus Kraftwerken (physikalisch);</listelem><listelem ct="text"><symbol
stellen="2">2.</symbol>die physikalischen Importe elektrischer Energie über die einzelnen Leitungen,
getrennt nach Leitungen;</listelem><listelem ct="text"><symbol
stellen="2">3.</symbol>die physikalischen Exporte elektrischer Energie über die einzelnen Leitungen,
getrennt nach Leitungen;</listelem><listelem ct="text"><symbol
stellen="2">4.</symbol>die unmittelbare Abgabe an Endverbraucher unter Angabe der Netzverluste und
der Abgabe an Kraftwerke für Pumpspeicherung;</listelem><listelem ct="text"><symbol
stellen="2">5.</symbol>die gesamte Abgabe an Netzgebiete in der eigenen Regelzone außerhalb des
österreichischen Bundesgebiets;</listelem><listelem ct="text"><symbol
stellen="2">6.</symbol>die gesamte Abgabe an lastganggemessene
Endverbraucher.</listelem></ziffernliste></liste><absatz typ="abs" ct="text" halign="j">(2)
Die Erzeuger haben für die Erhebungsperiode jeweils eines Kalendermonats für Kraftwerke mit einer
Engpassleistung von mehr als 10 MW und die Eigenerzeuger für die Erhebungsperiode jeweils eines
Kalendermonats für Kraftwerke mit einer Engpassleistung von mehr als 5 MW zu
erheben:</absatz><liste><ziffernliste ebene="1"><listelem ct="text"><symbol
stellen="2">1.</symbol>bei Wasserkraftwerken die gesamte Brutto-Stromerzeugung getrennt nach
Kraftwerkstypen;</listelem><listelem ct="text"><symbol stellen="2">2.</symbol>bei
Laufkraftwerken darüber hinaus das Regelarbeitsvermögen und das Arbeitsvermögen;</listelem><listelem
ct="text"><symbol stellen="2">3.</symbol>bei Speicherkraftwerken darüber hinaus den
Energieinhalt, bezogen auf den Monatsletzten, getrennt nach Speichern, unter Angabe des Verbrauches für
Pumpspeicherung;</listelem><listelem ct="text"><symbol stellen="2">4.</symbol>bei
Wärmekraftwerken die Brutto-Stromerzeugung getrennt nach Kraftwerksblock und Primärenergieträgern sowie
bei Anlagen mit Kraft-Wärme-Kopplung darüber hinaus die Wärmeerzeugung und -abgabe getrennt nach
Kraftwerksblock und Primärenergieträgern; weiters den Eigenverbrauch für Erzeugung einschließlich
Transformatorverluste sowie die Art und Menge der für die Erzeugung elektrischer Energie und Wärme
bestimmten Primärenergieträger, unter Angabe von Verbrauch und Lagerbestand zum
Monatsletzten;</listelem><listelem ct="text"><symbol stellen="2">5.</symbol>bei
Windkraftwerken (Windparks), Photovoltaik-Anlagen und geothermischen Anlagen die Stromerzeugung
(Einspeisung) getrennt nach Kraftwerkstyp;</listelem><listelem ct="text"><symbol
stellen="2">6.</symbol>bei Eigenerzeugern darüber hinaus den Bezug aus dem öffentlichen Netz, den
Bezug aus Fremdkraftwerken (16? Hz), die Einspeisung in das öffentliche Netz und den Verbrauch für
Pumpspeicherung.</listelem></ziffernliste><schluss typ="Abs" ct="text">Für anerkannte
Ökostromanlagen (§ 5 Abs. 1 Z 27 in Verbindung mit § 7 des Ökostromgesetzes) sind über die Daten gemäß Z 1, 4
und 5 hinaus die gemeldeten Kraftwerke zu benennen und die zugehörigen Zählpunkte
anzugeben.</schluss></liste><absatz typ="abs" ct="text" halign="j">(3) Die Eigenerzeuger haben
für die Erhebungsperiode jeweils eines Kalendermonats zu erheben:</absatz><liste><ziffernliste
ebene="1"><listelem ct="text"><symbol stellen="2">1.</symbol>die physikalischen Importe
nach Staaten;</listelem><listelem ct="text"><symbol stellen="2">2.</symbol>die
physikalischen Exporte nach Staaten.</listelem></ziffernliste></liste></abschnitt>
</nutzdaten>
<layoutdaten paperf="7" paperh="841.9" paperw="595.3" margl="70.9" margr="70.9" margt="70.9"
margb="56.7" headerd="35.45" footerd="35.45" gutter="0" gutterpos="0" deftab="35.4" />
</risdok>
</ContentReference>
</Dokumentinhalt>
</OGDDocumentMetadata>
</DocumentResult>
</getDocumentResult>
</getDocumentResponse>
</soap:Body>
</soap:Envelope>
Beinhaltet eine Rechtsvorschrift eine Grafik z.B. ein Verkehrszeichen (§ 50 StVO), so wird diese Grafik mittels des Elements „binary“ als base64 kodierter String eingebettet.
<binary nr="1" shapetype="is" height="112" width="132" alt="" brightness="0.5" contrast="0.5"
oleclass="unknown" datatype="gif">
<base64>
R0lGODlhhABwAHcAMSH+GlNvZnR3YXJlOiBNaWNyb3NvZnQgT2ZmaWNlACH5BAEAAAAALAAAAACEA
HAAh////wAAAAAAMwAAZgAAmQAAzAAA/wAzAAAzMwAzZgAzmQ
.
.
I7pmFoYmfEFmZA5fglUhByGQliBLTM4gxDIF6J5OJ8pfAOjT+NTPhsFIQq0HhToV34FgSqRmvFDgzFoI+I
3gi5REN7UgFbWJEL1P/wxnML5JAhknMPnjZZSOaqhKJtyEL6pFQEBADs=
</base64>
</binary>
Bei einer ungültigen oder fehlerhaften Anfrage bzw. bei Systemstörungen wird ebenfalls ein „ResponseXml“ zurückgegeben. Das Attribut „status“ im Element „DocumentResult“ enthält dann den Wert „error“. Anstatt des Elements „SearchDocumentsResults“ wird das Element „Error“ mit folgenden Informationen ausgegeben:
- errorType Klassifiziert den Fehler: 1 = incorrect request, 2 = database unavailable, 3 = other error
- Applikation Derzeit immer „Bundesrecht“
- Message Beschreibt den Fehler
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<requestResponse xmlns="http://ogd.bka.gv.at/">
<requestResult>
<?xml version="1.0" encoding="utf-8"?>
<OGDSearchResult status="error" xmlns:tns="http://ris.bka.gv.at/Search/1.3/OGD"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Error errorType="1">
<Applikation>Bundesrecht</Applikation>
<Message>&lt;![CDATA[
Bka.Ris.OGDConnector.ServiceHandler.OGDServiceHandler: Die Applikation LBG ist unzulässig
]]&gt;</Message>
</Error>
</OGDSearchResult>
</requestResult>
</requestResponse>
</soap:Body>
</soap:Envelope>
Kann ein Dokument nicht gefunden werden oder ist die Dokumentnummer ungültig, wird eine Fehlermeldung, analog zum obigen Beispiel, im Element „DocumentResult“ ausgegeben.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<getDocumentResponse xmlns="http://ogd.bka.gv.at/">
<getDocumentResult>
<?xml version="1.0" encoding="utf-8"?>
<DocumentResult status="error" xmlns:tns="http://ris.bka.gv.at/Search/1.3/OGD"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Error errorType="1">
<Applikation>Bundesrecht</Applikation>
<Message>
&lt;![CDATA[
Bka.Ris.OGDConnector.ServiceHandler.OGDServiceHandlerBr: Die Dokunentnummer NOR90091435
wurde nicht gefunden
]]&gt;
</Message>
</Error>
</DocumentResult>
</getDocumentResult>
</getDocumentResponse>
</soap:Body>
</soap:Envelope>
Für Anfragen betreffend das RIS-OGDService wenden Sie sich bitte an: ris.it@bka.gv.at