URL UserRegistrationUpdate

Cette URL met à jour l'enregistrement d'inscription d'un utilisateur inscrit. Pour exécuter cette URL, l'utilisateur doit d'abord se connecter au système HCL Commerce en tant qu'utilisateur inscrit. Si l'utilisateur actuel est un client invité, cette commande appelle la commande UserRegistrationAdd pour inscrire un nouvel utilisateur. Les informations relatives aux utilisateurs sont stockées dans les tables de base de données MEMBER, USERS, USERREG, ADRESSE, ADDRBOOK, 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

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.

logonId

ID de connexion de la personne inscrite.

Si vous utilisez LDAP, la modification de l'ID de connexion d'un utilisateur n'est pas prise en charge car elle nécessiterait de supprimer et de recréer l'utilisateur dans LDAP. Ce processus entraînerait la perte de tous les attributs utilisateur n'appartenant pas à HCL Commerce, tels que le mot de passe.

Si vous n'utilisez pas LDAP, il n'est pas recommandé de modifier l'ID de connexion de l'utilisateur, car le sous-système de promotion stocke l'ID de connexion du créateur de la promotion dans la colonne XMLPARAM de la table PX_PROMOTION.

Remarque : Lorsque la commande UserRegistrationUpdate est utilisée pour modifier le logonID, la commande met automatiquement à jour la colonne de base de données USERS.DN. Ne partez pas du principe que ADDRESS.NICKNAME va également changer. A la place, le paramètre de recherche suivant doit être utilisé pour obtenir l'adresse perso unique d'un utilisateur : AddressAccessBean.findSelfAddressByMember(Long memberID).

logonPassword

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.

Le paramètre logonPassword est obsolète dans HCL Commerce Version 9.1. La fonctionnalité de ce paramètre a été remplacée par la commande ResetPassword. Pour plus d'informations, voir URL ResetPassword.

logonPasswordVerify

Obligatoire si le mot de passe de connexion est utilisé : Mot de passe de la personne inscrite, entré une deuxième fois.

Le paramètre logonPasswordVerify est obsolète dans HCL Commerce Version 9.1. La fonctionnalité de ce paramètre a été remplacée par la commande ResetPassword. Pour plus d'informations, voir URL ResetPassword.

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, userField2, 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, 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 ADRESSE), 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.

dateOfBirth

Date de naissance. Le format est jj-mm-aaaa, par exemple : 01-01-1980.

demographicField1, demographicField2, demographicField3, 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 (rapporter comme GMT +/- heures).

address1, address2, address3

L'adresse (nom et numéro de rue) de la personne inscrite, jusqu'à un maximum de trois lignes d'information.

addressField1, addressField2, addressField3

Zones personnalisables .

addressType

L'utilisation de l'adresse. Les valeurs admises sont les suivantes :

S

expédition

B

facturation

SB

expédition et facturation (valeur par défaut).

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.

Remarque : Par défaut, elle n'est pas utilisée pour les notifications au membre.

outAddressName

Détermine si la personne inscrite souhaite recevoir des activités de courrier électronique pour le magasin actuel (ou tous les magasins si aucun magasin n'a été visité au cours de la session) :

true

L'utilisateur souhaite recevoir des activités de courrier électronique marketing.

false

L'utilisateur ne souhaite pas recevoir d'activités de courrier électronique (par défaut).

receiveSMS

Spécifie si la personne inscrite souhaite recevoir des messages SMS marketing pour le magasin actuel (ou tous les magasins si aucun magasin n'a été visité pendant la session). Les valeurs valides sont true ou false (par défaut).

receiveSMSNotification

Indique si l'utilisateur souhaite recevoir des messages de notification de commande par SMS. Les valeurs valides sont true ou false (par défaut).

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 notices lorsque la commande est expédiée.

0

Indicateur pour ne pas inclure les notices lorsque la commande est expédiée

Aucune valeur par défaut n'est indiquée dans 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é

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 mobile de l'inscrit, par exemple CA pour le Canada.

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 gérer les attributs de membres personnalisés (table MBRATTRVAL) pour cet utilisateur à l'aide de la syntaxe suivante : &attributeName_storeId_action_number=value

Où :

attributeName

Nom de l'attribut personnalisé qui a déjà été défini dans la colonne NAME de la table MBRATTR.

storeId

ID de magasin du magasin auquel attributeName s'applique. Spécifiez "null" si l'attribut n'est pas spécifique au magasin.

action

Spécifie l'action à effectuer avec la valeur :

a

ajouter la valeur

P

remplacer la valeur

j

supprimer la valeur

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, storeId ou action.

valeur

Valeur que vous souhaitez attribuer à l'attribut.

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

• 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

• Met à jour deux attributs : Dans le magasin 10001, la couleur préférée de l'utilisateur est le rouge, et 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

• Supprime un attribut du magasin 10001 :

  &favoritecolor_10001_d_1=red

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 PreUserRegistrationUpdateCmd. 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, l'adresse perso (également appelée adresse d'inscription, avec le champ selfAddress défini sur "1") 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 autonome 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 PostUserRegistrationUpdateCmd. 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 null 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 SETCURR, 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.