Users file format
Each row in the users.csv file should contain:
Name | Data Type | Optional | Description |
---|---|---|---|
UUID | String | No | The record’s universal unique identifier |
Username | String | No | Login or user ID |
String | Yes | Email address (primary) | |
Description | String | Yes | Description |
UUID | String | Yes | UUID of the current user’s manager |
memberOf | List of UUID | Yes | UUIDs of which this group is a member (can be empty) |
Zero or more “additional attributes” fields | String | Yes | See “Additional Attributes” below |
User records can also have additional attributes in the form of name value pairs. Some of these attributes have predefined names (see below). A file containing an additional attribute should be defined as a regular expression of the following format:
[aA][tT][tT][rR]:(.+)/=/(.+)
Any name can be used for custom attributes. The attributes are stored as an associated array on the user object, and are used only for display. Examples include:
- wbsn_proxy_address - secondary (alternative) email address
- wbsn_nt_domain\wbsn_login_name - the user login name (principal name on Windows-based systems)
- wbsn_full_name - the user’s display name
- wbsn_department - department
- wbsn_telephone_number - the user’s telephone number
- wbsn_title - the user’s title
- wbsn_mailbox_store - the server on which the user’s Exchange mailbox is stored The table below illustrates some attributes:
String | Name | Value |
---|---|---|
attr:wbsn_title/=/Manager | wbsn_title | Manager |
aTTr:my amazing attr/=/the value | my amazing attr | the value |
“ATTR:name/=/value1,value2” | name | value1,value2 |
For example:
6278ab76-2ce2-4f16-8e49-aa5104da7d0b, jdoe-mgr, jdoe.manager@example.com,CEO,7c9d4db6-1737-4b80-9e6e- 42f415300a05,attr:room/=/201,attr:parkingSpace/=/1
ff255105-4e43-4e9a-b2bd-e366872cd212, jdoe, jdoe@example.com, administrator,
6278ab76-2ce2-4f16-8e49- aa5104da7d0b,"08b3b46b-3631-46cb-adc7-176c2871e94c;7c9d4db6- 1737-4b80-9e6e-42f415300a05",attr:room/=/101