Deprecated feature

URL AddressUpdate

Cette URL met à jour l'entrée d'adresse d'un utilisateur.

Cette commande met à jour l'entrée d'adresse d'un utilisateur. Si le paramètre addressId n'est pas fourni, la commande AddressAdd est appelée pour ajouter une nouvelle adresse. Utilisez cette commande avec SSL (Secure Sockets Layer) pour garantir le chiffrement du mot de passe de connexion et des informations personnelles du membre. Pour ce faire, entrez la commande avec le protocole sécurisé HTTPS.

Structure de l'adresse URL

http:// host_name/path/
Nom entièrement qualifié de votre Transaction server et du chemin de configuration.

Valeurs des paramètres

langId
Définit ou redéfinit la langue préférée pour la durée de la session ; les langues prises en charge dans le magasin sont répertoriées dans la table STORELANG.
forUser
ID de connexion de l'utilisateur ou de l'organisation pour lequel/laquelle l'adresse URL sera exécutée. Seul un utilisateur habilité à traiter les commandes peut indiquer ce paramètre.
forUserId
Identique à forUser, mais identifiant l'utilisateur par son ID interne, répertorié dans la table USERS.
URL
Obligatoire : Adresse URL à appeler une fois que la commande a abouti.
addressId
Obligatoire : Numéro de référence de l'adresse à mettre à jour.
businessTitle
Position dans l'entreprise de l'utilisateur dont l'adresse est mise à jour (par exemple, Président ou Gestionnaire).
personTitle
Titre de l'utilisateur dont l'adresse est mise à jour (par exemple, Dr., Rev., M. ou Mme.).
firstName
Prénom de l'utilisateur.
middleName
Deuxième prénom ou initiale de l'utilisateur.
organizationName
Organisation que représente l'utilisateur.
organizationUnitName
Nom de l'unité au sein de l'organisation de l'utilisateur.
officeAddress
Adresse organisationnelle interne (par exemple, arrêt de messagerie).
primaire
Si l'adresse donnée est une adresse principale pour un type d'adresse particulier :
1
primary
0
pas primaire (par défaut)
addressType
Le type d'adresse ; par exemple :
S
expédition
B
facturation
SB
expédition et facturation (par défaut)
address1
Première ligne de la partie numéro et rue de l'adresse de l'utilisateur.
address2
Deuxième ligne de la partie numéro et rue de l'adresse de l'utilisateur.
address3
Troisième ligne de la partie numéro et rue de l'adresse de l'utilisateur.
city
Nom de la ville où réside l'utilisateur.
état
Nom du pays, de la province ou équivalent où réside l'utilisateur.
zipCode
Code postal de l'adresse de l'utilisateur.
country
Nom du pays ou de la région où l'utilisateur réside.
bestCallingTime
S'il faut appeler l'utilisateur dans la journée ou le soir :
D
journée
E
soir
mobilePhone1
Le numéro de téléphone portable de la personne qui s'inscrit est utilisé pour les SMS, par exemple, le 4161235555.
mobilePhone1Country
Le code pays utilisé pour le numéro de téléphone portable de la personne qui s'inscrit, par exemple CA pour le Canada.
phone1
Entrez le numéro de téléphone portable principal de l'utilisateur.
phone1Type
Le type de téléphone utilisé au numéro principal de l'utilisateur ; par exemple, TTY pour une personne malentendante, PCM pour la modulation par impulsions codées ou CEL (cellulaire) pour un mobile. Il s'agit d'un champ à trois caractères.
publishPhone1
S'il faut noter le numéro de téléphone principal de l'utilisateur.
1
oui
0
non
phone2
Numéro de téléphone secondaire de l'utilisateur.
phone2Type
Le type de téléphone utilisé au numéro secondaire de l'utilisateur ; par exemple, TTY pour une personne malentendante, PCM pour la modulation par impulsions codées ou CEL (cellulaire) pour un mobile. Il s'agit d'un champ à trois caractères.
publishPhone2
S'il faut noter le numéro de téléphone secondaire de l'utilisateur :
1
oui
0
non
fax1
Numéro de fac-similé principal de l'utilisateur.
fax2
Numéro de fac-similé secondaire de l'utilisateur.
email1
Adresse électronique ou adresse Web principale de l'utilisateur.
email2
Adresse électronique ou adresse Web secondaire de l'utilisateur.
billingCode
Code de l'organisation de l'acheteur servant à identifier les adresses d'expédition ou de facturation et 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.
taxPayerId
Chaîne utilisée pour identifier l'utilisateur pour la fiscalité, particulièrement utile avec les logiciels fiscaux.
packageSuppression
S'il faut inclure des notices lors de l'expédition de la commande :
1
inclure
0
ne pas inclure
addressField1 à addressField3
Zones personnalisables .
shippingGeoCode
Code d'expédition basé sur la région géographique, particulièrement utile avec les logiciels fiscaux.
taxGeoCode
Code fiscal basé sur la région géographique, particulièrement utile avec les logiciels fiscaux.
outAddressName
Si outAddressName=s est spécifié (où s est n'importe quelle chaîne), alors s= <address_id> sera défini comme l'une des propriétés de réponse après que la commande est exécutée, où <address_id> est l'ID de l'adresse ajoutée ou mise à jour.

Exemple

L'exemple suivant met à jour une entrée de carnet d'adresses pour l'adresse avec l'ID 128 pour lui permettre d'inclure le prénom Jeffery.


     https://myhostname/webapp/wcs/stores/servlet/AddressUpdate?
    
addressId=128&firstName=Jeffery&URL=/webapp/wcs/stores/servlet/

Comportement

  • La commande AddressUpdate ne peut pas mettre à jour les adresses d'un autre membre et ne peut pas mettre à jour une adresse temporaire.
  • Pour chaque type d'adresse, il peut y avoir zéro ou une adresse principale (champ primary égal à 1). Si la mise à jour doit passer de principale à non principale, cette commande modifiera l'adresse principale existante de ce type d'adresse (s'il y en a une) en non principale.
  • L'alias ne peut pas être mis à jour.
  • Si le mode d'authentification est LDAP et que cette adresse est l'adresse d'inscription (selfAddress = 1), mettez à jour les informations de cette adresse sur le serveur LDAP.
  • Appelez l'instruction de tâche AuditAddressCmd pour effectuer des vérifications de paramètres supplémentaires. Les développeurs de magasins doivent ajouter du nouveau code à l'instruction de tâche AuditAddressCmd s'ils souhaitent personnaliser la vérification.
  • Insère une nouvelle adresse dans la table ADDRESS avec l'alias spécifié. L'ancienne adresse est marquée comme temporaire et la nouvelle adresse est marquée comme permanente.
  • Si la commande échoue, la commande AddressErrorView est appelée.
  • Si l'exécution de la commande s'achève normalement, l'URL spécifiée est appelée.
  • Par défaut, la commande valide le fait que les longueurs de chaîne des valeurs de propriété sont inférieures ou égales à la taille par défaut de la colonne de base de données correspondante. Une ECApplicationException est lancée si la longueur maximale est dépassée. Cette validation peut être désactivée en ajoutant la section suivante dans l'élément <MemberSubSystem> du fichier de configuration d'instance : <Address PropertyLengthValidation="false" />

