Eidgenössisches Departement des Innern EDI Bundesamt für Statistik BFS Statistische Infrastruktur Web Services des Eidgenössischen Gebäude- und Wohnungsregister Zertifizierungsprozess Anhang zum technischen Dossier Web Services Dieses Dokument beschreibt den Prozess der Zertifizierung von Software, welche die Web Services II.I des GWR nutzen. Das Dokument richtet sich an Softwarehersteller, die ihre Applikationen zertifizieren lassen möchten. Version 2.4 vom 20. Februar 2014
Seite 2/10 Änderungskontrolle/-Geschichte Version Datum Name oder Rolle Bemerkungen 0.1 25.04.2008 BFS GWR Erster Entwurf 1.0 30.04.2008 BFS GWR Erste offizielle Version 2.0 25.02.2010 BFS GWR Erste offizielle Version für die Web Services II 2.1 17.03.2010 BFS GWR Anfügen von neuen Testfällen für die Methoden get 2.2 21.09.2012 BFS GWR Erste offizielle Version für die Web Services II.I 2.3 03.02.2014 BFS GWR Methoden obligatorisch zu implementieren (Anhang 1) 2.4 04.03.2014 BFS GWR Anpassung der bestehenden Methoden, die als obligatorisch definiert sind. Hinzufügung der Testfälle für die addbuilding Methode, die fehlten. Referenzdokumente Verordnung vom 31. Mai 2000 über das eidg. Gebäude- und Wohnungsregister (SR 431.841) GWR: Merkmalskatalog, Version 3.4; Neuchâtel 2007 GWR: Merkblätter zur Registerführung; Sammlung aller Ausgaben, Stand 20.12.2007 Technisches Dossier zur Qualitätssicherung im eidg. GWR; in Vorbereitung Technisches Dossier zur Spezifikation des Datenaustauschs; Version 2.0 vom 20.12.2007 Technisches Dossier zum Datenaustausch via WebServices; Version 1.3 vom 20.12.2007 Technisches Dossier zur koordinierten Datenerhebung BAU/GWR bei kommunalen Bauverwaltungen; in Vorbereitung Technisches Dossier zur koordinierten Datenerhebung BAU/GWR bei anerkannten GWR-Lösungen; in Vorbereitung Technisches Dossier zum Online-Datenexport via Internet; in Vorbereitung Alle Referenzdokumente sind verfügbar unter www.housing-stat.ch. Weitere Informationen zum eidg. GWR sind im Internet verfügbar unter www.housing-stat.ch. Unter dieser Adresse können auch alle Referenzdokumente zum eidg. GWR herunterladen oder bestellt werden. Für weitere Fragen und Auskünfte steht Ihnen das Bundesamt für Statistik zur Verfügung: Sektion Gebäude und Wohnungen Tel. 0800 866 600 / e-mail: housing-stat@bfs.admin.ch
Seite 3/10 Vorgehensweise Ein Softwarehersteller möchte mit seiner Software die Web Services II.I des GWR benutzen. Wie geht er vor? Achtung, wenn der Softwarehersteller in Zukunft andere Web Services II.I benutzen möchte als diejenigen, die getestet wurden, muss er den Zertifizierungsprozess erneut durchführen. Um die Web Services II.I des eidg. GWR zu verwenden, müssen sich die Endbenutzer auf der Internet-Seite www.housing-stat.ch des BFS unter der Rubrik "Registrieren" (Zugriff über Web Services) einschreiben.
Seite 4/10 Anhang 1 Web Services des eidgenösisches Gebäude- und Wohnungsregisters Testprotokoll, Web Services II.I Zur Software, Version (schreibende und lesende). Herausgegeben von der Firma: Allgemeine Informationen zum Testprotokoll Ort Datum Liste der Teilnehmer Endresultate Erfolgreich abgeschlossen Misslungen, nächste Zertifizierung am An folgende Adresse zurücksenden: Bundesamt für Statistik Sektion GEWO Web Services Espace de l Europe 10 2010 Neuchâtel
Seite 5/10 Methoden Übertragen sie bitte den Erfolg (OK) oder den Misserfolg (NOK) des Testfalls in die betreffenden Kolonnen. Sollte eine der Methoden von der Software nicht benötigt werden, dann signalisieren sie dies bitte anhand eines Kreuzes in der Kolonne «nicht benutzt». Methode Testfall OK NOK Nicht Benutzt getconstructionsurveydept 2.1.1 Nachschlagen der Daten einer existierenden Erhebungsstelle. modifyconstructionsurveydept 2.2.1 Ändern der Daten einer existierenden Erhebungsstelle. 2.2.2 Ändern der Daten einer inexistenten Erhebungsstelle. setmaintenancecosts 2.3.1 Aktualisieren der Unterhaltskosten einer existierenden Erhebungsstelle. getplausibilityerrorlist ConstructionSurveyDept 2.4.1 Erhalten der Fehler einer existierenden Erhebungsstelle, die einen oder mehrere Fehler aufweist. getconstructionprojectbyid 3.1.1 Suchen eines Bauprojektes im GWR mittels existierendem EPROID im GWR. getconstructionproject 3.2.1 Erfolgreiches Durchführen der erweiterten Suche nach Bauprojekten. addconstructionproject 3.3.1 Hinzufügen eines Bauprojektes mit 2 Gebäuden. 3.3.2 Hinzufügen eines Renovationsprojektes mit einem Gebäude. 3.3.3 Hinzufügen eines Abbruchprojektes mit 2 Gebäuden modifyconstructionproject 3.4.1.1 Beenden eines Neubauprojektes mit 2 Gebäuden. 3.4.1.2 Beenden eines Neubauprojektes mit 2 Gebäuden und gültigen Bau-monat 3.4.1.3 Ein fertiggestelltes Gebäude hinzufügen 3.4.2 Beenden eines Renovationsprojektes mit einem Gebäude
Seite 6/10 3.4.3 Ändern eines baubegonnenen Abbruchprojektes 3.4.4 Ändern eines baubegonnen Bauprojektes in dem ein neues Gebäude angefügt wird checkconstructionproject 3.5.1 Testen eines existierenden Bauprojektes. getplausibilityerrorlist ConstructionProject 3.6.1 Erhalten der Fehler eines Bauprojektes, das einen oder mehrere Fehler aufweist. unbindbuildingfrom ConstructionProject 3.7.1 Verknüpfung zwischen einem existerenden Gebäude und einem baubegonnenen Bauprojektes aufheben. addbuildingentrance 4.1.1 Hinzufügen eines neuen Eingangs zu einem existierenden Gebäude. modifybuildingentrance 4.2.1 Ändern eines existierenden Gebäudeeingangs. deletebuildingentrance 4.3.1 Löschen eines existierenden Gebäudeeingangs. demolishbuilding 4.4.1 Abbrechen eines existierenden Gebäudes. deletebuilding 4.5.1 Löschen eines existierenden Gebäudes. checkbuilding 4.6.1 Testen eines existierenden Gebäudes. getplausibilityerrorlistbuilding 4.7.1 Erhalten der Fehler eines Gebäudes, das einen oder mehrere Fehler aufweist. demolishdwelling 4.8.1 Aufheben einer existierenden Wohnung. deletedwelling 4.9.1 Löschen einer existierenden Wohnung. getbuildingbyid 4.10.1 Suche eines Gebäudes, das einen existierenden EGID im GWR hat. 4.10.2 Suche eines Gebäudes, das keinen existierenden EGID im GWR hat. getbuilding 4.11.1 Erfolgreiches Durchführen der erweiterten Suche nach Gebäuden.
Seite 7/10 4.11.2 Durchführen der erweiterten Suche nach Gebäuden mit Verweis auf ein Leerresultat. getdwellingbyewid 4.12.1 Suche einer Wohnung, die eine Kombination EGID/EWID besitzt und im GWR existiert. 4.12.2 Suche einer Wohnung, die eine Kombination EGID/EWID besitzt und nicht im GWR existiert. getdwelling 4.13.1 Erweiterte Suche nach einer Wohnung mit Erfolg. 4.13.2 Erweiterte Suche nach einer Wohnung mit Verweis auf ein Leerresultat. getdeletedbuilding 4.14.1 Ein gelöschtes Gebäude suchen. 4.14.2 Ein gelöschtes Gebäude suchen, obwohl es aktiv ist. 4.14.3 Ein gelöschtes Gebäude suchen, das nicht in der Gemeinde liegt. modifybuilding 4.15.1 Baumonat eines fertiggestellten Gebäude nachführen. 4.15.2 Falscher Baumonat eines fertiggestellten Gebäude nachführen. addbuilding 4.16.1 Ein Gebäude hinzufügen, mit einem Eingang und einer Wohnung 4.16.2 Ein Gebäude hinzufügen, mit zewi Eingänge und 8 Wohnungen 4.16.3 Ein Gebäude hinzufügen, ohne Eingang 4.16.4 Ein Gebäude hinzufügen, mit unvollständigem Eingang (ohne Gebäudenummer) 4.16.5 Ein sich im Bau befindendes Gebäude hinzufügen 4.16.6 Ein Gebäude hinzufügen mit einer Wohnung ohne Stockwerke 4.16.7 Ein Gebäude hinzufügen, das schon existiert
Seite 8/10 addstreetname 5.1.1 Hinzufügen eines neuen Strassennamens. addstreetlocalisation 5.2.1 Hinzufügen einer neuen Lokalität an eine existierende Strasse. modifystreetlocalisation 5.3.1 Ändern der Lokalität einer existierenden Strasse. getstreet 5.4.1 Suche nach einer existierenden Strasse. 5.4.2 Suche nach einer nicht existierenden Strasse. confirmimprobability 6.1.1 Bestätigen einer existierenden Fehlermeldung des Typs "que". getplausibiltyrule 6.2.1 Suche nach einer existierenden Plausibilitätsregel.. 6.2.2 Suche nach einer nicht existierenden Plausibilitätsregel. getprogressstatusquarterlyclosures 1.2.1 Kontrolle des Fortschritts des laufenden vierteljährlichen Abschlusses einer existierenden Erhebungsstelle. 1.2.2 Kontrolle des Fortschritts des beendeten vierteljährlichen Abschlusses einer existierenden Erhebungsstelle. closequarterlysurvey 1.1.1 Abschluss einer zum Abschluss bereiten existierenden Erhebungsstelle. 1.1.2 Abschluss einer bereits abgeschlossenen existierenden Erhebungsstelle. changepassword 6.3.1 Ändern des Passworts eines Users. Die Protokolle der ausgeführten Testfälle sind unbedingt diesem Dokument beizufügen! Durch seine Unterschrift, bestätigt der Softwarehersteller, das Ergebnis des oben Testprotokolls, zur Kenntnis genommen zu haben und im Falle eine Autozertifizierung der lesenden Web Services II alle erfordelichen Testfälle erfolgreich durchgeführt zu haben. Datum : Unterschrift: Softwarehersteller...... Anhang: alle Protokolle der ausgeführten Tests
Seite 9/10 Anhang 2 Eidg. Gebäude-und Wohnungsregister Konformitätserklärung Für Software, Version zur Verwendung der lesenden und schreibenden Web Services II.I Herausgegeben von der Firma: Durch seine Unterschrift bestätigt der Softwarehersteller, die folgenden Punkte zur Kenntnis genommen zu haben: 1. Der durch das BFS gelieferte Schlüssel ist vertraulich und darf unter keinen Umständen den Usern der Applikation oder Drittpersonen zugänglich sein. 2. Das BFS garantiert die bestmögliche Verfügbarkeit der Web Services II.I des GWR während den Betriebszeiten (siehe www.housing-stat.ch). Das BFS kann jedoch nicht für die Folgen einer Unterbrechung der Web Services II.I des eidg. GWR verantwortlich gemacht werden. 3. Das BFS lehnt die Verantwortung betreffend direkte oder indirekte Schäden sowie Konsequenzen wie Schaden durch Gewinnausfall im Zusammenhang mit dem Gebrauch der Web Services II.I des eidg. GWR ab. 4. Das BFS behält sich das Recht vor, jederzeit die vorliegende Zertifizierung zurückzuziehen, wenn Missbrauch oder Probleme während der Benutzung der Web Services II.I durch die obengenannte Software auftreten sollten. (siehe Kapitel 1.3.2 des technischen Dossiers der Web Services). Durch seine Unterschrift bestätigt der Softwarehersteller, die nötigen Massnahmen betreffend der folgenden Punkte getroffen zu haben: 1. Die Passwörter der User erlauben den Zugriff auf das eidg. GWR und dürfen nicht oder nur in verschlüsselter Form in der Applikation gespeichert werden. 2. Die Applikation garantiert, dass nur Personen im Besitz eines Usernamens und einem durch das BFS gelieferten Passworts Zugriff aufs eidg. GWR - via Web Services II.I - haben. Datum: Unterschrift: Softwarehersteller...... Ein unterschriebenes Exemplar zurückschicken an: Bundesamt für Statistik BFS, Sektion GEWO Espace de l Europe 10, 2010 Neuchâtel
Seite 10/10 Schlüsselnummer zur Nutzung der Web Services II.I: Das BFS bestätigt, dass die im Titel erwähnte Applikation den Zertifizierungsprozess zur Nutzung der Web Services II.I des GWR mit Erfolg bestanden hat. Datum: Unterschrift: Neuchâtel,...... Fritz Gebhard Sektionschef