Instruction UserRegistrationAdd
Cette instruction crée un enregistrement d'inscription pour un utilisateur.
Utilisez cette instruction avec la connexion sécurisée (SSL) pour vous assurer que le mot de passe de connexion de l'utilisateur et les informations personnelles sont codés. A cette fin, entrez l'instruction avec le Protocole de transport hypertexte sécurisé (HTTPS).
Les données d'enregistrement recueillies par cette instruction font partie des catégories suivantes :
- Données d'autorisation
- Profil Entreprise-consommateur (B2C)
- Profil Interentreprises (B2B)
- Informations démographiques
La relation Interentreprises (B2B) est une extension de la relation Entreprise-consommateur (B2C). Un abonné qui est un client B2C aurait normalement un profil B2C. Un abonné qui est un client B2C aurait normalement un profil B2C et B2B.
Valeurs des paramètres
- http://host_name/path/
-
(Obligatoire) Nom qualifié complet et chemin de configuration de WebSphere Commerce Server.
- langId
- Définit ou restaure 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 au nom duquel 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.
- URL
- (Obligatoire) URL devant être lancée lorsque l'instruction aboutit.
- storeId
- Numéro de référence du magasin associé à cette instruction.
- logonId
- (Obligatoire) ID de connexion du déclarant.
- logonPassword
- (Obligatoire) Mot de passe du déclarant. Le mot de passe est crypté par l'instruction UserRegistrationAdd avant d'être sauvegardé dans la base de données.
- logonPasswordVerify
- (Obligatoire) Deuxième saisie du mot de passe du déclarant.
- parentMember
- Si la valeur de parentMember est NULL, définissez-la en Default Organization (Organisation par défaut).
Si la valeur de parentMember n'est pas NULL, elle peut prendre deux types de valeurs :
orgEntityId codé (à l'aide de "nc_crypt -e <orgentityId>")
DN d'orgEntity (par exemple "o=Default Organization, o=Root Organization")
- userStatus
- Indique si le compte du déclarant est activé :
1=activé (paramètre par défaut)
0=désactivé
- passwordExpired
- Indique si le mot de passe de l'inscrit a expiré ou non :
0 = non expiré (paramètre par défaut)
1=a expiré
- challengeQuestion
- Question pour confirmation verbale de l'identité du déclarant.
- challengeAnswer
- Réponse à la demande de confirmation d'identité.
- registerType
- Type d'utilisateur
G=Visiteur, utilisateur visiteur, qui ne fournit aucune information de profil.
R=Utilisateur inscrit, à savoir un utilisateur qui fournit des informations relatives au profil.
A=Administrateur, à savoir un utilisateur à la fois enregistré et administrateur.
S=Administrateur de site, utilisateur enregistré et administrateur de Site.
- profileType
- Indique le type d'enregistrement:
<Null>= pas de données de profilage, uniquement des données d'authentification ; données destinées à la table USERREG uniquement.
C=business-to-consumer registration profile data ; données d'authentification destinées à la table
USERPROF (par défaut).
B=business-to-business registration profile data ; données d'authentification destinées à la table
BUSPROF.
- preferredCurrency
- Devise privilégiée du déclarant ; clé associée qui fait référence à la colonne SETCURR de la table SETCURR.
- preferredLanguage
- Langue privilégiée du déclarant ; clé associée qui fait référence à la colonne LANGUAGE_ID de la table
LANGUAGE.
- userField1 à userField3
- Zones personnalisables.
- displayName
- Nom utilisé lors de l'affichage du nom du déclarant dans une liste récapitulative.
- photo
- URL ou chemin d'accès à une photo du déclarant.
- preferredCommunication
- Numéro de téléphone privilégié pour le déclarant (enregistré dans la table
ADDRESS), par exemple :
P1=phone 1
P2=phone 2
- preferredDelivery
- Mode de livraison privilégie du déclarant.
- preferredMeasure
- Unité de mesure préférée du déclarant.
- description
- Description du déclarant.
- userProfileField1 et userProfileField2
- Zones personnalisables.
- organizationId
- Identificateur de la société du déclarant ; clé associée à la table
ORGENTITY.
- organizationUnitId
- Identificateur du service du déclarant ; clé associée à la table ORGENTITY.
- employeeId
- ID du déclarant vis à vis de son employeur.
- alternateId
- ID spécial affecté par l'entreprise ou le service à ce déclarant particulier.
- employeeType
- Statut du déclarant dans son activité professionnelle (permanent, fournisseur ou à temps partiel, par exemple).
- departmentNumber
- Identificateur du département du déclarant.
- manager
- Nom du responsable du déclarant.
- secretary
- Nom du secrétaire du déclarant.
- gender
- Sexe du déclarant.
- age
- Age du déclarant.
- income
- Revenus annuels du déclarant.
- incomeCurrency
- Devise dans laquelle les revenus du déclarant sont payés.
- maritalStatus
- Situation familiale du déclarant.
- children
- Nombre d'enfants du déclarant.
- household
- Nombre de personnes dans le foyer du déclarant ; la valeur par défaut est 1.
- companyName
- Nom de l'entreprise que le déclarant représente, obtenue lors de la saisie des informations démographiques
- hobbies
- Passe-temps du déclarant.
- orderBefore
- Indique si le déclarant a préalablement passé une commande. Cette valeur est fournie par le déclarant.
- timeZone
- Fuseau horaire dans lequel le déclarant exerce son activité (calculé sous forme d'heures en plus ou en moins par rapport à au temps GMT).
- demographicField1 à demographicField4
- Zones personnalisables pour les informations démographiques ; il s'agit de zones à un seul caractère
- demographicField5
- Zone personnalisable destinée à recevoir des informations démographiques ; 254 caractères
- demographicField6
- Zone personnalisable destinée à recevoir des informations démographiques ; zone entière.
- demographicField7
- Zone à personnaliser destinée à recevoir des informations démographiques ; zone varchar, longueur 64
- personTitle
- Titre du déclarant (Dr., Rev., M. ou Mme., par exemple).
- lastName
- (Obligatoire si le mode d'authentification est LDAP) Nom de famille du déclarant. Si le mode d'authentification est LDAP,
ce paramètre est obligatoire.
- firstName
- Prénom du déclarant.
- middleName
- Deuxième prénom du déclarant.
- address1
- La première ligne de l'adresse du déclarant.
- address2
- La deuxième ligne de l'adresse du déclarant.
- address3
- La troisième ligne de l'adresse du déclarant.
- city
- Ville de résidence du déclarant.
- state
- Département, région, ou leurs équivalents, dans lesquels habite le déclarant.
- zipCode
- Code postal de l'adresse du déclarant.
- country
- Pays ou région du déclarant.
- phone1
- Numéro de téléphone principal du déclarant.
- phone2
- Numéro de téléphone secondaire du déclarant.
- phone1Type
-
Type de téléphone correspondant au numéro de téléphone principal du déclarant, 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.
- phone2Type
-
Type de téléphone correspondant au numéro de téléphone secondaire du déclarant, 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
- 1=Indicateur signifiant que le numéro de téléphone principal du déclarant est répertorié.
- 0=Indicateur signifiant que le numéro de téléphone principal du déclarant n'est pas répertorié.
Ces zones publishPhone n'ont pas de valeurs par défaut. Si la zone n'est pas utilisée, elle reste vide dans la base de données.
- publishPhone2
- 1=Indicateur signifiant que le numéro de téléphone secondaire du déclarant est répertorié.
- 0=Indicateur signifiant que le numéro de téléphone secondaire du déclarant n'est pas répertorié.
- bestCallingTime
- D=Indicateur signifiant qu'il est préférable d'appeler le déclarant dans la journée.
- E=Indicateur signifiant qu'il est préférable d'appeler le déclarant dans la soirée.
- fax1
- Numéro de télécopie principal du déclarant.
- fax2
- Numéro de télécopie secondaire du déclarant.
- email1
- Adresse électronique ou Web principale du déclarant.
- email2
- Adresse électronique ou Web secondaire du déclarant.
- businessTitle
- Position du déclarant dans la société.
- organizationName
- Nom de l'entreprise que le déclarant représente.
- organizationUnitName
- Nom du service de l'entreprise que le déclarant représente.
- officeAddress
- Adresse interne (la boîte postale, par exemple).
- billingCode
- Code de l'entreprise du déclarant, destiné à 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 qu'il est attribué par Ariba.
- packageSuppression
- 1=Indique qu'il convient d'insérer des éléments d'emballage à l'expédition
- 0=Indique qu'il ne faut pas insérer d'éléments d'emballage à l'expédition.
Ces zones n'ont pas de valeurs par défaut. Si la zone n'est pas utilisée, elle reste vide dans la base de données.
- addressfield1 à addressfield3
- Zones personnalisables.
- taxPayerId
- Chaîne utilisée pour identifier l'utilisateur pour l'application des taxes, particulièrement utile pour les logiciels de calcul des taxes.
- shippingGeoCode
- Code de livraison en fonction d'une 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 crée un enregistrement d'inscription pour le client, incluant tous les paramètres requis par l'instruction d'activité par défaut, puis appelle l'instruction InterestItemDisplay :
https://myhostname/webapp/wcs/stores/servlet/UserRegistrationAdd?
&URL=/webapp/wcs/stores/servlet/InterestItemDisplay&logonId=jennyk
&logonPassword=butter&logonPasswordVerify=butter
&lastName=Kohl&Address1=255+Consumers+Road&City=Toronto
&State=Ontario&Country=Canada
Exemple 2
L'exemple suivant alimente un enregistrement avec un ensemble complet de données pour un client de type
consommateur :
https://myhostname/webapp/wcs/stores/servlet/UserRegistrationAdd?storeId=31
&langId=-1&URL=basemall.jsp&logonId=msur1&logonPassword=msur1
&logonPasswordVerify=msur1&userStatus=1&passwordExpired=0
&challengeQuestion=question&challengeAnswer=answer
&profileType=C&preferredCurrency=CAD&preferredLanguage=1
&userField1=field1&userField2=field2&userField3=field3
&displayName=displayname&photo=photo&preferredMeasure=metric
&preferredCommunication=P1&preferredDelivery=preferreddelivery
&description=description&userProfileField1=field1
&userProfileField2=field2&taxPayerId=taxpayerid&gender=M&age=3
&income=3&incomeCurrency=1&maritalStatus=S&children=3
&household=3&companyName=IBM&hobbies=hobbies&orderBefore=Y
&timeZone=EST&demographicField1=1&demographicField2=2
&demographicField3=3&demographicField4=4&demographicField5=5
&demographicField6=6&demographicField7=7&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=msur1@email1.com&email2=msur1@email2.com
&businessTitle=bustitle&organizationName=organization
&organizationUnitName=oraganizationunit&officeAddress=officeaddress
&billingCode=BillingCode&billingCodeType=BT&packageSuppression=1
&addressField1=field1&addressField2=field2&addressField3=field3
&shippingGeoCode=shippinggeocode&taxGeoCode=taxgeocode
Comportement
- Met à jour la table USERS et modifie le type d'enregistrement de 'G' (visiteur) en 'R' (enregistré).
- Crée un enregistrement dans chacune de ces tables : USERREG,
USERPROF, USERDEMO et
ADDRESS.
Si cet utilisateur est une société (profileType = 'B'), un enregistrement est également créé dans la table BUSPROF.
Si cet utilisateur n'a pas de carnet d'adresses, un enregistrement sera également créé dans la table ADDRBOOK.
- Crée une adresse appelée adresse de registre, dont l'alias est le même que le logonId spécifié.
La zone selfAddress de cette adresse sera définie à '1'.
- Si le paramètre profileType n'est pas spécifié, définit 'C' (Customer) par défaut.
- Si passwordExpired n'est pas spécifié, il est défini par défaut à 0 (non expiré).
- Si userStatus n'est pas spécifié, il est défini par défaut à 1 (activé).
- Si preferredLanguage n'est pas défini, le système l'extrait du contexte de l'instruction.
- Vérifie les paramètres d'information d'enregistrement requis.
- Appelle l'activité
AuditUserRegistrationCmd afin de vérifier les paramètres supplémentaires.
Les développeurs de magasin doivent ajouter un nouveau code à l'instruction d'activité AuditAddressCmd pour
personnaliser le contrôle.
- Si le paramètre preferredCurrency n'est pas vide, appelle les activités SetCurrencyPrefCmd.
- Si le mode d'authentification est LDAP, crée un utilisateur sur le serveur LDAP.
Connecte le client en créant un cookie signé numériquement qui est renvoyé au navigateur afin d'identifier la session de
l'utilisateur. Le client a accès à une session authentifiée. Le cookie comporte les
informations suivantes :
- l'ID_SESSION ;
- un indicateur permettant de savoir si le client est
référencé;
- la date et l'heure (horodatage) de l'enregistrement
du
client;
- une signature numérique.
- Appelle l'instruction d'activité UserRegistrationRoleAssignCmd pour affecter des rôles lors de l'enregistrement personnel. Cette instruction d'activité ne sert à rien pour le moment et doit être écrasées par les clients s'ils souhaitent affecter des rôles lors de l'enregistrement personnel.
- Si la connexion échoue, appelle UserRegistrationErrorView.
- Lorsque la connexion aboutit, appelle l'URL de réacheminement spécifiée.
Conditions d'exception
- L'URL de paramètre ne peut pas être nulle et doit avoir une longueur supérieure à 0.
- Le paramètre logonId ne peut pas être nul et doit avoir une longueur supérieure à 0.
- Le paramètre logonId ne peut pas être déjà présent dans la base de données WebSphere Commerce. Si le mode
d'authentification est LDAP, le paramètre logonId ne doit pas être déjà présent sur LDAP.
- Le paramètre logonPassword ne peut être défini par NULL et doit avoir une longueur supérieure à 0 et inférieure ou égale à 70.
- Le paramètre logonPassword est égal à logonPasswordVerify.
- Le paramètre profileType doit être défini par NULL ou être égal à 'B' ou à 'C'.
- Les paramètres userStatus et passwordExpired doivent être définis par NULL ou être égaux à 0 ou 1.
- Le paramètre preferredCurrency doit être défini par NULL ou contenir une clé associée définie sur la table SETCCURR.
- Le paramètre preferredLanguage doit être défini par NULL ou contenir une clé associée définie sur la table LANGUAGE.
- Les paramètres age, income, children, household, demographicField6,
publishPhone1, publishPhone2, et packageSupression doivent être définis par NULL ou contenir un
nombre entier.
- Si le paramètre profileType est 'B', alors les conditions suivantes doivent être vraies :
- Si le paramètre organizationId n'est pas défini par NULL, il doit contenir une référence de clé associée vers des lignes de type 0 dans la table
ORGENTITY.
- Si le paramètre organizationUnitId n'est pas défini par NULL, il doit contenir une
référence de clé associée vers des lignes de type OU dans la table ORGENTITY.