registerNewUser (NotesRegistration - JavaScript™)

Creates a user ID and optionally adds it to a Domino® Directory.

Defined in

NotesRegistration

Syntax

registerNewUser(lastn:string, idfile:string, server:string) : boolean

registerNewUser(lastn:string, idfile:string, server:string, firstn: String, middle:string, certpw:string) : boolean

registerNewUser(lastn:string, idfile:string, server:string, firstn: String, middle:string, certpw:string, location:string, comment:string, maildbpath: String, forward:string, userpw:string) : boolean

registerNewUser(lastn:string, idfile:string, server:string, firstn: String, middle:string, certpw:string, location:string, comment:string, maildbpath: String, forward:string, userpw:string, altname:string, altnamelang:string) : boolean

Parameter Description
String lastn A last name for the user to be registered.
String idfile The ID file to be created; specify the complete path, for example, c:\notes\data\user.id.
String server The canonical name of the server containing the user's mail file.
String firstn A first name for the user.
String middle A middle initial for the user.
String certpw The password of the certifier ID file.
String location A value for the location field in the Domino® Directory record.
String comment A value for the comment field in the Domino® Directory record.
String maildbpath The path of the user's mail file relative to the mail directory; for example, mail\jones.nsf.
String forward The forwarding domain for the user's mail file.
String userpw A password for the user ID file.
String altname An alternate user name.
String altnamelang The language for the alternate user name. See @Locale in the formula language for a list of language codes.
Return value Description
boolean True if the operation is successful; false otherwise.

Usage

Before calling this method, set CertifierIDFile, Expiration (defaults to 2 years from now), IDType, and MinPasswordLength.
Note: The expiration default is new with Release 6.0.3.

Set UpdateAddressBook true to add a Person record to the Domino® Directory. Set StoreIDInAddressBook true to attach the ID to the Domino® Directory record. These operations can be performed separately with addUserToAddressBook.

Set CreateMailDb to true to create a mail file during registration.

Set OrgUnit to add an organizational unit to the ID name. Optionally set AltOrgUnit and AltOrgUnitLang.

Optionally set IsNorthAmerican and RegistrationLog.

This method acts on the Domino® Directory (names.nsf) for the server specified by RegistrationServer, or names.nsf in the local Domino® data directory if this property is not set.