Zur Ressource
Werbung
Help.gv.at Behördensuche Help.gv.at Behördensuche und deren WebServices Version 1.1.0 Erweiterung für Help.gv.at Behördensuche Inhaltsverzeichnis 1. 2. 3. Änderungshistorie ......................................................................................................... 1 Einleitung ...................................................................................................................... 2 Behördensuche ............................................................................................................ 2 3.1. Auswahl des Behördentyps ................................................................................... 2 3.2. Regionalisierung für eine Gemeinde ..................................................................... 4 3.3. Anzeige der Behördendaten .................................................................................. 6 3.3.1. Behördentyp ................................................................................................... 6 3.3.2. Behördentypgruppe ........................................................................................ 8 4. Kontaktmöglichkeiten.................................................................................................... 9 Help.gv.at Behördensuche 1. Änderungshistorie Version Änderung 1.0.0 Initialversion 1.0.1 Adaptierung Namespaces Anpassung „SearchOrganisationstyp“ Anpassung Homepage einer Organisation Erweiterung um Organisationsgruppen 1.1.0 Version 1.1.0 1 02.10.2012 Help.gv.at Behördensuche 2. Einleitung Dieses Dokument beschreibt die Organisationssuche (https://www.help.gv.at/Portal.Node/hlpd/public/behoerden) sowie deren in HELP.gv.at Kommunikation per WebServices. Die eingesetzten WebServices basieren auf folgenden von E-Government-Konvention: XML-basiertes Protokoll für Suchanfragen via Webservices (XmlSearch): http://reference.egovernment.gv.at/Q-KA_XML-Suchanfragen_via_Webs.635.0.html XML-Soap-Faults und deren Behandlung: http://reference.e-government.gv.at/Q-KA_XML- Soapfaults__xml-sf_1.634.0.html XML-Struktur für Personendaten: http://reference.e-government.gv.at/Q-KA_XML- Strukturen_fuer_Perso.614.0.html Die Ziel-URL für alle hier beschriebenen WebService-Anfragen lautet https://www.help.gv.at/strukturdaten/service. Alle Beispielrequests und –responses sowie die schematische Darstellung der jeweils verwendeten XMLStruktur sind in einem separaten ZIP-Archiv beigelegt. 3. Behördensuche 3.1. Auswahl des Behördentyps Die Auswahl des Behördentyps stellt die Startseite der Applikation dar. Hier hat der Benutzer die Möglichkeit seinen gewünschten Behördentyp oder die Behördentypgruppe anzugeben. Abbildung 1: Auswahl des Behördentyps Version 1.1.0 2 02.10.2012 Help.gv.at Behördensuche Die Daten für die Befüllung dieser Combobox werden über ein WebService geladen. Die SearchCriteria der Anfrage unterliegt folgendem Schema: Abbildung 2: Schema für Behördentypsuche Für die Quelle ist die Kurzbezeichnung „HELP“ zu wählen, um alle Organisationstypen zu erhalten, die für HELP.gv.at relevant sind. Dieses Service liefert lediglich die verfügbaren Behördentypen. Behördentypgruppen (bspw. „Behörden meiner Region“) sind statisch hinzuzufügen. XML-Beispiele Typ Dateiname Request behoerdentypen_request.xml Response behoerdentypen_response.xml Version 1.1.0 3 02.10.2012 Help.gv.at Behördensuche 3.2. Regionalisierung für eine Gemeinde Nach Auswahl eines Behördentyps wird der Benutzer aufgefordert sich für eine Gemeinde zu regionalisieren. Er hat dazu die Möglichkeit eine Postleitzahl und/oder eine Gemeindebezeichnung einzugeben. Abbildung 3: Regionalisierung Das Root-Element der SearchCritieria (Datensatz) ist ein abstraktes Element, der durch den RaeumlicheEinheitTyp konkretisiert wird. In diesem Beispiel werden durch die Anfrage die Elemente „Gemeinde“ und „PLZ“ befüllt. Abbildung 4: Schema für Regionalisierung Version 1.1.0 4 02.10.2012 Help.gv.at Behördensuche In der XmlSearch-Konvention ist bei Angaben von mehreren Suchkriterien eine UND-Verknüpfung der Kritierien für die Einschränkung des Ergebnises vorgesehen. Mithilfe einer BRZ-spezifischen Erweiterung dieses Standards können auch ODER-Verknüpfungen realisiert werden (siehe Element „OrGroups“ in der Beispiel-Anfrage). Die Antwort enthält den Gemeindecode der entsprechenden Gemeinde. XML-Beispiele Typ Dateiname Request regionalisierung_request.xml Response regionalisierung_response.xml Version 1.1.0 5 02.10.2012 Help.gv.at Behördensuche 3.3. Anzeige der Behördendaten Für das Laden der benötigten Informationen kommt folgendes Schema zur Anwendung: Abbildung 5: Schema für Daten und Kontaktinformationen einer Behörde 3.3.1. Behördentyp Nachdem der Benutzer seine gewünschte Region gewählt hat können nun die zuständigen Behörden für diese Region ermittelt werden und deren Adresse sowie Kontaktinformationen werden zur Anzeige gebracht. Abbildung 6: Anzeige der Behördendaten Version 1.1.0 6 02.10.2012 Help.gv.at Behördensuche Neben Behörden, die nur für diese spezielle Region zuständig ist, existieren auch Behörden, die österreichweit tätig sind. Um alle zuständigen Behörden zu ermitteln sind somit zwei WebServiceAbfragen notwendig: Eine Abfrage mit dem Gemeindecode der gewünschten Gemeinde: 31213 Eine Abfrage auf österreichweit tätige Behörden: 00000 Im Falle der österreichweiten Abfrage kommt es zu einem SOAP-Fault mit Fehlercode 2040. Die Anfrage konnte erfolgreich verarbeitet werden, liefert jedoch keine Daten. XML-Beispiele Typ Dateiname Request behoerderegional_request.xml Response behoerderegional_response.xml Request behoerdeoesterreichweit_request.xml Response behoerdeoesterreichweit_response.xml Version 1.1.0 7 02.10.2012 Help.gv.at Behördensuche 3.3.2. Behördentypgruppe Nach erfolgter Regionalisierung wird eine Anfrage mit dem Kürzel der Behördengruppe abgesetzt. In diesem Fall werden lediglich regional zuständige Behörden herangezogen. Abbildung 7:Behörden einer Behördengruppe XML-Beispiele Typ Dateiname Request behoerdengruppe_request.xml Response behoerdengruppe_response.xml Version 1.1.0 8 02.10.2012 Help.gv.at Behördensuche 4. Kontaktmöglichkeiten Ansprechpartner Organisation Kontakt Organisatorisch Bundesrechenzentrum GmbH DI Gerhard Krizovsky [email protected] 01 71123-2945 Technisch Bundesrechenzentrum GmbH Ing. Christoph Vogler [email protected] 01 71123-2409 Version 1.1.0 9 02.10.2012
