Comando AddressUpdate
Questo comando consente di aggiornare un indirizzo per un utente.
Utilizzare questo comando con SSL (Secure Sockets Layer) per
verificare che la password di accesso e le informazioni personali del
membro siano codificate. Per fare ciò, digitare il comando con il protocollo di sicurezza HTTPS.

Valori dei parametri
- http://nome_host/percorso/
- (Obbligatorio) Il nome completo del WebSphere Commerce Server e il percorso di configurazione.
- langId
- Imposta o reimposta la lingua prescelta per la durata della sessione; le lingue supportate per un negozio si trovano nella tabella STORELANG
- forUser
- L'ID di collegamento dell'utente o dell'organizzazione per conto del quale viene eseguito il comando; solo una persona con l'autorizzazione per elaborare ordini può specificare questo parametro.
- forUserId
- Come per forUser, ma con identificazione dell'utente mediante
l'ID utente interno,
come rilevato nella tabella
USERS.
- memberId
- Se memberId non è specificato, per impostazione predefinita è l'utente corrente
(l'utente che effettua il collegamento). Questo parametro può essere utilizzato per aggiungere l'indirizzo per le le entità aziendali o per altri utenti.
- URL
- (Obbligatorio) L'URL da richiamare quando il comando viene eseguito correttamente.
- addressId
- (Obbligatorio) Il numero di riferimento dell'indirizzo da aggiornare.
- businessTitle
- La posizione aziendale dell'utente il cui indirizzo viene aggiornato (ad esempio, presidente o responsabile).
- personTitle
- Il titolo dell'utente di cui viene aggiornato l'indirizzo (ad esempio, Dr., Rev., Sig. o Sig.ra).
- firstName
- Il nome dell'utente.
- middleName
- Il secondo nome o le iniziali dell'utente.
- organizationName
- L'organizzazione rappresentata dall'utente.
- organizationUnitName
- Il nome dell'unità all'interno dell'organizzazione dell'utente.
- officeAddress
- L'indirizzo interno dell'organizzazione (ad esempio, fermo posta).
- primary
- Specifica se l'indirizzo immesso è un indirizzo principale per un particolare tipo di indirizzo:
- 1=principale
- 0=non primario (valore predefinito)
- addressType
- Il tipo di indirizzo, per esempio:
- R=indirizzo di residenza (predefinito)
- M=indirizzo di posta
- S=indirizzo di spedizione
- B=indirizzo di fatturazione
- SB=indirizzo di spedizione e fatturazione
- address1
- La prima riga dell'indirizzo dell'utente.
- address2
- La seconda riga dell'indirizzo dell'utente.
- address3
- La terza riga dell'indirizzo dell'utente.
- city
- Il nome della città dove risiede l'utente.
- state
- Lo stato o la provincia dove risiede l'utente.
- zipCode
- Il codice di avviamento postale (CAP) dell'indirizzo dell'utente.
- country
- Il nome della nazione o della regione dove risiede l'utente.
- bestCallingTime
- Specifica se telefonare all'utente durante il giorno o nelle ore serali:
- phone1
- Il numero di telefono principale dell'utente.
- phone1Type
-
Il tipo di telefono utilizzato per il numero di telefono principale, ad esempio TTY per gli utenti con problemi all'udito, PCM per pulse-coded modulation o CEL per il telefono cellulare. E' un campo di 3 caratteri.
- publishPhone1
- Specifica se elencare o meno il numero di telefono principale dell'utente:
- phone2
- Il numero di telefono secondario dell'utente.
- phone2Type
-
Il tipo di telefono utilizzato per il numero di telefono secondario, ad esempio TTY per gli utenti con problemi all'udito, PCM per pulse-coded modulation o CEL per il telefono cellulare. E' un campo di 3 caratteri.
- publishPhone2
- Specifica se elencare o meno il numero di telefono secondario dell'utente:
1= sì
0= no
- fax1
-
Il numero di fax principale dell'utente.
- fax2
-
Il numero di fax secondario dell'utente.
- e-mail1
- L'indirizzo principale e-mail o Web dell'utente.
- e-mail2
- L'indirizzo secondario e-mail o Web dell'utente.
- billingCode
- Il codice dell'organizzazione dell'acquirente per identificare gli indirizzi di spedizione e di fatturazione e il centro costi.
- billingCodeType
- Il codice che indica il metodo di struttura dei codici utilizzato per il
codice di fatturazione. Il valore predefinito è D, assegnato dall'acquirente.
Il valore 02 indica che viene assegnato da Ariba.
- taxPayerId
- Una stringa utilizzata per identificare l'utente per la tassazione, particolarmente utile con il software delle tasse
- packageSuppression
- Specifica se includere o meno la documentazione del pacchetto quando viene spedito l'ordine:
1=includi
0=non includere
- da addressfield1 a addressfield3
- Campi personalizzabili.
- shippingGeoCode
- Un codice di spedizione basato sulla regione geografica, particolarmente utile con il software delle tasse.
- taxGeoCode
- Un codice di imposta basato sulla regione geografica, particolarmente utile con il software delle tasse.
Esempio
L'esempio seguente aggiorna una voce della rubrica per l'indirizzo con ID 128 per includere il nome Jeffery.
https://myhostname/webapp/wcs/stores/servlet/AddressUpdate?
addressId=128&firstName=Jeffery&URL=/webapp/wcs/stores/servlet/
Azione
- Il comando AddressUpdate non può aggiornare indirizzi di altri
membri né un indirizzo temporaneo.
- Per ogni tipo di indirizzo, è possibile avere zero o un indirizzo
principale (il campo principale è 1). Se l'aggiornamento deve modificare questo indirizzo da principale a
non principale, questo comando modifica
come non-principale l'indirizzo principale esistente in questo
tipo di indirizzo (se esistente).
- Non è possibile aggiornare il soprannome.
- Se la modalità di autenticazione è LDAP e l'indirizzo è quello
di registrazione (il soprannome sarà lo stesso in quanto il
campo logonId e selfAddress è uguale a 1), aggiornare
le informazioni su questo indirizzo nel server LDAP.
- Richiamare il comando di attività AuditAddressCmd
per eseguire ulteriori controlli del parametro. Per personalizzare il controllo, gli sviluppatori del sito devono
aggiungere altro codice al comando AuditAddressCmd.
- Inserire un nuovo indirizzo nella tabella
ADDRESS con il soprannome
specificato. L'indirizzo precedente è contrassegnato come temporaneo
mentre il nuovo indirizzo come permanente.
- Se il comando ha esito negativo, viene richiamato il comando AddressErrorView.
- Al termine dell'operazione con esito positivo, richiamare l'URL specificato.
Condizioni di eccezione
- Il parametro URL deve essere diverso da null e deve avere una lunghezza superiore a 0.
- Il parametro addressId deve essere diverso da null e deve puntare
a un indirizzo nella tabella ADDRESS che appartenga all'utente corrente e che non sia un indirizzo temporaneo.
- Il parametro nickName dovrebbe essere uguale al soprannome
precedente, se quest'ultimo è specificato.
- Il parametro primary deve essere null oppure corrispondente a 0 o
1.
- I parametri publishPhone1, publishPhone2 e packageSupression
devono essere null oppure un numero intero.