Transferring ownership of user files

As an administrator, you can use a wsadmin command to transfer a user's Connections files to a new owner.

Before you begin

To use administrative commands, you must use the wsadmin client. See Starting the wsadmin client for details.

About this task

The wsadmin command to transfer user files must include the future owner's email address. The command can be used to transfer only the personal files of the original user , not community files.

In this procedure, let's say that a user asks you to transfer six of their files to a new owner. The requesting user provides you with the file names of the files to transfer and the email address of the new user, for example,


  1. Run this command to get the future owner's internal ID:
    Note: If you prefer, you can use the future owner's directory ID to find their internal ID. In this case, run FilesMemberService.getByExtId instead of the preceding command.
    The following example shows the properties that are returned by using getByEmail, including the ID for the new owner (9b1683e7-ca4f-4ac1-85a1-c780fa1340b5) that you will need in step 3.
       directoryLastUpdate=Sun May 05 22:09:51 EDT 2019, 
       directoryGroupLastUpdate=Mon May 06 03:33:59 EDT 2019, 
       name=Amy Jones, 
       lastVisit=Mon May 06 03:33:59 EDT 2019, 
       createDate=Sun May 05 22:09:51 EDT 2019, 
       communityLastUpdate=Mon May 06 03:33:59 EDT 2019
  2. In the file directory for the original user, prepare a text file that contains a list of IDs for one or more files to be transferred. (To find a file's unique ID, look at the library feed of the user's files and correlate the file name to the its ID.) Place only one ID on each line as in the following example. Record the full directory path to use in step 3.
  3. Now, run the following command, which transfers the preceding files to the My Files directory of the new owner and assigns a tag to each file so that they all can be identified later:
    FilesLibraryService.transferPersonalFiles("filepath", "ownerUserId", "tag")
    • filepath is the full path to the text file that you created to identify the files to be transferred, for example, /home/user1/fileids.txt
    • ownerUserId is future owner's ID that you found in step 1. This ID is an internal UUID assigned by the Files app in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000
    • tag is a tag that you assign to the target file, for example, from-user1-to-user2.
  4. (Optional) Run the TagUpdateFrequency task to capture new tags in the tag cloud:
    FilesScheduler.forceTaskExecution("TagUpdateFrequency", "true")
    Note: If you skip this step, the new tag will be captured in the tag cloud after 1 day.