Befehl 'UserRegistrationAdd'
Dieser Befehl erstellt einen Registrierungsdatensatz für einen Benutzer.
Verwenden Sie diesen Befehl zusammen mit dem
SSL-Protokoll (Secure Sockets Layer), um sicherzustellen, dass
das Anmeldekennwort des Kunden und die persönlichen Daten
verschlüsselt werden. Geben Sie hierzu den Befehl mit dem sicheren HTTPS-Protokoll ein.
Die von diesem Befehl erfassten Registrierungsdaten stammen
aus den folgende Kategorien:
- Berechtigungsdaten
- Geschäft-zu-Konsument-Profil (B2C)
- Geschäft-zu-Geschäft-Profil (B2B)
- Demographische Informationen
B2B ist eine Erweiterung von B2C. Eine registrierende Person, die
ein B2C-Kunde ist, weist normalerweise ein B2C-Profil auf. Eine
registrierende Person, die ein B2B-Kunde ist, weist normalerweise ein
B2C-Profil und ein B2B-Profil auf.
Parameterwerte
- http://host_name/pfad/
-
(Obligatorisch) Der vollständig qualifizierte Name Ihres WebSphere Commerce Servers und der Konfigurationspfad.
- langId
- Setzt die bevorzugte Sprache für die Dauer der Sitzung oder setzt die bevorzugte
Sprache zurück; die unterstützten Sprachen sind in der Tabelle
STORELANG enthalten.
- forUser
- Die Anmelde-ID des Benutzers in dessen Namen der Befehl ausgeführt wird;
nur eine Person mit der Berechtigung, Bestellungen verarbeiten zu können,
kann diesen Parameter angeben.
- forUserId
- Identisch mit "forUser"; hier wird jedoch der Benutzer mit
einer internen Benutzer-ID identifiziert, wie in der Tabelle
USERS angegeben.
- URL
- (Obligatorisch) Die URL-Adresse, die nach der erfolgreichen Ausführung des
Befehls aufgerufen werden soll.
- storeId
- Die Referenznummer des Geschäfts, die diesem Befehl zugeordnet ist.
- logonId
- (Obligatorisch) Die Anmelde-ID des sich registrierenden Benutzers.
- logonPassword
- (Obligatorisch) Das Kennwort der sich registrierenden Person. Das Kennwort
wird vor dem Speichern in der Datenbank vom Befehl
UserRegistrationAdd verschlüsselt.
- logonPasswordVerify
- (Obligatorisch) Das Kennwort der sich registrierenden Person, zum zweiten Mal eingegeben.
- parentMember
- Wenn parentMember gleich null ist, setzen Sie den Parameter auf die
Standardorganisation.
Wenn parentMember nicht null ist,
kann der Parameter zwei verschiedene Arten von Werten annehmen:
Die verschlüsselte orgEntityId (unter Verwendung von
"nc_crypt -e
<orgentityId>")
Den eindeutigen Namen der orgEntity
(z. B. "o=Standardorganisation, o=Root-Organisation")
- userStatus
- Gibt an, ob das Konto der sich registrierenden Person
aktiviert ist:
1=aktiviert (Standardwert)
0=inaktiviert
- passwordExpired
- Gibt an, ob das Kennwort der sich registrierenden Person
abgelaufen ist:
0=nicht abgelaufen (Standardwert)
1=abgelaufen
- challengeQuestion
- Bestätigungsfrage zur verbalen Bestätigung der Identität der
sich registrierenden Person.
- challengeAnswer
- Die Antwort auf die Bestätigungsfrage.
- registerType
- Der Typ des Benutzers:
G=Gastbenutzer, ein Benutzer, der keine
Profilinformationen übergibt.
R=Registrierter Benutzer, ein Benutzer,
der Profilinformationen übergibt.
A=Administrator, ein registrierter Benutzer und gleichzeitig ein
Administrator.
S=Site-Administrator, ein registrierter
Benutzer, der gleichzeitig ein Site-Administrator ist.
- profileType
- Gibt den Typ der Registrierung an:
<Null>= keine Profildaten, nur
Authentifizierungsdaten; Nur Daten für die Tabelle
USERREG.
C=Geschäft-zu-Konsument-Registrierungsprofildaten;
Authentifizierungsdaten und auch Daten für die Tabelle
USERPROF (dies ist der Standardwert)
B=Geschäft-zu-Geschäft-Registrierungsprofildaten;
Authentifizierungsdaten und auch Daten für die Tabelle
BUSPROF
- preferredCurrency
- Die bevorzugte Währung der sich registrierenden Person für
Transaktionen;
dies ist ein Fremdschlüssel, der auf Spalte
SETCURR der Tabelle SETCURR
verweist.
- preferredLanguage
- Die bevorzugte Sprache der sich registrierenden Person;
dies ist ein Fremdschlüssel, der auf die Spalte
LANGUAGE_ID der Tabelle LANGUAGE verweist.
- userField1 bis userField3
- Anpassbare Felder.
- displayName
- Der Name, der zur Anzeige des Namens der sich registrierenden
Person in einer Übersichtsliste verwendet wird.
- photo
- URL oder Pfad für ein Foto der sich registrierenden
Person.
- preferredCommunication
- Das bevorzugte Telefon der sich registrierenden Person
(wird in Tabelle ADDRESS
gespeichert), Beispiel:
P1=Telefon 1
P2=Telefon 2
- preferredDelivery
- Der bevorzugte Zustellungsmodus der sich registrierenden Person.
- preferredMeasure
- Die bevorzugte Maßeinheit der sich registrierenden Person.
- description
- Eine Beschreibung der sich registrierenden Person.
- userProfileField1 und userProfileField2
- Anpassbare Felder.
- organizationId
- Die Kennung des Unternehmens der sich registrierenden
Person; Fremdschlüssel zur Tabelle
ORGENTITY.
- organizationUnitId
- Die Kennung der Organisationseinheit der sich registrierenden
Person; Fremdschlüssel zur Tabelle
ORGENTITY.
- employeeId
- Die Kennung der sich registrierenden Person bei ihrem Arbeitgeber.
- alternateId
- Eine Sonderkennung, die dieser sich
registrierenden Person von ihrer Geschäftsorganisation oder
-einheit zugeordnet wurde.
- employeeType
- Der Status der sich registrierenden Person als Mitarbeiter,
beispielsweise 'Regulär', 'Permanent', 'Fremdfirma' oder
'Teilzeit'.
- departmentNumber
- Die Abteilungskennung der sich registrierenden Person.
- manager
- Der Name des Vorgesetzten der sich registrierenden Person.
- secretary
- Der Name des Sekretärs/der Sekretärin der sich registrierenden Person.
- gender
- Das Geschlecht der sich registrierenden Person.
- age
- Das Alter der sich registrierenden Person.
- income
- Das Jahreseinkommen der sich registrierenden Person.
- incomeCurrency
- Die Währung, in der das Einkommen der sich registrierenden
Person bezahlt wird.
- maritalStatus
- Der Familienstand der sich registrierenden Person.
- children
- Die Anzahl der Kinder der sich registrierenden Person.
- household
- Die Anzahl der Personen im Haushalt der sich registrierenden
Person; Standardwert ist 1.
- companyName
- Der Firmenname der Organisation, die die sich
registrierende Person vertritt; dieser Name wird beim
Ausfüllen der demographischen Informationen abgerufen.
- hobbies
- Die Hobbies und Interessen der sich registrierenden Person.
- orderBefore
- Gibt an, ob die sich registrierende Person bereits zuvor eine Bestellung
aufgegeben hat. Dieser Wert wird von der sich registrierenden Person angegeben.
- timeZone
- Die Zeitzone, in der die sich registrierende Person arbeitet (als GMT +/-
Stunden ausdrücken).
- demographicField1 bis demographicField4
- Anpassbare Felder für demographische Informationen. Dabei
handelt es sich um Felder mit Einzelzeichen.
- demographicField5
- Anpassbares Feld für demographische Informationen. Ein Feld
mit 254 Zeichen.
- demographicField6
- Anpassbares Feld für demographische Informationen. Ein Feld
für ganze Zahlen.
- demographicField7
- Anpassbares Feld für demographische Informationen. Ein Feld
vom Typ varchar, Länge 64.
- personTitle
- Der Titel sich registrierenden Person; z. B. Dr., Herr oder Frau.
- lastName
- (Erforderlich, wenn der Authentifizierungsmodus LDAP ist) Der Nachname der sich
registrierenden Person. Ist der
Authentifizierungsmodus LDAP, ist dieser Parameter obligatorisch.
- firstName
- Der Vorname der sich registrierenden Person.
- middleName
- Der zweite Vorname oder die Initialen der sich registrierenden Person.
- address1
- Die erste Adresszeile der Straßenadresse der sich registrierenden Person.
- address2
- Die zweite Adresszeile der Straßenadresse der sich registrierenden Person.
- address3
- Die dritte Adresszeile der Straßenadresse der sich registrierenden Person.
- city
- Der Name des Orts, an dem die sich registrierende Person ansässig ist.
- state
- Der Name des Bundeslands, Kantons o.ä, an dem die sich registrierende Person ansässig ist.
- zipCode
- Die Postleitzahl für die Adresse sich registrierenden Person.
- country
- Der Name des Landes oder der Region, in in dem/der die sich registrierenden Person ansässig ist.
- phone1
- Die primäre Telefonnummer der sich registrierenden Person.
- phone2
- Die sekundäre Telefonnummer der sich registrierenden Person.
- phone1Type
-
Der Typ des Telefons, das für die primäre Rufnummer der sich registrierenden Person verwendet wird. Beispiel:
TTY für Schwerhörige, PCM für Pulse-Coded-Modulation oder CEL für
Mobilfunk. Dieses Feld enthält 3 Zeichen.
- phone2Type
-
Der Typ des Telefons, das für die sekundäre Rufnummer der sich registrierenden Person verwendet wird. Beispiel:
TTY für Schwerhörige, PCM für Pulse-Coded-Modulation oder CEL für
Mobilfunk. Dieses Feld enthält 3 Zeichen.
- publishPhone1
- 1=Eine Kennung dafür, dass die primäre Telefonnummer der sich registrierenden Person
aufgelistet ist.
- 0=Eine Kennung dafür, dass die primäre Telefonnummer der sich registrierenden Person
nicht aufgelistet ist.
Für diese publishPhone-Felder ist kein Standardwert vorhanden.
Wird dieses Feld leer gelassen, bleibt der Wert in der Datenbank
Null.
- publishPhone2
- 1=Eine Kennung dafür, dass die sekundäre Telefonnummer der sich registrierenden Person
aufgelistet ist.
- 0=Eine Kennung dafür, dass die sekundäre Telefonnummer der sich registrierenden Person
nicht aufgelistet ist.
- bestCallingTime
- D=Eine Kennung, dass tagsüber (Daytime) die bevorzugte Anrufzeit ist.
- E=Eine Kennung, dass abends (Evening) die bevorzugte Anrufzeit ist.
- fax1
- Die primäre Telefaxnummer der sich registrierenden Person.
- fax2
- Die sekundäre Telefaxnummer der sich registrierenden Person.
- email1
- Die primäre E-Mail- oder Web-Adresse der sich registrierenden Person.
- email2
- Die sekundäre E-Mail- oder Web-Adresse der sich registrierenden Person.
- businessTitle
- Die Position der sich registrierenden Person im Unternehmen.
- organizationName
- Der Name der Organisation, die die sich registrierende Person
repräsentiert.
- organizationUnitName
- Der Name der Einheit in der Organisation, die die sich
registrierende Person repräsentiert.
- officeAddress
- Die interne Adresse, z. B. per Post.
- billingCode
- Der Code der Organisation der sich registrierenden Person zur Identifizierung der Versandadresse oder Rechnungsadresse
und des Kostenzentrums.
- billingCodeType
- Code, der die Methode der Codestruktur bestimmt, die für den Rechnungscode
verwendet wird. Der Standardwert ist D (vom Käufer zugeordnet). Der Wert
02 gibt an, dass die Zuordnung über Ariba erfolgt.
- packageSuppression
- 1=Eine Kennung, der gelieferten Bestellung
Werbematerial beizulegen.
- 0=Eine Kennung, der gelieferten Bestellung
kein Werbematerial beizulegen.
Für dieses Feld ist kein Standardwert vorhanden. Wird das Feld leer
gelassen, bleibt der Wert in der Datenbank Null.
- addressfield1 bis addressfield3
- Anpassbare Felder.
- taxPayerId
- Eine Zeichenfolge, die den Benutzer für die Besteuerung
identifiziert, besonders nützlich bei Steuersoftware.
- shippingGeoCode
- Ein Versandcode auf der Basis der
geographischen Region, besonders nützlich bei Steuersoftware.
- taxGeoCode
- Ein Steuercode auf der Basis der geographischen Region,
besonders nützlich bei Steuersoftware.
Beispiel 1
Mit dem folgenden Beispiel wird eine Registrierungsdatensatz für den
Benutzer erstellt (einschließlich sämtlicher für den
Standard-Task-Befehl erforderlichen Parameter), und
anschließend wird der Befehl InterestItemDisplay
aufgerufen:
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
Beispiel 2
Bei diesem Beispiel wird ein Datensatz mit einem
vollständigen Satz von Daten für einen Kunden vom Typ Konsument
ausgefüllt:
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=organizationunit&officeAddress=officeaddress
&billingCode=BillingCode&billingCodeType=BT&packageSuppression=1
&addressField1=field1&addressField2=field2&addressField3=field3
&shippingGeoCode=shippinggeocode&taxGeoCode=taxgeocode
Verhalten
- Aktualisiert die Tabelle USERS
und ändert den Registrierungstyp von
'G' (Gast) in 'R' (registrierter Benutzer).
- Erstellt einen Datensatz in jeder der folgenden Tabellen:
USERREG,
USERPROF,
USERDEMO und
ADDRESS.
Handelt es sich bei diesem Benutzer um einen Geschäftsbenutzer,
(profileType = 'B'), wird darüber hinaus ein Datensatz in der Tabelle
BUSPROF erstellt.
Verfügt dieser Benutzer nicht über ein Adressbuch, wird auch ein
Datensatz in der Tabelle
ADDRBOOK erstellt.
- Erstellt eine Adresse, die als registrierte Adresse bezeichnet
wird, deren Kurzname der angegebenen logonId entspricht.
Das Feld selfAddress dieser Adresse wird auf '1' gesetzt.
- Ist der Parameter profileType nicht angegeben, wird
standardmäßig 'C' (Kunde) gesetzt.
- Ist der Parameter passwordExpired nicht angegeben,
wird er standardmäßig auf 0 (nicht abgelaufen) gesetzt.
- Ist der Parameter userStatus nicht angegeben, wird er
standardmäßig auf 1 (aktiviert) gesetzt.
- Ist der Parameter preferredLanguage nicht gesetzt, wird er aus
dem Befehlskontext abgerufen.
- Prüft die erforderlichen
Registrierungsinformationsparameter.
- Ruft die Task
AuditUserRegistrationCmd
zum Prüfen der zusätzlichen Parameter auf.
Geschäftsentwickler müssen zum Task-Befehl
AuditAddressCmd neuen Code hinzufügen, wenn sie die Prüfung anpassen
möchten.
- Ist der Parameter preferredCurrency nicht Null, werden
SetCurrencyPrefCmd-Tasks
aufgerufen.
- Ist der Authentifizierungsmodus LDAP, wird ein Benutzer auf
dem LDAP-Server erstellt.
Der Kunde wird angemeldet, indem ein digital unterschriebenes
Cookie erstellt wird, das an den Browser zurückgesandt wird, um
die Sitzung des Benutzers zu identifizieren. Der Kunde befindet sich jetzt in einer
authentifizierten Sitzung. Das Cookie enthält die folgenden Informationen:
- Die SESSION_ID
- Eine Markierung, die angibt, ob der Kunde registriert
ist oder nicht.
- Das Datum und die Uhrzeit (Zeitmarke) der
Registrierung des Kunden.
- Eine digitale Kennung
- Ruft den Task-Befehl UserRegistrationRoleAssignCmd zum Zuordnen von Aufgabenbereichen
während der Selbstregistrierung auf. Momentan führt dieser Task-Befehl keine Aktionen aus; er muss
von Kunden außer Kraft gesetzt werden, wenn diese Aufgabenbereiche während der Selbstregistrierung
zuordnen wollen.
- Schlägt die Anmeldung fehl, wird die
UserRegistrationErrorView aufgerufen.
- Nach erfolgreichem Abschluss wird die
angegebene Umleitungs-URL-Adresse aufgerufen.
Ausnahmebedingungen
- Der Parameter URL muss ungleich Null sein und eine Länge größer als 0 haben.
- Der Parameter logonId muss ungleich Null sein und eine Länge
größer als 0 haben.
- Der Parameter logonId darf nicht bereits in der
WebSphere Commerce Suite-Datenbank vorhanden sein. Ist der
Authentifizierungsmodus LDAP, darf
logonId nicht auf LDAP vorhanden sein.
- Der Parameter logonPassword muss ungleich Null sein und
eine Länge größer als 0 und kleiner-gleich 70 haben.
- Der Parameter logonPassword ist identisch mit logonPasswordVerify.
- Der Parameter profileType muss entweder Null oder gleich
'B' oder 'C' sein.
- Die Parameter userStatus und passwordExpired müssen Null oder
gleich 0 oder 1 sein.
- Der Parameter preferredCurrency muss Null sein, oder er muss
ein Fremdschlüssel sein, der auf die Tabelle
SETCCURR gesetzt ist.
- Der Parameter preferredLanguage muss Null sein, oder er muss
ein Fremdschlüssel sein, der auf die Tabelle
LANGUAGE gesetzt ist.
- Die Parameter 'age', 'income', 'children', 'household', 'demographicField6',
'publishPhone1', 'publishPhone2' und 'packageSupression' müssen Null sein oder
sie müssen eine ganze Zahl sein.
- Wenn der Parameter profileType gleich 'B' ist, müssen die folgenden
Bedingungen wahr sein:
- Wenn der Parameter organizationId nicht Null ist, muss er eine
Fremdschlüsselreferenz auf Zeilen sein, deren Typ
O in der Tabelle ORGENTITY
ist.
- Ist der Parameter
organizationUnitId nicht Null, muss organizationUnitId eine Fremdschlüsselreferenz auf Zeilen sein, deren
Typ den Wert OU in der Tabelle ORGENTITY hat.