Import file format

You can create repository users from information contained in an input file.

Each imported user starts with the header object_type:dm_user. Follow the header with a list of attribute_name:attribute_value pairs. The attributes user_name and user_os_name are required. In addition, the following default values are assigned when the LDIF file is imported:

Table 4.5. Default values for new users

ArgumentDefault

user_login_name

username

privileges

0 (None)

folder

/username

group

docu

client_capability

1

Each attribute_name:attribute_value pair must be on a new line. For example:

object_type:dm_user
user_name:Pat Smith
user_group:accounting
acl_domain:smith
acl_name:Global User Default ACL
object_type:dm_user
user_name:John Brown

If the ldif file contains umlauts, accent marks, or other extended characters, store the file as a UTF-8 file, or users whose names contain the extended characters are not imported.

The attributes you can set through the LDIF file are:

user_name
user_os_name
user_os_domain
user_login_name
user_login_domain 
user_password
user_address
user_db_name
user_group_name
user_privileges (set to integer value)
default_folder
user_db_name
description
acl_domain
acl_name
user_source (set to integer value)
home_docbase
user_state (set to integer value)
client_capability (set to integer value)
globally_managed (set to T or F)
alias_set_id (set to an object ID)
workflow_disabled (set to T or F)
user_xprivileges (set to integer value)
failed_auth_attempt (set to integer value)

You can specify as many of the attributes as you wish, but the attribute_names must match the actual attributes of the type.

The attributes may be included in any order after the first line (object_type:dm_user). The Boolean attributes are specified using T (for true) or F (for false). Use of true, false, 1, or 0 is deprecated.

Any ACLs that you identify by acl_domain and acl_name must exist before you run the file to import the users. Additionally, the ACLs must represent system ACLs. They cannot represent private ACLs.

Any groups that you identify by user_group_name must exist before you run the file to import the users.

Content Server creates the default folder for each user if it does not already exist.