Deprecated feature

URL BuyerUserRegistrationUpdate

Cette URL est utilisée pour enregistrer un utilisateur B2B ou mettre à jour le profil d'inscription d'un utilisateur B2B inscrit.

Cette URL est utilisée pour enregistrer un utilisateur B2B ou mettre à jour le profil d'inscription d'un utilisateur B2B inscrit. Si l'utilisateur actuel est un client invité, cette commande appelle la commande UserRegistrationAddPreApproval pour inscrire un nouvel utilisateur. Si l'utilisateur est un utilisateur inscrit actuellement connecté, la commande UserRegistrationUpdate sera appelée pour mettre à jour le profil d'inscription. Les informations des utilisateurs sont stockées dans les tables de base de données MEMBER, USERS, USERREG, MBRREL, USERPROF, BUSPROF, USERDEMO et ADRESSE.

Utilisez cette URL avec SSL (Secure Sockets Layer) pour garantir le chiffrement des informations de l'utilisateur. 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

URL
Obligatoire : Adresse URL à appeler une fois que la commande a abouti.
logonId
Obligatoire : ID de connexion de la personne inscrite.
logonPassword
Obligatoire : Mot de passe de la personne inscrite. En mode base de données, le mot de passe est chiffré avant d'être enregistré dans la base de données. En mode LDAP, le mot de passe n'est stocké que sur le serveur LDAP.
logonPasswordVerify
Obligatoire si le mot de passe de connexion est utilisé : Mot de passe de la personne inscrite, entré une deuxième fois.
parentMember
Requis lors de l'inscription d'un nouvel utilisateur ; non autorisé lors de la mise à jour d'un utilisateur : ID de membre de l'organisation mère ou de l'unité organisationnelle mise à jour ; il s'agit d'une clé de référence externe à la table MEMBER. Si parentMember est nul, définissez-le sur l'organisation par défaut (DN). Si parentMember n'est pas nul, il peut adopter deux types de valeurs différents :
  • orgEntityId chiffré (à l'aide de "wcs_encrypt orgentityId>"
  • DN d'orgEntity (par exemple "o=Default Organization, o=Root
preferredCurrency
La devise préférée de la personne inscrite pour les transactions ; une clé externe qui référence la colonne SETCCURR de la table SETCURR.
preferredLanguage
Langue préférée de la personne inscrite ; clé externe qui référence la colonne LANGUAGE_ID de la table LANGUAGE.
userField1 à userField3
Zones personnalisables .
challengeQuestion
Question pour confirmer verbalement l'identité du client.
challengeAnswer
Réponse à la question de confirmation d'identité.
description
Description de la personne inscrite.
userProfileField1 et userProfileField2
Zones personnalisables .
photo
URL ou chemin d'accès à une photo de la personne inscrite.
preferredCommunication
Le téléphone préféré de la personne inscrite (stocké dans la table ADDRESS), par exemple : P1=phone 1 P2=phone 2
preferredDelivery
Mode de livraison préféré de la personne inscrite.
preferredMeasure
Unité de mesure préférée de la personne inscrite.
taxPayerId
Chaîne utilisée pour identifier l'utilisateur pour la fiscalité, particulièrement utile avec les logiciels fiscaux.
alternateId
ID spécial attribué par l'organisation commerciale ou l'unité organisationnelle dont fait partie cette personne inscrite spécifique.
departmentNumber
Identificateur de département de la personne inscrite.
employeeId
ID de la personne inscrite auprès de son employeur.
employeeType
Statut d'employé de la personne inscrite (par exemple, régulier, permanent, entrepreneur ou à temps partiel).
manager
Nom du gestionnaire de la personne inscrite.
organizationId
Identificateur d'entreprise de la personne inscrite ; clé externe de la table ORGENTITY.
organizationUnitId
Identificateur de l'unité organisationnelle de la personne inscrite ; clé externe de la table ORGENTITY.
secretary
Nom du secrétaire de la personne inscrite.
age
Age de la personne inscrite.
children
Nombre d'enfants de la personne inscrite.
companyName
Nom d'entreprise de l'organisation que représente la personne inscrite, obtenu lors du remplissage des informations démographiques.
demographicField1 à demographicField4
Champs personnalisables des informations démographiques ; il s'agit de champs mono-caractères.
demographicField5
Champ personnalisable des informations démographiques ; champ de 254 caractères.
demographicField6
Champ personnalisable des informations démographiques ; champ d'entier.
demographicField7
Champ personnalisable des informations démographiques ; champ varchar, longueur 64.
gender
Sexe de la personne inscrite.
hobbies
Loisirs de la personne inscrite.
household
Nombre de personnes dans le ménage de la personne inscrite ; la valeur par défaut est 1.
income
Revenu annuel de la personne inscrite.
incomeCurrency
Devise dans laquelle le revenu de la personne inscrite est payé.
maritalStatus
Statut familial de la personne inscrite.
orderBefore
Si la personne inscrite a déjà passé une commande. Cette valeur est fournie par la personne inscrite.
timeZone
Fuseau horaire dans lequel la personne inscrite fait des affaires (reporter comme GMT +/- heures).
address1 à address3
L'adresse (nom et numéro de rue) de la personne inscrite, jusqu'à un maximum de trois lignes d'information.
addressField1 à addressField3
Zones personnalisables .
addressType
Type d'adresse, les valeurs valides sont configurables à l'aide d'un fichier de propriétés : S (expédition), B (facturation) et SB (expédition et facturation). Une seule adresse peut avoir différents types. Si le fichier de propriétés est introuvable, une valeur par défaut SB sera utilisée.
bestCallingTime
  • D=Indicateur signifiant que la journée est le meilleur moment pour appeler la personne inscrite.
  • E=Indicateur signifiant que la soirée est le meilleur moment pour appeler la personne inscrite.
billingCode
Code de l'organisation de la personne inscrite pour 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.
city
Nom de la ville où réside la personne inscrite.
country
Nom du pays ou de la région où réside la personne inscrite.
email1
Adresse électronique ou adresse Web principale de la personne inscrite.
email2
Adresse électronique ou adresse Web secondaire de la personne inscrite.
fax1
Numéro de fac-similé principal de la personne inscrite.
fax2
Numéro de fac-similé secondaire de la personne inscrite.
firstName
Prénom de la personne inscrite.
lastName
Requis si le mode d'authentification est LDAP : Nom de famille de la personne inscrite. Si le mode d'authentification est LDAP, ce paramètre est obligatoire.
middleName
Deuxième prénom de la personne inscrite.
officeAddress
Adresse interne (par exemple, arrêt de messagerie).
organizationName
Nom de l'organisation que représente la personne inscrite.
organizationUnitName
Nom de l'unité au sein de l'organisation que représente la personne inscrite.
packageSuppression
  • 1=Indicateur pour inclure les encarts de package lorsque la commande est expédiée
  • 0=Indicateur pour ne pas inclure les encarts de package lorsque la commande est expédiée. Il n'y a pas de valeur par défaut pour ce champ. Si le champ n'est pas utilisé, il reste nul dans la base de données.
personTitle
Le titre de l'utilisateur dont l'adresse est saisie (par exemple, Dr., Rev., M. ou Mme.).
phone1
Numéro de téléphone principal de la personne inscrite.
phone1Type
Type de téléphone utilisé au numéro principal de la personne inscrite ; 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.
phone2
Deuxième numéro de téléphone de la personne inscrite.
phone2Type
Type de téléphone utilisé au numéro secondaire de la personne inscrite ; 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
  • 1=Indicateur signifiant que le numéro de téléphone principal de la personne inscrite est répertorié
  • 0=Indicateur signifiant que le numéro de téléphone principal de la personne inscrite n'est pas répertorié Il n'y a pas de valeur par défaut pour ces champs publishPhone. Si le champ n'est pas utilisé, il reste nul dans la base de données.
publishPhone2
  • 1=Indicateur signifiant que le numéro de téléphone secondaire de la personne inscrite est répertorié
  • 0=Indicateur signifiant que le numéro de téléphone secondaire de la personne inscrite n'est pas répertorié
shippingGeoCode
Code d'expédition basé sur la région géographique, particulièrement utile avec les logiciels fiscaux.
état
Nom du pays, de la province ou équivalent où réside la personne inscrite.
taxGeoCode
Code fiscal basé sur la région géographique, particulièrement utile avec les logiciels fiscaux.
zipCode
Code postal de l'adresse de la personne inscrite.
Attributs de membre personnalisés
Vous pouvez définir des attributs ou paramètres de membre personnalisés dans cette commande. Ces attributs de membre personnalisés peuvent être ajoutés, supprimés ou modifiés. La syntaxe des paramètres personnalisés est & attributeName_storeName _ action _ number=value

Où :

attributeName
Nom de l'attribut ou paramètre personnalisé que vous avez défini.
storeName
Nom du magasin auquel l'attributeName s'applique.
action
Spécifie si l'attributeName peut être remplacé (auquel cas, spécifiez r) ou supprimé (dans ce cas, spécifiez d).
number
Dans le cas des noms d'attribut à plusieurs valeurs, spécifiez ce paramètre pour affecter plusieurs entrées avec un(e) même attributeName, storeName ou action.
valeur
Valeur que vous souhaitez attribuer à l'attribut.

Voici des exemples de syntaxe pour les attributs ou les paramètres des clients :

  • L'exemple suivant met à jour la base de données avec la valeur rouge pour un attribut client de couleur préférée de l'utilisateur défini dans le magasin 10001 : &favoritecolor_10001_r_1=red
  • L'exemple suivant met à jour deux attributs de la base de données : dans le magasin 10001, la couleur préférée de l'utilisateur est le rouge, et si dans le magasin 10002, la couleur préférée de l'utilisateur est le bleu : &favoritecolor_10001_r_1=red&favoritecolor_10002_r_1=blue
  • L'exemple suivant supprime un attribut du magasin 10001 : &favoritecolor_10001_d_1=red

Exemple 1

L'exemple suivant met à jour un utilisateur inscrit pour modifier son mot de passe de connexion.

https://myhostname/webapp/wcs/stores/servlet/BuyerUserRegistrationUpdate?logonPassword=pass &logonPasswordVerify=pass&URL=MallFrontView

Exemple 2

L'exemple suivant enregistre un utilisateur B2C :

https://myhostname/webapp/wcs/stores/servlet/BuyerUserRegistrationUpdate?logonId=user1 &logonPassword=pass&logonPasswordVerify=pass&URL=MallFrontView

Exemple 3

L'exemple suivant enregistre un utilisateur B2B dans l'organisation par défaut en spécifiant l'orgEntityId chiffré comme valeur pour le paramètre parentMember :

https://myhostname/webapp/wcs/stores/servlet/BuyerUserRegistrationUpdate?logonId=b2buser2 &logonPassword=pass&logonPasswordVerify=pass&profileType=B &parentMember=fpqG/Uw9Pdw=&URL=MallFrontView

Comportement

  • Notez que le membre parent et le type de profil de l'utilisateur ne peuvent pas être modifiés.
  • Appelle une instruction de tâche vide appelée PreUserRegistrationAddCmd. Les développeurs de magasins peuvent la remplacer pour modifier l'entrée de la commande.
  • Met à jour l'enregistrement de l'utilisateur inscrit actuel dans la table USERS.
  • Si le mode d'authentification est "LDAP", les informations utilisateur peuvent également être mises à jour sur le serveur LDAP.
  • Si le mode d'authentification est "LDAP", l'ID de connexion ne peut pas être modifié.
  • Si un ou plusieurs champs liés aux tables USERPROF, BUSPROF ou USERDEMO sont spécifiés, met à jour chacune de ces tables. S'il n'y a pas d'enregistrement, crée un nouvel enregistrement dans ces tables.
  • Si un ou plusieurs champs liés à la table ADDRESS sont spécifiés, une adresse perso (également appelée adresse d'inscription, avec le champ selfAddress défini sur "1" et l'alias identique à l'ID de connexion) sera également mise à jour. L'ancienne adresse sera marquée comme "T" (temporaire) et un nouvel enregistrement sera créé dans la table ADDRESS. Si cet utilisateur n'a pas d'adresse perso, une nouvelle adresse perso sera créée.
  • Si le mot de passe de connexion a été modifié, appelle l'instruction de tâche AuthenticationPolicyCmd pour vérifier ou mettre à jour les informations d'identification d'un utilisateur.
  • Vérifie les paramètres d'information d'inscription requis.
  • Appelle l'instruction de tâche AuditUserRegistrationCmd pour vérifier des paramètres supplémentaires. Les développeurs de magasins doivent ajouter un nouveau code à l'instruction de tâche AuditUserRegistrationCmd s'ils souhaitent personnaliser la vérification.
  • Appelle l'instruction de tâche SetCurrencyPrefCmd pour définir la devise préférée sur le contexte de commande.
  • Lorsque LDAP est utilisé, l'utilisateur est créé dans la base de données et sur le serveur LDAP. Les informations d'authentification sont stockées uniquement dans la base de données, mais toutes les autres informations sont répliquées dans la base de données.
  • Appelle une instruction de tâche vide appelée PostUserRegistrationAddCmd. Les développeurs de magasins peuvent la remplacer pour effectuer des opérations supplémentaires.
  • Si l'instruction échoue, l'instruction de visualisation UserRegistrationErrorView est appelée. Si l'exécution de la commande s'achève normalement, l'URL spécifiée est appelée.
  • Lorsque l'utilisateur est créé à l'aide de cette commande, le système attribue des rôles en fonction du fichier MemberRegistrationAttributes.xml. Lors du choix des rôles à attribuer, le système utilise les informations suivantes : le type d'inscription de "UserRegistration", l'arborescence ancêtre membre pour l'utilisateur et le magasin dans lequel l'utilisateur s'inscrit.

Conditions d'exception

  • Si un paramètre d'URL est nul, le système émet une exception accompagnée de la clé de message _ERR_CMD_MISSING_PARAM.
  • Si la longueur de la valeur du paramètre URL est égale à 0, le système lance une exception avec la clé de message _ERR_CMD_INVALID_PARAM.
  • Si le paramètre logonId n'est pas nul, mais que la longueur est égale à 0, le système lance une exception avec la clé de message _ERR_CMD_INVALID_PARAM.
  • En mode LDAP, si le logonId n'est pas nul, le système lance une exception avec la clé de message _ERR_CMD_INVALID_PARAM.
  • Si la longueur de la valeur du paramètre logonPassword n'est pas nulle et équivaut à 0 ou est supérieure à 70, le système lance une exception avec la clé de message _ERR_CMD_INVALID_PARAM.
  • Si logonPassword n'est pas nul mais que logonPasswordVerify est nul, le système lance une exception avec la clé de message _ERR_CMD_MISSING_PARAM.
  • Si logonPassword n'est pas nul et qu'il n'est pas égal à logonPasswordVerify, le système lance une exception avec la clé de message EC_UREG_ERR_PASSWORDS_NOT_SAME.
  • Si la valeur preferredCurrency n'est pas nulle et qu'il ne s'agit pas d'un ensemble de clés externes sur la table SETCCURR, le système lance une exception avec la clé de message _ERR_CMD_INVALID_PARAM.
  • Si la valeur preferredLanguage n'est pas nulle et qu'il ne s'agit pas d'un ensemble de clés externes sur la table LANGUAGE, le système lance une exception avec la clé de message _ERR_CMD_INVALID_PARAM.
  • Si l'un des paramètres suivants : age, income, children, household, demographicField6, publishPhone1, publishPhone2, ou packageSuppression n'est pas nul et n'est pas un entier, le système lance une exception avec la clé de message _ERR_CMD_INVALID_PARAM.