Spezifikationen

Lieferung

Beispiel mit Datensatz 10:

Item	Bedeutung
GWR_MADD_Export_MADD-20200326-B10_20200624.zip	Voller Name
GWR_MADD_Export	Fixer Teil
MADD-20200326-B10	Gesuchs-Referenz
20200624	Datum YYYYMMDD

Item	Bedeutung
GWR_MADD_ARB-10_Data_MADD-20200326-B10_20200624.dsv GWR_MADD_ARB-10_Readme_MADD-20200326-B10_20200624.dsv	Datei mit den Daten Datei mit den Beschreibungen der Header
GWR_MADD	Fixer Teil
ARB	Arbeiten*
EIN	Eingang*
GEB	Gebäude*
GST	Grundstück*
PROJ	Bauprojekt*
WHG	Wohnung*
10	Datensatz
MADD-20200326-B10	Gesuchs-Referenz
20200624	Datum YYYYMMDD
MADD_GWR_Codeliste.xlsx	Codeliste auf Feldebene
Allenfalls weitere Dateien	Nach Bedarf

*) je nach Datensatz ihres Gesuches erhalten sie nicht alle Datei-Typen

Datenarchitektur eCH-0206

Zugang zum GUI und Automatisierung des Downloads

Sie können den csv-Download auch automatisieren. Verwenden sie dazu den HTTP-Authentifizierung Basic Authentication (die GUI Version ist nicht implementiert). Verwenden sie ein Tool wie Beispielsweise cURL (steht so ziemlich auf allen System zur Verfügung). Auch ETL Tools und ähnliches beherrschen Basic Authentication. Beispiele mit cURL:

set HTTPS_PROXY={your-proxy}:{your-proxy-port} curl -k -J -O --user MADD-20200326-A1:{Passwort} "https://madd.bfs.admin.ch/download_zip curl -k --output blubber.zip --user MADD-20200326-A1:{Passwort} "https://madd.bfs.admin.ch/download_zip" curl -v -k --output blubber.zip --user MADD-20200326-A1:{Passwort} "https://madd.bfs.admin.ch/download_zip"

Die erste Zeile brauchen sie nur, wenn sich ihr System hinter einem Proxy befindet.
Die zweite Zeile erzeugt automatisch den gleichen Dateinamen wie beim GUI.
Die dritte Zeile benutzt dem von ihnen gewählten Dateinamen.
Die vierte Zeile hat noch ein -v = verbous als Parameter. Verwenden sie diesen Parameter bei Problemen.

Weitere Hinweise

Loader by Position

Wollen sie einen Loader implementieren, so sollten sie dazu unbedingt die Header verwenden: by keywords (und nicht by position).

Damit sind sie stabiler gegenüber neuen Feldern, welche nicht unbedingt am Ende zugefügt werden.

Dies war mit den bestehenden Exports nicht möglich. Wir empfehlen, diese Loader auch diesbezüglich entsprechend anzupassen.

Nicht normalisiert

Die Daten werden nicht in einer komplett normalisierten Form geliefert. Beispiele:

• Es gibt keine Datei nur mit den Gemeinden oder nur mit den Strassen.
• Wenn eine Strasse sowohl einen französischen also auch einen deutschen Namen hat, dann werden zwei Zeilen mit gleichen [EGID, EDID] geliefert, welche sich nur in [STRSP, STRNAME, STRNAMK, STRINDX] unterscheiden.

Dies erkennt man auch an der Platzierung von Create_Date/Update_Date. Felder rechts davon sind nicht normalisiert, diese Felder stammen aus anderen Entitäten.

Create_Date / Update_Date

Diese Daten beziehen sich nur auf die Felder der Hauptentität. Beispielsweise bei den Eingängen (EIN) bezieht sich Update_Date nur auf die Felder links davon, EGID bis DOFFADR aber nicht auf die Felder Rechts davon, ESID bis STRINDX.

EG­ID	ED­ID	EG­AID	DEI­NR	DKO­DE	DKO­DN	DOFF­ADR	Crea­te_Da­te	Up­da­te_Da­te	ES­ID	STR­OF­FI­ZIEL	DPLZ4
470­001	0	100­347­425	5	2­679­710.98	1­284­583.34		14.­12.­2016	29.­03.­2021	101­118­350	1	8214

Wenn also:

• Gemeinden fusionieren
• Eine Strasse den Namen ändert
• Eine Strasse neu auch einen deutschen Namen erhält (dies erzeugt eine neue Zeile)
• Zwei Strassen fusionieren
• Ein Ort oder eine Gemeinde den Namen ändert
• usw.

...wird keines der Datumsfelder angepasst, da sich letztlich am Eingang selber nichts geändert hat. Natürlich werden die geänderten Werte ausgeliefert.