Conditions d'exception

  • L'URL du paramètre doit être non nulle et doit avoir une longueur supérieure à 0.
  • Le paramètre addressId doit être non nul et il doit indiquer dans la table ADDRESS une adresse qui appartient à l'utilisateur actuel et qui n'est pas une adresse temporaire.
  • Le paramètre nickName doit être identique à l'ancien alias si un paramètre nickName est spécifié.
  • Le paramètre principal doit être soit null, soit être égal à 0 ou 1.
  • Les paramètres publishPhone1, publishPhone2 et packageSuppression doivent être soit null, soit un entier.
  • Le gestionnaire d'erreurs capture le code d'erreur, qui peut être l'un des codes ci-dessous.
    Explication Code d'erreur
    Un paramètre URL est manquant. _ERR_CMD_MISSING_PARAM
    Le paramètre URL est vide _ERR_CMD_INVALID_PARAM
    addressId est vide ou inexistant _ERR_CMD_INVALID_PARAM (5015)
    addressId fait référence à l'adresse temporaire _ERR_UPDATE_TEMPORARY_ADDRESS (5006)
    nickName est spécifié et n'est pas équivalent à l'alias existant _ERR_UPDATE_NICKNAME
    primary est spécifié et n'est pas égal à 0 ou 1 _ERR_CMD_INVALID_PARAM (5017)
    publishPhone1 est spécifié et n'est pas un entier _ERR_CMD_INVALID_PARAM (5170)
    publishPhone2 est spécifié et n'est pas un entier _ERR_CMD_INVALID_PARAM (5180)
    packageSuppression est spécifié et n'est pas un entier _ERR_CMD_INVALID_PARAM (5190)