As of CurrentWare v10.0.2, the User Import via Text File feature allows administrators to bulk add users by uploading a structured text file containing user details. This is ideal for quickly onboarding large groups of users without manually entering individual data. The file includes key fields like username and group which are mapped during the import process. This method streamlines the setup of user accounts and ensures accuracy, especially when dealing with extensive user lists that cannot be imported via AD importing.
NOTE: Please be aware that the Active Directory (AD) Sync take priority over user imports. Users that exist will be moved the appropriate groups based on your AD. Users and groups that do not exist in the AD will be moved to the [Non-AD] group.
How to prepare the text(.txt) document to import users
1. Open a new text(.txt) file.
2. Structure the users and groups/subgroups as following:
username,group
johndoe,[Admins]
david,[Users]
janedoe,[Editors[Content]]
alice,[Users[Regular]]
eve,[Editors[Content[Images]]]
frank,[Users[Regular[Verified]]]
Here is an in-depth explanation of the structure:
- username: This column contains the usernames of the users to be imported.
- group: This column contains the group information in a nested bracket format to indicate the hierarchy of groups and subgroups. The outermost brackets represent the primary group, inner brackets represent subgroups, and further nested brackets represent sub-subgroups.
Explanation of the Examples
- No Subgroups:
johndoe
is in the group Admins
.
david
is in the group Users
.
- 1 Level of Subgroups:
janedoe
is in the group Editors
with a subgroup Content
.
alice
is in the group Users
with a subgroup Regular
.
- 2 Levels of Subgroups:
eve
is in the group Editors
with a subgroup Content
and a sub-subgroup Images
.
frank
is in the group Users
with a subgroup Regular
and a sub-subgroup Verified
.
Troubleshooting
What happens to a line in the text file with no end bracket for the group (incorrect formatting)?
Here is an example of a typo
missing end bracket: johndoe[admins
Due to the [admins part of the username & group Johndoe will be added to the default user group with the name johndoe[admins
What happens if I miss a child group in my group structure?
Here you can see the group structure to import the "Divine" user into the [Verified] (3) group would be divine,[Design[Regular[Verified]]].
If you miss the [Regular] group and try to import the Divine user, they will instead be placed in the Parent folder [Design] (1).