Date: Fri, 29 Mar 2024 12:03:13 +0000 (UTC) Message-ID: <2135208164.1.1711713793870@9613dfc57026> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_0_2051319186.1711713793853" ------=_Part_0_2051319186.1711713793853 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
You can create many Managed Users quickly by uploading a CSV file that c= ontains their details.
This feature can only create Managed Users (not Independent Users).
To start, click the button "Batch Create Users" in= the Users page.
Here's an example of a valid CSV file:
Name |
|
Password |
Age |
Maturity |
Group |
# Remarks |
---|---|---|---|---|---|---|
# Staff |
|
|
|
|
|
|
Albus Dumbledore |
|
|
18+ |
|
Admins |
The headmaster |
Minerva McGonagall |
minerva@hogwarts.edu |
|
18+ |
|
Teachers |
|
Severus Snape |
|
theprince |
18+ |
|
Teachers |
|
Rubeus Hagrid |
|
|
18+ |
|
|
|
|
|
|
|
|
|
|
# Students |
|
|
|
|
|
|
Harry Potter |
|
|
<13 |
General |
Gryffindor |
|
Cedric Diggory |
|
|
13-16 |
|
Hufflepuff |
|
Luna Lovegood |
|
|
<13 |
|
Ravenclaw |
|
Draco Malfoy |
|
|
<13 |
General |
Slytherin |
|
Blank lines and comments (lines that begin with the character = #) are ignored. So the lines "# Staff" and "# Students" ar= e ignored.
The first line (that isn't a comment) contains the hea= dings, which are the names of the fields that you want to use. In = this example, the headings are: "Name", "Email", etc. We support many field= s, but most of them are optional, so the headings let us know which fields = you're actually using.
Headings that begin with the comment character # are ig= nored: that's why we ignore the column "# Remarks". You might want to inclu= de such columns for your own use.
The lines after the headings contain users: one user per line. You may l= eave any of the non-required fields blank.
Note: for simplicity, we've shown the CSV file as a&nbs= p;table. Most people use a spreadsheet program such as Exc= el to write CSV files, so this table matches what you will see on-screen. H= ere's what the actual CSV file looks like (if you open it = in a simple text editor instead of in a spreadsheet program):
Name,Em= ail,Password,Age,Maturity,Group,# Remarks # Staff,,,,,, Albus Dumbledore,,,18+,,Admins,The headmaster Minerva McGonagall,minerva@hogwarts.edu,,18+,,Teachers, Severus Snape,,theprince,18+,,Teachers, Rubeus Hagrid,,,18+,,, ,,,,,, # Students,,,,,, Harry Potter,,,<13,General,Gryffindor, Cedric Diggory,,,13-16,,Hufflepuff, Luna Lovegood,,,<13,,Ravenclaw, Draco Malfoy,,,<13,General,Slytherin,
Name - the name of the user
First Name, Last Name - alternatively, instead of "Name= " you can choose to use the two fields "First Name" and "Last Name"
Age - the user's age range. The possible values are:
<13
13-16
16-18
18+ (or 18)
Email - the user's email. Managed Users aren't required= to have an email, so you can leave this blank. We don't attempt to verify = the email address, so make sure it's correct.
Password - the user's password. If you omit this then t= he server will choose a random password (which will be provided to you; thi= s is described later).
Valid passwords must contain 8-16 characters
Maturity - the Maturity Rating of the user. If it's omi= tted then the default maturity rating for the user's age will be used. The = possible values are:
General
Moderate
Adult
Group - a User Group that the user will automatically j= oin. (Only one group can be specified.)
You can choose to specify the name in one of two ways:
One field: Name
Two fields: First Name and Last Name<= /strong>
You should use whichever method is easier for you.
Every user needs an OpenSim Avatar Name. We will automa= tically convert the name that you supply into an OpenSim name. However, you= should be aware that OpenSim has strict limitations on avatar names:<= /p>
They must contain exactly two parts, a First Name and a Last Name
They can only use English characters, digits, and a few punctuation char= acters
They must be unique in all of Kitely
Therefore, if the user name is already in use in OpenSim then we will au= tomatically create a unique name by adding a suffix. For example:
John Smith
John Smith_2
John Smith_3
etc.
Sometimes we won't be able to generate an OpenSim Avatar Name despite ou= r best efforts. For example, this can happen if you supply a name that uses= non-Latin characters, e.g. a name in Greek. In such cases we won't create = the user, and you will get an error message for that user.
Creating users is a slow process, so you will see a progress bar while t= he operation is ongoing. Once it's done, we'll tell you how many users were= created successfully, and how many failed. You will also get a link where = you can download a CSV report that lists all of the users: both those that = succeeded and those that failed. (If you closed the browser before the oper= ation was completed then it will keep running anyway, but you won't get a l= ink to the report. Contact Kitely in that case and we'll provide you with t= he link to download the report.)
For users that were created successfully: the repo= rt contains their Opensim Username (aka Avatar Name) = and Password. You should send this information to you= r users, since this is how they will login in Firestorm.
For users that failed to be created: the report specifi= es the problem that caused them to fail. You should copy-and-paste this par= t of the report to a new CSV file; fix the problems; and then upload the ne= w file to the server in order to retry creating the users.