Uploading users and groups using Ant

You must upload users and groups to the Decision Center database.

You can use the Administration tab of the Business console to upload this information, or use the Ant task described here.

Note: An example of using Ant tasks to upload users to the sample server is provided in Opening Decision Center on the sample server.

To manage groups and users using Ant, you first create an XML configuration file that contains the user, group, and role information. Then, you upload the configuration file by running the upload-usermanagement-def Ant task, located in <InstallDir>/teamserver/bin/build.xml, with the following parameters:

-DuserManagementDefFilePath=<The path to the XML configuration file>
-Dserver.url=<The Decision Center URL>
-DrtsAdmin.login=<The user name to log in to Decision Center>
-DrtsAdmin.password=<The password to log in to Decision Center>
-DdatasourceName=<The data source name>
-Ddownload=<Set to true to download the existing file from the database instead of uploading>
-Doutputfile=<The path to save the downloaded file>

For example:

ant upload-usermanagement-def -DuserManagementDefFilePath=C:\my_path\userRoleManagement.xml -Dserver.url=my_url -DrtsAdmin.login=rtsAdmin -DrtsAdmin.password=rtsAdmin -DdatasourceName=my_datasource

The configuration file has the following parameters:

<role name="RoleName"/> - Declares a new role. You do not need to upload the predefined roles because they are already present in the Decision Center database. You can upload new roles, but new roles must also be enabled as part of customizing of the Decision Center applications.
<group name="GroupName" roles="RoleName"/> - Declares a group and the roles to which the group belongs.
<user name="UserName" groups="GroupName"/> - Declares a user and the groups to which the user belongs.

The following example shows the XML configuration file required to declare two new regular users and two new groups:

<dc-usermanagement>
<group name="Eligibility" roles="rtsUser"/>
<group name="Validator" roles="rtsUser"/>
<user name="John Smith" groups="Eligibility"/>
<user name="Jane Doe" groups="Validator,Eligibility"/>
</dc-usermanagement>