Page History
Excerpt | ||
---|---|---|
| ||
dm_get_dataobject |
Note |
---|
This page is a work in progress. |
To get all the metadata associated with a dataObject, execute the command:
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:
Panel | |||||
---|---|---|---|---|---|
| |||||
|
The following table describes each parameter:
Parameter | Description |
---|---|
[-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:
|
[-o <metadata-file>] | An optional parameter, specifying a path and filename in your local system. The system always creates a metadata file:
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:
Panel | |||||
---|---|---|---|---|---|
| |||||
|
The basic format of the command output is as follows:
Code Block |
---|
{
"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. [metadata-file] [REST-response]If the [metadata-file] is omitted, the metadata will be printed to stdout.