Zertifizierungsprozess

Transkript

1 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

2 Seite 2/10 Änderungskontrolle/-Geschichte Version Datum Name oder Rolle Bemerkungen BFS GWR Erster Entwurf BFS GWR Erste offizielle Version BFS GWR Erste offizielle Version für die Web Services II BFS GWR Anfügen von neuen Testfällen für die Methoden get BFS GWR Erste offizielle Version für die Web Services II.I BFS GWR Methoden obligatorisch zu implementieren (Anhang 1) 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 ) GWR: Merkmalskatalog, Version 3.4; Neuchâtel 2007 GWR: Merkblätter zur Registerführung; Sammlung aller Ausgaben, Stand Technisches Dossier zur Qualitätssicherung im eidg. GWR; in Vorbereitung Technisches Dossier zur Spezifikation des Datenaustauschs; Version 2.0 vom Technisches Dossier zum Datenaustausch via WebServices; Version 1.3 vom 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 Weitere Informationen zum eidg. GWR sind im Internet verfügbar unter 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 / housing-stat@bfs.admin.ch

3 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 des BFS unter der Rubrik "Registrieren" (Zugriff über Web Services) einschreiben.

4 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 Neuchâtel

5 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 Nachschlagen der Daten einer existierenden Erhebungsstelle. modifyconstructionsurveydept Ändern der Daten einer existierenden Erhebungsstelle Ändern der Daten einer inexistenten Erhebungsstelle. setmaintenancecosts Aktualisieren der Unterhaltskosten einer existierenden Erhebungsstelle. getplausibilityerrorlist ConstructionSurveyDept Erhalten der Fehler einer existierenden Erhebungsstelle, die einen oder mehrere Fehler aufweist. getconstructionprojectbyid Suchen eines Bauprojektes im GWR mittels existierendem EPROID im GWR. getconstructionproject Erfolgreiches Durchführen der erweiterten Suche nach Bauprojekten. addconstructionproject Hinzufügen eines Bauprojektes mit 2 Gebäuden Hinzufügen eines Renovationsprojektes mit einem Gebäude Hinzufügen eines Abbruchprojektes mit 2 Gebäuden modifyconstructionproject Beenden eines Neubauprojektes mit 2 Gebäuden Beenden eines Neubauprojektes mit 2 Gebäuden und gültigen Bau-monat Ein fertiggestelltes Gebäude hinzufügen Beenden eines Renovationsprojektes mit einem Gebäude

6 Seite 6/ Ändern eines baubegonnenen Abbruchprojektes Ändern eines baubegonnen Bauprojektes in dem ein neues Gebäude angefügt wird checkconstructionproject Testen eines existierenden Bauprojektes. getplausibilityerrorlist ConstructionProject Erhalten der Fehler eines Bauprojektes, das einen oder mehrere Fehler aufweist. unbindbuildingfrom ConstructionProject Verknüpfung zwischen einem existerenden Gebäude und einem baubegonnenen Bauprojektes aufheben. addbuildingentrance Hinzufügen eines neuen Eingangs zu einem existierenden Gebäude. modifybuildingentrance Ändern eines existierenden Gebäudeeingangs. deletebuildingentrance Löschen eines existierenden Gebäudeeingangs. demolishbuilding Abbrechen eines existierenden Gebäudes. deletebuilding Löschen eines existierenden Gebäudes. checkbuilding Testen eines existierenden Gebäudes. getplausibilityerrorlistbuilding Erhalten der Fehler eines Gebäudes, das einen oder mehrere Fehler aufweist. demolishdwelling Aufheben einer existierenden Wohnung. deletedwelling Löschen einer existierenden Wohnung. getbuildingbyid Suche eines Gebäudes, das einen existierenden EGID im GWR hat Suche eines Gebäudes, das keinen existierenden EGID im GWR hat. getbuilding Erfolgreiches Durchführen der erweiterten Suche nach Gebäuden.

7 Seite 7/ Durchführen der erweiterten Suche nach Gebäuden mit Verweis auf ein Leerresultat. getdwellingbyewid Suche einer Wohnung, die eine Kombination EGID/EWID besitzt und im GWR existiert Suche einer Wohnung, die eine Kombination EGID/EWID besitzt und nicht im GWR existiert. getdwelling Erweiterte Suche nach einer Wohnung mit Erfolg Erweiterte Suche nach einer Wohnung mit Verweis auf ein Leerresultat. getdeletedbuilding Ein gelöschtes Gebäude suchen Ein gelöschtes Gebäude suchen, obwohl es aktiv ist Ein gelöschtes Gebäude suchen, das nicht in der Gemeinde liegt. modifybuilding Baumonat eines fertiggestellten Gebäude nachführen Falscher Baumonat eines fertiggestellten Gebäude nachführen. addbuilding Ein Gebäude hinzufügen, mit einem Eingang und einer Wohnung Ein Gebäude hinzufügen, mit zewi Eingänge und 8 Wohnungen Ein Gebäude hinzufügen, ohne Eingang Ein Gebäude hinzufügen, mit unvollständigem Eingang (ohne Gebäudenummer) Ein sich im Bau befindendes Gebäude hinzufügen Ein Gebäude hinzufügen mit einer Wohnung ohne Stockwerke Ein Gebäude hinzufügen, das schon existiert

8 Seite 8/10 addstreetname Hinzufügen eines neuen Strassennamens. addstreetlocalisation Hinzufügen einer neuen Lokalität an eine existierende Strasse. modifystreetlocalisation Ändern der Lokalität einer existierenden Strasse. getstreet Suche nach einer existierenden Strasse Suche nach einer nicht existierenden Strasse. confirmimprobability Bestätigen einer existierenden Fehlermeldung des Typs "que". getplausibiltyrule Suche nach einer existierenden Plausibilitätsregel Suche nach einer nicht existierenden Plausibilitätsregel. getprogressstatusquarterlyclosures Kontrolle des Fortschritts des laufenden vierteljährlichen Abschlusses einer existierenden Erhebungsstelle Kontrolle des Fortschritts des beendeten vierteljährlichen Abschlusses einer existierenden Erhebungsstelle. closequarterlysurvey Abschluss einer zum Abschluss bereiten existierenden Erhebungsstelle Abschluss einer bereits abgeschlossenen existierenden Erhebungsstelle. changepassword Ä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

9 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 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 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

10 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