Page History
...
In your file system, create a JSON file that specifies the metadata for the new collection. At a minimum, this file must specify the collection type and all required metadata, as follows:
Code Block { "metadataEntries": [ { "attribute": "collection_type", "value": "PI_Lab" }, { "attribute": "pi_namedata_owner", "value": "example owner" }, { "attribute": "data_curator", "value": "example curator" } ] }
If an attribute has predefined values, specify values that fall within that set of values.
In your JSON file, if you want to create a parent collection for the empty collection (or update the metadata of an existing parent collection), also specify the metadata for the parent collection. Click the following link to view the syntax:
Panel borderColor #C0C0C0 borderStyle solid Expand title Syntax Code Block { "metadataEntries": [ { "attribute": "project", "value": "my-project-name" }, { "attribute": "collection_type", "value": "Folder" } ], "createParentCollections": true, "parentCollectionsBulkMetadataEntries": { "pathsMetadataEntries": [{ "path": "/Example_Archive/PI_Lab1/Project_New", "pathMetadataEntries": [{ "attribute": "collection_type", "value": "Folder" }, { "attribute": "example info", "value": "123456" }] }] } }
Run the following command:
Panel borderColor silver borderStyle solid Clipboard AllowLineWrap true 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 to the JSON file that specifies the metadata for the new collection. <destination-path>
A path within DME, including the name of the collection you intend to create. Specify where you want the system to create the new collection. (If you specify an existing collection, this command updates the metadata for that collection. For details, refer to Updating Collection Metadata via the CLU.) The command registers the metadata specified in <description.json> to the <destination-path> in DME.
...