NIH | National Cancer Institute | NCI Wiki  

If your user account has the Read permission level on a data file in DME, the following command allows you to retrieve all metadata associated with that data file:

dm_get_dataobject [optional parameters] <dataobject-path>


The following table describes each parameter:

ParameterDescription
[-h]If you want to print a usage (help) message for this command, specify this option.
[-a <attribute name>]An optional parameter, specifying an attribute to obtain the value of that attribute.
[-D <REST-response>]

An optional parameter, specifying a path and filename in your local 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 get-item-response-header.tmp in your home directory.
[-o <metadata-file>]

An optional parameter, specifying a path and filename in your local system. The system always creates a metadata file:

  • If you specify this parameter, the system saves the metadata to the specified file in the specified location.
  • If you omit this parameter, the system prints the metadata to standard output and saves the file as get-item-response-message.json.tmp in your home directory.

The metadata includes information about the data file, a list of attribute values for the file, and a list of attribute values for the parent collection.

<dataobject-path>
The path to the data file in DME.

For example, the following command allows you to view the metadata associated with the sample.txt data file:

dm_get_dataobject /Example_Archive/PI_Lab1/Project_Orig/sample.txt


The basic format of the command output is as follows:

{
    "dataObjects": [
        {
            "dataObject": {...},
            "metadataEntries": {
                "parentMetadataEntries": [...],
                "selfMetadataEntries": [...]
            }
        }
    ]
}

In this format, the "dataObject" and "selfMetadataEntries" elements provide information about the file you specified, while the "parentMetadataEntries" element provides information about the collection that contains the file you specified.