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 :
- 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.