You can import a .csv file that contains groups and user information, and it will create new users and groups in DocuShare.
1. Create a New Group in DocuShare.
a. Log into DocuShare as admin.
b. Click Admin Home | Groups | Go to List / Find/ Add Group. The Users and Groups Registry page displays.
c. Select the Add Group link on the left hand side of the page. The Add Group page displays.
d. In the Title field enter the group name and fill in any other fields that are desired.
e. Click the Apply button. Then Pick Members for Group page displays.
f. Add at least 2 existing DocuShare members to the group, by selecting them from the Possible Users/Groups window and clicking the Add button.
Note: It is strongly suggested that you test this with 1 or 2 groups and a few users before importing all the users and groups to verify the outcome is as intended.
Note: If Nothing is displayed in the Possible Users /Groups window then select Show Users and click the Show All button. If there are still no users displayed then you will need to verify that you have users created in DocuShare.
g. Click the Update button.
2. Find out the Group Handle for the New Group.
a. Log into DocuShare as admin.
b. Click Admin Home | Groups | Go to List/Find/Add Group.
c. Select the New Group from the Groups Found section on the page. The View Properties page displays.
d. Make a note of the Handle: property listed. You will need the Group Handle to complete the next step.
Example: Group-21
3. Export the New Group using the dsexport command.
a. Open a Command Prompt window.
b. Change into the /bin directory.
Where is replaced with the path to DocuShare. The default installation path is C:\Xerox\Docushare. Depending on your installation environment the path may vary.
c. Run the command dsexport.bat –f csv and press Enter.
Where
Example:
C:\Xerox\Docushare\bin>dsexport.bat -f csv Group-21
-------
Running dsexport -f csv Group-21
11 Apr 2011 15:34:08 INFO - extracting data to C:\Xerox\Docushare\bin\.\Group-21
11 Apr 2011 15:34:09 INFO - Extracted 2 Users
11 Apr 2011 15:34:09 INFO - Extracted 1 Group
11 Apr 2011 15:34:09 INFO - Export to CSV is completed.
11 Apr 2011 15:34:09 INFO - Duration:0 hour(s) 0 min(s) 1 sec(s).
11 Apr 2011 15:34:09 INFO - Done.
Note: This example will create an group-21.csv file in the \bin folder.
4. Modify the dsexport file.
a. Open the csv file (export file) that was created in Step 3 in a text editor such as Notepad.
Note: It is recommended that you use a text editor that will not change the formatting of the csv file when resaving the file after making modifications. If the format is changed DocuShare will not import the file.
The .csv file is divided into the following three sections:
· Header – Do not edit the header section.
· User – The User section defines the users you are going to import into DocuShare. They need unique handles and usernames. Complete the User properties as required for your installation environment.
Note: The handle numbers you define will not matter as long as the add parameter is used when running the dsimport function, because the utility will create new handles for every user.
Note - If the -n use parameter is used when running the dsimport utility it will try to match the username with an existing username in DocuShare.
· Group - The Group section is where all the groups are defined. Each group requires a unique handle and title.
Note: The membership field allows you to define the users that are assigned membership to the group. This field requires the use of quotes.
Example: “User-11,User-12,User-13â€
b. Save the file.
Note:
Red Text – Do not edit these areas.
Black Text – Exported Data
Blue Text – Example of Added Data (new Users and Groups)
Example of an exported .csv file that has been modified:
DocuShare Host
locale,created_date,version,serverID,export_version,ds_host,patchInstalled,build,encoding
en,Mon Apr 11 15:34:08 ADT 2011,06.05.03.C1.746,hostname.xerox.com,6.5,DocuShare,"ds653hf1,liquid-office-server",06.05.03.C1.746,UTF-8
User
handle,attachmentAsURL,summary,phone,homeSpace,alternateEmail,passwordExpiration,password,failedLoginCount,first_name,username,create_date,description,userLevel,isRMCoordinatorEnabled,isRMAdminEnabled,last_whats_new,webdav_title,keywords,changePasswordAtLogin,copiedFrom,last_login,isActive,remote_DN,mailstop,email,expiration_date,last_name,routing_choice,contentSizeMBQuota,useRichTextEdit,language,isInteractEnabled,routing_template_id,modified_date,locale,space,characterCode,title,canDeclareIfContributor,domain,email_format,docCountQuota,noSubscriptionNotifyFor,home_page,layoutDefaults,lastSynchronized,pagingIncrement,noEmailAgentNotifyFor,isRecord,rm_instance_handle,client_data,routingIDs,isRMContributorEnabled,readyForDeclare,javascriptOn,subscription,owner,modifiedBy,favorite,associatedCollection,Source_membership,Source_subscriber,Source_owner,Source_modifiedBy,Source_lockedBy,Source_favorite
User-11,false,,,,,,9877AD0EFC51A1A8677B83B160B1E22A02CA769EAB9A82018226BE0BB47976E35BB12360,0,,eforms,Fri Sep 03 13:22:12 ADT 2010,,dsFul