Doku

1Grundlegende Verwendung der Adressvalidierung

Die Adressvalidierung kann in ihrer einfachsten Verwendung eine Adresse innerhalb einer beliebigen Website validieren. Dazu muss ein JavaScript eingebettet werden, und die entsprechende JavaScript-Funktion kann anschliessend verwendet werden, um die Adresse zu validieren.

Nachfolgend ein einfaches Beispiel:

<script type="text/javascript" src="https://sandbox.app-wallee.com/assets/js/i18n/address-handler.js"></script>

<script type="text/javascript">
var address = {
	"givenName": "Marc",
	"familyName": "Stiffer",
	"street": "Some Street Name including street number etc.",
	"postcode": "The post code of the address. e.g. 8000",
	"country": "US",
	"postalState": "CA",
	"city": "Some City Name"
};

AddressHandler.validateAddress(address).then(function(){
	// You may want to continue processing here.
	console.log("The address is valid.");
}, function(invalidFields){
	console.log(invalidFields);

	for(var i = 0; i < invalidFields.length; i++){
		var fieldName = invalidFields[i].field;
		var errorMessage = invalidFields[i].message;
		// Here you may want to implement the user feedback about the invalid address field.
		console.log("The field " + fieldName + " is invalid. Error: " + errorMessage);
	}
});
</script>

Das obige Beispiel validiert die angegebene address. Die in der Antwort gelieferten Fehlermeldungen hängen von der Sprache des Browsers ab. Die Sprache kann auch erzwungen werden, indem ein language-Parameter am address-handler.js angegeben wird. Falls beispielsweise Deutsch erzwungen werden soll, kann die folgende URL verwendet werden:

<script type="text/javascript" src="https://sandbox.app-wallee.com/assets/js/i18n/address-handler.js?language=de"></script>

2Listen für Land, Kantone/Bundesländer und Rechtsformen

Üblicherweise wird eine Adresse innerhalb des Browsers zusammengestellt. Es kann jedoch erforderlich sein, eine Liste der verfügbaren Länder, Kantone/Bundesländer und Organisationsformen anzuzeigen. Das nachstehende Beispiel zeigt, wie die Adressvalidierung verwendet wird, um diese Datenelemente abzurufen:

<script type="text/javascript" src="https://sandbox.app-wallee.com/assets/js/i18n/address-handler.js"></script>

<script type="text/javascript">
AddressHandler.getCountries().then(function(countries) {
	console.log(countries);
});

AddressHandler.getCountryStates("CH").then(function(states) {
	console.log(states);
});

AddressHandler.getLegalOrganizationForms("CH").then(function(legalForms) {
	console.log(legalForms);
});

</script>