Comando AddressAdd
Questo comando aggiunge una nuova voce di indirizzo per un utente o organizzazione.
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/path/
- (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.
- businessTitle
- La posizione aziendale dell'utente il cui indirizzo viene aggiunto (ad esempio, presidente o responsabile).
- nickName
- (Obbligatorio) Il soprannome o l'identificativo dell'indirizzo da aggiungere. Un membro può avere un insieme di indirizzi, ciascuno con un
soprannome. L'indirizzo che un utente fornisce in fase di registrazione viene
considerato dal sistema come l'indirizzo dell'utente che viene
registrato, quindi viene stabilito un soprannome per tale
indirizzo all'ID di collegamento dell'utente.
- personTitle
- Il titolo dell'utente di cui viene immesso l'indirizzo (ad esempio, Dr., Rev., Sig. o Sig.ra).
- lastName
- Il cognome dell'utente.
- 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 principale (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
Se addressType non è specificato, per valore predefinito è "SB"
- 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:
Y=sì
N=no
- 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:
Y=sì
N=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 1
Nel seguente esempio viene aggiunta una voce alla tabella degli indirizzi utilizzando il soprannome "indirizzo_mamma"
https://myhostname/webapp/wcs/stores/servlet/AddressAdd?
nickname=indirizzo_mamma&address1=7+Elm+St.&city=Toronto&state=Ontario
&country=Canada&zipCode=M4M+2T1&lastName=Lee&URL=/
Esempio 2
Nel seguente esempio viene aggiunto un indirizzo di fatturazione completo.
https://myhostname/webapp/wcs/stores/servlet/AddressAdd?URL=basemall.jsp&nickName=msur1nickB
&addressType=B&primary=1&personTitle=Dr&lastName=last&firstName=first
&middleName=middle&address1=address1&address2=address2
&address3=address3&city=Toronto&state=Ontario&country=Canada
&zipCode=A1A1A1&phone1=111-111-1111&phone2=222-222-2222
&phone1Type=PHN&phone2Type=TTY&publishPhone1=1&publishPhone2=0
&bestCallingTime=E&fax1=333-333-3333&fax2=444-444-4444
&email1=msur1nickB@email1.com&email2=msur1nickB@email2.com
&businessTitle=bustitle&organizationName=organization
&organizationUnitName=oraganizationunit&officeAddress=officeaddress
&packageSuppression=0&addressField1=field1&addressField2=field2
&addressField3=field3&billingCode=billingCode&billingCodeType=BT
&shippingGeoCode=shippinggeocode&taxGeoCode=taxgeocode
Nota: Per gli indirizzi temporanei o permanenti, ogni membro può possedere un insieme di indirizzi. Quando un indirizzo viene creato, lo stato viene contrassegnato con una "P", che significa "permanente" e che indica l'indirizzo corrente. Quando invece un indirizzo viene aggiornato, viene creato un nuovo record dell'indirizzo con tutti gli aggiornamenti. Il nuovo record viene contrassegnato con una "P" mentre il record precedente viene contrassegnato con una "T", che significa "temporaneo" e che indica la cronologia degli indirizzi.
Quando un indirizzo
viene eliminato dal comando AddressDelete
lo stato viene contrassegnato con una "T".
Azione
- Per ogni tipo di indirizzo, è possibile avere zero o un indirizzo
principale (il campo principale è 1).
Se il nuovo indirizzo è di tipo principale, questo comando modifica
come non-principale l'indirizzo principale esistente nel tipo di
indirizzo (se esistente).
- Se il parametro primary non viene specificato, il valore
predefinito è 0 (non principale).
- Se non viene specificato il parametro addressType, il valore predefinito è 'R' (Residential Address).
- Controllare se il soprannome specificato è già in uso.
- Richiamare il comando AuditAddressCmd per eseguire altri controlli del parametro.
Per personalizzare il controllo, è necessario che gli sviluppatori del negozio aggiungano altro codice al comando di attività AuditAddressCmd.
- Creare un nuovo indirizzo nella tabella
ADDRESS.
- Se il membro non dispone di una rubrica, verrà creato un nuovo
record nella
tabella ADDRBOOK.
- 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 nickName deve essere diverso da null, deve avere una
lunghezza superiore a 0 e non deve essere già presente
in questa rubrica.
- 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.