NIH | National Cancer Institute | NCI Wiki  

Error rendering macro 'rw-search'

null

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 15 Next »

This page is a work in progress.

If your user account has the Write or Own permission level on an existing collection in DME, and if that existing collection has been configured to contain data files, the following command allows you to upload a data file to that collection. You can choose whether to upload synchronously (from your file system) or asynchronously (from a Globus endpoint):

dm_register_dataobject <description.json> <destination-path> [source-file]

The following table describes each parameter:

ParameterDescription
<description.json>

A path to a file in your file system. The contents of this file depend on the source of your data:

  • If you are uploading from your file system, specify the metadata that you want to upload. Click the following link to view the syntax: 

    { 
    "metadataEntries": [
      {
        "attribute": "description",
        "value": "my-dataObject-description"
      },
      {
        "attribute": "my-second-attribute-name",
        "value": "my-second-attribute-value"
      }
    ]
}

  • If you are uploading from Globus, specify the Globus endpoint, the file path on that endpoint, and the metadata that you want to upload. Click the following link to view the syntax:

    { 
  "source": {
    "fileContainerId": "globus-shared-endpoint-uid",
    "fileId": "file-path-on-shared-globus-endpoint"
  },
  "metadataEntries": [
    {
      "attribute": "description",
      "value": "my-file-description"
    }, 
    {
      "attribute": "my-second-attribute-name",
      "value": "my-second-attribute-description"
    }
  ]
}
<destination-path>
A path within DME, including the name of the file you intend to upload. Specify where you want the system to create the new data file. 
[source-file]

A path to a file in your file system:

  • If you are uploading from your file system, use this parameter to specify the file that you want to upload.
  • If you are uploading from Globus, omit this parameter.

For example, the following command copies the data.txt file from the JaneDoe folder in the file system to the Project_New collection in DME:

dm_register_dataobject my-metadata.json /TEST_Archive/PI_Lab1/Project_New /cygdrive/c/Users/JaneDoe/data.txt

For instructions on performing similar tasks in the GUI, refer to the following pages:

If you uploaded the file from a Globus endpoint, you can view the progress of the upload in the GUI. For instructions, refer to Viewing Globus Upload Status.

  • No labels