Find the location of a stored file 

Use the FilesUtilService.getFileById command to locate a file stored in a directory on a file system.

Before you begin

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

Many commands ask for IDs as input parameters, such as library IDs, user IDs, policy IDs, and file IDs. You can use commands that take parameters you do know to return data including the ID you are looking for. For example, run FilesMemberService.getByEmail(string email) providing a user's email address and among the data returned is the user's ID. You can also find IDs using feeds. See the Lotus Connections API documentation for information on getting ID information using feeds.

About this task

Files uploaded through the IBM Connections Files component are stored on a shared file system, as described in the topic Install IBM Connections 3.0.1.

This command can be useful when restoring backup versions of data. See the topic Backing up Files data for more information.


  1. Start the wsadmin client.

  2. Start the Files Jython script interpreter using the following command:


  3. Run the following command to locate a file stored in the file directory:


      where fileID is the ID of a file stored in the database. The ID must be a string in the following standard Universally Unique Identifier (UUID) format: 00000000-0000-0000-0000-000000000000.

      The command returns the file path as a string, even if the file is not in use.

Parent topic

Administer Files

Related tasks

Install IBM Connections 3.0.1
Backing up Files data