Docs

1Utilizzo di base della validazione dell’indirizzo

Nel suo utilizzo più semplice, la validazione dell’indirizzo può validare un indirizzo all’interno di qualsiasi sito web. A tal fine, occorre integrare uno JavaScript e la corrispondente funzione JavaScript può quindi essere utilizzata per validare l’indirizzo.

Di seguito un semplice esempio:

<script type="text/javascript" src="https://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>

L’esempio precedente valida l'`address` fornito. I messaggi di errore forniti nella risposta dipenderanno dalla lingua del browser. La lingua può anche essere imposta fornendo un parametro language sull'`address-handler.js`. Ad esempio, se si desidera imporre il tedesco, è possibile utilizzare il seguente URL:

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

2Elenchi di paesi, stati e forme giuridiche di organizzazione

In genere, un indirizzo può essere costruito all’interno del browser. Tuttavia, potrebbe essere necessario visualizzare un elenco dei paesi, degli stati e delle forme di organizzazione disponibili. L’esempio seguente mostra il modo di utilizzare la validazione dell’indirizzo per recuperare tali elementi di dati:

<script type="text/javascript" src="https://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>