A bookmark allows you to quickly access a collection or data file of interest. If your user account has the Read permission level on any collection or data file in DME, you can create a bookmark on that collection or data file. If your user account has the system administrator or group administrator role, the dm_add_bookmark command also allows you to add a bookmark for another user and set permissions for that user at the same time. With the same command, you might also be able to provide permissions for a user account that does not exist in LDAP yet.
For general usage information about the dm_add_bookmark command, refer to Adding a Bookmark via the CLU. As an administrator, you can specify additional parameters (userId and permission) in the JSON file:
{
"path" : "/Path/To/Bookmark",
"userId" : "NIH user ID",
"permission": "The permission to set for the path"
}
Possible values for the permission field are as follows:
- Own
- Write
- Read
The system responds as follows:
- If your JSON file specifies a bookmark path for an existing DME user, but does not specify a permission level for that user, then the system leaves the existing permission level as it is.
- If your JSON file specifies a user account that does not exist in LDAP yet, and specifies a permission level for that user, the system creates that user in DME with the specified permission level.
- The system creates the user in the DOC with which you are affiliated, and does not set a base path.
For example, consider the following command:
dm_add_bookmark MyCollection /cygdrive/c/Users/JaneDoe/my-bookmark.json
With the following code in the specified my-bookmark.json file, the command gives the doejohn9 user Write access to the PI_Lab1 collection, creates a bookmark named MyCollection for that user, and associates the bookmark with the PI_Lab1 collection:
{
"path" : "/Example_Archive/PI_Lab1",
"userId" : "doejohn9",
"permission": "Write"
}
