Updating Collection Metadata via the CLU

If your user account has the Write or Own permission level on an existing collection in DME, you can use a CLU command to update the metadata of that collection. 

To update the metadata of a collection:

1. Consider the metadata requirements for the type of collection that you intend to update: 
   • What are the required attributes for this collection type?
   • What are the acceptable values and default values for each attribute?

2. In your file system, create a JSON file that specifies the metadata for the collection, as follows:

   {
       "metadataEntries": [
           {
            "attribute": "project",
            "value": "my-project-name"
           },
           {
            "attribute": "collection_type",
            "value": "Folder"
           }
       ]
   }

3. Run the following command:

   dm_register_collection [optional parameters] <description.json> <destination-path>

   The following table describes each parameter:

   Parameter	Description
   [-h]	If you want to print a usage (help) message for this command, specify this option.
   [-D <REST-response>]	An optional parameter, specifying a path and filename in your file system. The system always creates a response file: If you specify this parameter, the system saves the response from the server to the specified file in the specified location. If you omit this parameter, the system saves the file as collection-registration-response-header.tmp in your home directory.
   [-o <output-json-file>]	An optional parameter, specifying a path and filename in your file system. The system always creates an output file:  If you specify this parameter, the system saves the output to the specified file in the specified location. If you omit this parameter, the system saves the output as collection-registration-response-message.json.tmp in your home directory. If the command is successful, the output file is empty.
   <description.json>	A path within a file system, including the name of the JSON file that specifies the metadata for the collection you intend to update.
   <destination-path>	A path within DME, including the name of the collection you intend to update. (If you specify a collection that does not already exist, the command creates a new collection. For details, refer to Creating an Empty Collection via the CLU.)

   The command registers the metadata specified in <description.json> to the <destination-path> in DME. 

For example, the following command updates the Project1 collection within the PI_Lab1 collection, based on the metadata in the my-collection.json file:

dm_register_collection my-collection.json /Example_Archive/PI_Lab1/Project1

The JSON file must contain metadata for the collection, Project1.