Allgemeine Informationen
Das PostService-Plugin von JAXForms liefert in Adressfeldern Vorschläge für PLZ, Ort und Strasse. Es führt dazu keine eigene Adressliste, sondern fragt bei jeder Eingabe live den Adress-Webservice der Schweizerischen Post ab und übernimmt die gelieferten Werte unverändert ins Formular.
...
| Codeblock |
|---|
| language | text |
|---|
| title | Pseudo-Schema Request |
|---|
| collapse | true |
|---|
|
request*: {
HouseKey*: Zahl
HouseNumber*: Text
HouseNumberAddition*: Text
Onrp*: Zahl
Streetname*: Text
StrId*: Zahl
TownName*: Text
ZipAddition*: Text
Zipcode*: Text
}
zipOrderMode*: Zahl |
...
| Codeblock |
|---|
| language | text |
|---|
| title | Pseudo-Schema Answer |
|---|
| collapse | true |
|---|
|
QueryAutoComplete2Result*: {
AutoCompleteResult*: [ {
HouseKey*: Zahl
HouseNumber*: Text
HouseNumberAddition*: Text
Onrp*: Zahl
StrId*: Zahl
Streetname*: Text
TownName*: Text
ZipAddition*: Text
Zipcode*: Text
} ]
Status*: Zahl
} |
| Feld | Typ | Max. Länge | Beschreibung |
|---|
Zipcode | Text | 4 | Vierstellige PLZ. |
ZipAddition | Text | 2 | PLZ-Zusatzziffer (fünfte und sechste Stelle). Unterscheidet gleichlautende vierstellige PLZ. |
TownName | Text | 27 | Ortsbezeichnung (lange Form). JAXForms schreibt sie unverändert ins Ort-Feld. |
Onrp | Zahl | – | Ordnungsnummer Post. Eindeutiger, unveränderlicher Schlüssel von PLZ/Ort. |
Streetname | Text | 60 | Strassenname in der Schreibweise der Post. Leer bei Treffern auf Ortsebene. |
StrId | Zahl | – | Schlüssel der Strasse. 0 bei Treffern auf Ortsebene. |
HouseKey | Zahl | 19 | Schlüssel des Gebäudes. 0 bei Treffern auf Orts- oder Strassenebene. |
HouseNumber | Text | 40 | Hausnummer. Leer bei Treffern auf Orts- oder Strassenebene. |
, HouseNumberAddition | Text | 6 | Hausnummer und -Zusatz. Leer bei Treffern auf Orts- oder Strassenebene. |
Status | Zahl | – | 0 = Abfrage erfolgreich. Weitere Werte siehe «Verhaltensregeln» |
Anmerkung zu den Längen: Die Spezifikation der Post enthält für die Autocomplete-Answer keine eigene Längentabelle. Die Werte stammen aus der «Data output structure» (Kapitel 1.3.3 und 3.3.3, Spalte «Maximum field length») desselben Service, die dort für Adresspflege und Adressprüfung gilt. Die Felder heissen dort ZIPcode, ZIPAddition, TownName, Streetname, Housekey, HouseNo und HouseNoAddition. Für Onrp, StrId und Status nennt die Spezifikation keine Länge.
...
Verhaltensregeln
Suchebene
...
| Codeblock |
|---|
| language | javascript |
|---|
| title | Request PLZ 1374 |
|---|
| collapse | true |
|---|
|
{
"request" : {
"HouseKey" : 0,
"HouseNumber" : "",
"HouseNumberAddition" : "",
"Onrp" : 0,
"Streetname" : "",
"StrId" : 0,
"TownName" : "",
"ZipAddition" : "",
"Zipcode" : "1374"
},
"zipOrderMode" : 0
} |
...
| Codeblock |
|---|
| language | javascript |
|---|
| title | Answer PLZ 1374 |
|---|
| collapse | true |
|---|
|
{
"QueryAutoComplete2Result" : {
"AutoCompleteResult" : [ {
"HouseKey" : 0,
"HouseNumber" : "",
"HouseNumberAddition" : "",
"Onrp" : 588,
"StrId" : 0,
"Streetname" : "",
"TownName" : "Corcelles-sur-Chavornay",
"ZipAddition" : "00",
"Zipcode" : "1374"
} ],
"Status" : 0
}
} |
...
| Codeblock |
|---|
| language | javascript |
|---|
| title | Request PLZ 2206 |
|---|
| collapse | true |
|---|
|
{
"request" : {
"HouseKey" : 0,
"HouseNumber" : "",
"HouseNumberAddition" : "",
"Onrp" : 0,
"Streetname" : "",
"StrId" : 0,
"TownName" : "",
"ZipAddition" : "",
"Zipcode" : "2206"
},
"zipOrderMode" : 0
} |
...
| Codeblock |
|---|
| language | javascript |
|---|
| title | Answer PLZ 2206 |
|---|
| collapse | true |
|---|
|
{
"QueryAutoComplete2Result" : {
"AutoCompleteResult" : [ {
"HouseKey" : 0,
"HouseNumber" : "",
"HouseNumberAddition" : "",
"Onrp" : 1359,
"StrId" : 0,
"Streetname" : "",
"TownName" : "Les Geneveys-sur-Coffrane",
"ZipAddition" : "00",
"Zipcode" : "2206"
} ],
"Status" : 0
}
} |
...
| Codeblock |
|---|
| language | javascript |
|---|
| title | Request Ort |
|---|
| collapse | true |
|---|
|
{
"request" : {
"HouseKey" : 0,
"HouseNumber" : "",
"HouseNumberAddition" : "",
"Onrp" : 0,
"Streetname" : "",
"StrId" : 0,
"TownName" : "aarauAarau",
"ZipAddition" : "",
"Zipcode" : ""
},
"zipOrderMode" : 0
} |
...
| Codeblock |
|---|
| language | javascript |
|---|
| title | Answer Ort |
|---|
| collapse | trueRequest Strasse |
|---|
|
{
"QueryAutoComplete2Result" : {
"AutoCompleteResult" : [ {
"HouseKey" : 0,
"HouseNumber" : "",
"HouseNumberAddition" : "",
"Onrp" : 2913,
"StrId" : 0,
"Streetname" : "",
"TownName" : "Aarau",
"ZipAddition" : "00",
"Zipcode" : "5000"
}, {
"HouseKey" : 0,
"HouseNumber" : "",
"HouseNumberAddition" : "",
"Onrp" : 2928,
"StrId" : 0,
"Streetname" : "",
"TownName" : "Aarau 1",
"ZipAddition" : "00",
"Zipcode" : "5001"
}, {
"HouseKey" : 0,
"HouseNumber" : "",
"HouseNumberAddition" : "",
"Onrp" : 2932,
"StrId" : 0,
"Streetname" : "",
"TownName" : "Aarau",
"ZipAddition" : "00",
"Zipcode" : "5004"
}, {
"HouseKey" : 0,
"HouseNumber" : "",
"HouseNumberAddition" : "",
"Onrp" : 2949,
"StrId" : 0,
"Streetname" : "",
"TownName" : "Aarau Rohr",
"ZipAddition" : "00",
"Zipcode" : "5032"
} ],
"Status" : 0
}
} |
...
| Codeblock |
|---|
| language | javascript |
|---|
| title | Request Strasse |
|---|
| collapse | true |
|---|
|
{
"request" : {
"HouseKey" : 0,
"HouseNumber" : "",
"HouseNumberAddition" : "",
"Onrp" : 0,
"Streetname" : "Frankl",
"StrId" : 0,
"TownName" : "",
"ZipAddition" : "",
"Zipcode" : "8050"
},
"zipOrderMode" : 0
} |
...
| Codeblock |
|---|
| language | javascript |
|---|
| title | Answer Strasse |
|---|
| collapse | true |
|---|
|
{
"QueryAutoComplete2Result" : {
"AutoCompleteResult" : [ {
"HouseKey" : 0,
"HouseNumber" : "",
"HouseNumberAddition" : "",
"Onrp" : 4468,
"StrId" : 66043,
"Streetname" : "Franklinstrasse",
"TownName" : "Zürich",
"ZipAddition" : "00",
"Zipcode" : "8050"
} ],
"Status" : 0
}
} |