Instruction AddressAdd
Cette instruction permet d'ajouter une nouvelle entrée d'adresse pour un utilisateur ou
une entreprise.
Utilisez cette instruction avec la connexion sécurisée (SSL) pour vous assurer que le mot de passe de connexion et les informations personnelles sont codés. A cette fin, tapez la commande avec le Protocole de transport hypertexte sécurisé (HTTPS).

Valeurs des paramètres
- http://host_name/path/
- (Obligatoire) Nom qualifié complet de votre serveur WebSphere Commerce et chemin de configuration
- langId
- Affecte ou réinitialise la langue préférée pour la durée de la session ; les langues prises en charge pour un magasin figurent dans la table STORELANG
- forUser
- ID de connexion de l'utilisateur ou de l'entreprise au nom desquels l'instruction est exécutée. Seule une personne disposant des droits de traitement des commandes peut spécifier ce paramètre.
- forUserId
- Identique à forUser, mais identifie l'utilisateur par l'ID d'utilisateur interne, tel qu'elle est indiquée dans la table USERS.
- memberId
- Si memberId n'est pas précisé, la valeur par défaut est celle de l'utilisateur en cours
(l'utilisateur qui se connecte). Ce paramètre peut être utilisé pour ajouter les adresses des services ou des autres utilisateurs.
- URL
- (Obligatoire) URL devant être lancée lorsque l'instruction aboutit.
- businessTitle
- Fonction de la personne dont l'adresse est mise à jour (Président ou Directeur, par exemple).
- nickName
- (Obligatoire) Alias ou identificateur de l'adresse ajoutée. Un membre peut avoir plusieurs adresses, chacune ayant son propre alias. L'adresse fournie par un utilisateur au moment de s'inscrire est considérée par le système comme l'adresse personnelle de la personne ; le système définit donc un alias pour cette adresse qu'il rattache à l'ID de connexion de l'utilisateur.
- personTitle
- Titre de la personne dont l'adresse fait l'objet d'une nouvelle entrée (Dr., Rev., M. ou Mme, par exemple)..
- lastName
- Nom de famille de l'utilisateur.
- firstName
-
Prénom de l'utilisateur.
- middleName
-
Deuxième prénom de l'utilisateur.
- organizationName
-
Société que la personne représente.
- organizationUnitName
- Unité dans laquelle exerce l'utilisateur au sein de sa société.
- officeAddress
- Adresse interne de la société (la boîte postale, par exemple).
- primary
- L'adresse est-elle une adresse principale pour un type d'adresse spécifique :
1=principale
0=non principale (valeur par défaut)
- addressType
- Le type de l'adresse, par exemple :
R=personnelle (valeur par défaut)
M=envoi
S=expédié à
B=facturation
SB=expédition et facturation
Si addressType n'est pas précisé, la valeur par défaut est "SB"
- address1
-
La première ligne de l'adresse de l'utilisateur.
- address2
-
La deuxième ligne de l'adresse de l'utilisateur.
- address3
-
La troisième ligne de l'adresse de l'utilisateur.
- city
-
Ville de résidence de l'utilisateur.
- state
-
Département, région ou équivalent de l'utilisateur.
- zipCode
-
Code postal de l'adresse de l'utilisateur.
- country
-
Pays ou région de l'utilisateur.
- bestCallingTime
- Est-il préférable d'appeler l'utilisateur dans la journée ou le soir :
- phone1
- Numéro de téléphone principal de l'utilisateur.
- phone1Type
-
Type de téléphone correspondant au numéro de téléphone principal de l'utilisateur, par exemple TTY pour les personnes malentendantes, PCM pour les téléphones à modulation à impulsion ou CEL pour les téléphones mobiles.
Il s'agit d'une zone à 3 caractères.
- publishPhone1
-
Faut-il répertorier le numéro de téléphone principal de l'utilisateur :
O=oui
N=non
- phone2
- Numéro de téléphone secondaire de l'utilisateur.
- phone2Type
-
Type de téléphone correspondant au numéro de téléphone secondaire de l'utilisateur, par exemple TTY pour les personnes malentendantes, PCM pour les téléphones à modulation à impulsion ou CEL pour les téléphones mobiles.
Il s'agit d'une zone à 3 caractères.
- publishPhone2
-
Faut-il répertorier le numéro de téléphone secondaire de l'utilisateur :
O=oui
N=non
- fax1
-
Numéro de télécopie principal de l'utilisateur.
- fax2
-
Numéro de télécopie secondaire de l'utilisateur.
- email1
-
Adresse électronique ou Web principale de l'utilisateur.
- email2
-
Adresse électronique ou Web secondaire ou de l'utilisateur.
- billingCode
- Code de la société permettant d'identifier les adresses d'expédition ou de facturation, ainsi que le centre de coûts
- billingCodeType
- Code désignant la méthode de structure de code utilisée pour le code de
facturation. La valeur par défaut est D, attribuée par l'acheteur. La valeur 02
indique que cette valeur a été affectée par Ariba.
- taxPayerId
- Chaîne utilisée pour identifier l'utilisateur pour l'application des taxes, particulièrement utile pour les logiciels de calcul des taxes.
- packageSuppression
-
Indique s'il faut joindre des insertions de colis à l'expédition :
1=inclure
0=ne pas inclure
- addressfield1 à addressfield3
-
Zones à personnaliser.
- shippingGeoCode
- Code de livraison en fonction de la région géographique, particulièrement utile avec les logiciels de taxation.
- taxGeoCode
- Code de taxe basé sur une région géographique, particulièrement utile avec les logiciels de taxation.
Exemple 1
L'exemple suivant permet d'ajouter un élément à la table des adresses en utilisant l'alias "mother_address."
https://myhostname/webapp/wcs/stores/servlet/AddressAdd?
nickName=mother_address&address1=7+Elm+St.&city=Toronto&state=Ontario
&country=Canada&zipCode=M4M+2T1&lastName=Lee&URL=/
Exemple 2
L'exemple suivant permet d'ajouter une adresse de facturation complète.
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
Remarque : Pour les adresses temporaires et permanentes, chaque membre peut avoir plusieurs adresses. Lorsqu'une adresse est créée, son statut est indiqué par la lettre "P", qui signifie
"permanent" et qui indique l'adresse courante. Lorsqu'une adresse est mise à jour, un nouvel enregistrement de l'adresse est créé en même temps que la mise à jour. Le nouvel enregistrement est accompagné de la lettre "P" alors que l'enregistrement précédent prend la lettre "T", qui signifie "temporaire" et qui indique l'ancienne adresse.
Lorsqu'une adresse est supprimée à l'aide de l'instruction AddressDelete, son statut prend la lettre "T".
Comportement
- Pour chaque type d'adresse, il peut y avoir zéro ou une adresse principale (la zone primaire est égale à 1).
Si la nouvelle adresse est une adresse principale, cette instruction donnera à l'adresse principale existant déjà dans ce type d'adresse (s'il y en a une) le statut d'adresse secondaire.
- Si le paramètre primaire n'est pas indiqué, la valeur par défaut est 0 (secondaire).
- Si le paramètre addressType n'est pas indiqué, la valeur par défaut est 'R'.
- Vérifiez si l'alias indiqué est déjà utilisé.
- Appelle la tâche AuditAddressCmd pour effectuer un contrôle
supplémentaire de paramètre.
Les développeurs de magasins doivent ajouter un nouveau code à l'instruction d'activité AuditAddressCmd pour personnaliser cette vérification.
- Créez une adresse dans la table ADDRESS.
- Si le membre ne dispose pas d'un répertoire d'adresses, créez
un enregistrement dans la table ADDRBOOK.
- L'instruction AddressErrorView est appelée lorsque cette instruction n'aboutit pas.
- Lorsque l'instruction a abouti, appelez l'URL indiquée.
Condition d'exception
- L'URL de paramètre ne peut pas être nulle et doit avoir une longueur supérieure à 0.
- Le paramètre d'alias doit être d'une valeur non-nulle et doit comporter plus de 0 caractères.
Il ne doit pas exister dans le répertoire.
- Le paramètre primary doit être défini par NULL ou être égal à 0 ou à 1.
- Les paramètres publishPhone1, publishPhone2 et packageSupression doivent être définis par NULL
ou être des entiers.