Values and Definitions for Importing Users

When you create a CSV (comma-separated value) file for importing users, place the values for each user on a single line in the following format. Values are defined in the table below.

<Username>,<password>[,[<plan>],[<firstname>],[<middlename>],[<lastname>],[<true/false/1/0/yes/no>],[Info@Acme.com],[+64 21 555 2624],[<description>],[<true/false/1/0/yes/no>]]

Note: When you enter values, do not enter the brackets; they are for display purposes only. Angle brackets, <>, indicate the value name to be replaced; square brackets, [], indicate optional values. There are 11 possible values for each user. However, only the first two are required.

CSV File Example

The following is the text of a CSV (comma-separated value) file used to import users:

User1,pwd

User2,pwd,plan1

User3,pwd,,firstname,,lastname,true,,,user 3 description,true

User4,pwd,plan2,,,,,,,,false

If you do not want to supply an optional value, you still need to type a comma for that value unless it is the last value entered.

If the CSV file above is imported, the following four user accounts are created:

• User1 has "User1" as the account name and "pwd" as the password. No additional information is provided for the user, and no services are enabled. The following defaults are also used: the user does not have access to the site control panel, and the account is enabled.
• User2 has "User2" as the account name and "pwd" as the password. Services available through plan1 are enabled for the user. The following defaults are also used: the user does not have access to the site control panel, and the account is enabled.
• User3 has "User1" as the account name and "pwd" as the password. No services are enabled for the user, since no plan or template is specified, but some additional information about the user is provided. The user has access to the site control panel, and the account is enabled.
• User4 has "User1" as the account name and "pwd" as the password. Services available through plan2 are enabled for the user. The user does not have access to the site control panel, and the account itself, including access to services enabled under plan2, is disabled.

Values

There are 11 possible values, each of which is described below.

Explanation of Values
Value Name	Required/ Optional	Description	Valid Input
1. Username	Required	A name that identifies the user. The user types this name, followed by your domain name when logging in to the control panel. The username and your domain name are also the user's email address at your site.	Up to 15 alphanumeric characters; no spaces allowed
2. Password	Depends upon the system password policy set on the server. Please contact your service provider for details.	A password the user types to access the control panel.	Password requirements The minimum length and complexity of passwords depend upon the system password policy set on the server. Please contact your service provider for these details. If specified, passwords are case sensitive, cannot contain spaces, and can be up to 47 characters in length. To increase security, passwords should contain both alphabetical and numerical characters. Allowed characters include: a-z A-Z 0-9 , . - _ / + $ : % @ \ = ? !
3. Plan name	Required	The user template you want to use to enable services for the user.	The name of a valid enabled user template
4. Firstname	Optional	The user's first name.	Any input is valid
5. Middlename	Optional	The user's middle name.	Any input is valid
6. Lastname	Optional	The user's last name.	Any input is valid
7. Admin?	Optional	Whether the user is allowed to log in to the site control panel.	TRUE, 1, FALSE, 0, empty TRUE: the user can log in to the site control panel in addition to the User Administrator control panel. 1: Same as True FALSE: the user can log in only to the User Administrator control panel. 0: Same as False. Empty (no input): Same as False. The user can log in only to the User Administrator control panel.
8. Email	Optional	An email address at which the user can be contacted. This address is external to the user account you are adding.	A valid email address
9. Phone	Optional	A telephone number at which the user can be contacted.	Any phone number format is valid
10. Description	Optional	Any additional information you want to provide about the user.	Any input is valid
11. Enabled?	Optional	Whether control panel access is enabled or disabled.	TRUE, 1, FALSE, 0 empty TRUE: the user can log in to the control panel and use any services enabled through the template. 1: Same as True FALSE: the user cannot log in to the control panel or use services. 0: Same as False. Empty (no input): Same as True. The account is enabled by default.