NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: For HPCDATAMGM-1612, updated chart name.

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, you can upload register a data file to into that collection (up to 10 GB). This page describes how to register one data file at a time. For instructions on registering multiple files, refer to Uploading Registering Data in Bulk via the GUI

To register a data file:

  1. Log in as described in Logging In via the GUI. The Dashboard appears.
  2. Select a method:
    If you are not familiar with Browse for the data destination, browse for it, as described in Browsing for Data via the GUI. Navigate to and right-click the location where collection in which you want to register your data file. Click Add Datafile. The Register Data File page appears.If you are familiar with the data destination, select this method: In the left panel, click Register > . (Another option is as follows: Click Register tab > Data File.) The Register Data File page appears.
    The Register Data File page.Image Modified 

    If you browsed to the data destination, that portion of the page has only the Data File Path field, with a system-generated collection path already specified.
  3. If the Base Path and Collection Type fields are available, specify the data destination:

    1. Select the base path specified by your group administrator.

       The system

       An information icon (The information icon for the base path.Image Added) appears next to the Base Path field and the system begins to populate values in the Collection Type field.  

      A portion of the Register Data File page with the hierarchies icon.Image Added

      Consider examining the valid hierarchy for the selected base path. To do so, click the information icon next to the Base Path field. A Data Hierarchy and

      the Data File Path field. (If you are a group administrator and want the Collection Type field to list more collection types, contact NCIDataVault@mail.nih.gov.)
      Include Pageshared step - select collection typeshared step - select collection type

      Metadata Structure chart appears. For details, refer to Viewing the Data Hierarchy and Metadata Structure for an Archive.

    2. If there is more than one collection type, select the one in which you want to register data. For guidance on selecting a collection type, refer to your group administrator. For some collection types, the system displays a list of required and optional metadata attributes. 
  4. Specify the data source:

    1. Consider specifying a checksum for validation of data transfer. 

      Include Page
      shared info - checksum option
      shared info - checksum option

      Include Pageshared step - select data fileshared step - select data file
    Include Pageshared step - specify data file pathshared step - specify data file path
    1. Click Choose File. Navigate to and select your data file. The system appends the data file name to the value in the Data File Path field. 

  5. In the Data File Path field, specify the full path, including the base path and the name of the file you intend to register. The characters allowed in a file name depend on the operating system:

    • Windows accepts any characters except forward slash (/), backslash (\), colon (:), semicolon (;), asterisk (*), question mark (?), double quote (“), less than (<), greater than (>), pipe (|), or space.
    • Other operating systems allow any characters except question mark (?), semicolon (;), backslash (\), double quote (“), or space.

    Consider the following example: 

    PathExample
    Base path/SAMPLE_Archive
    Data file path/SAMPLE_Archive/PI_Lab_Name/ProjectN/data.txt
  6. Consider hovering over the information icon (The information icon for each attribute.) for each required attribute. A tooltip appears with information about that attribute. 
    A portion of the Register Collection page listing required and optional attributes.Image Modified 
  7. Specify the file metadata:

    1. Include Page
      shared step - add metadata 20190926
      shared step - add metadata 20190926

      If you change your mind about adding an attribute, click the trash can icon next to that attribute. If you proceed to update the collection with a new attribute, the attribute name is permanent.

    2. Include Page
      shared step - specify attribute values
      shared step - specify attribute values
    Include Pageshared step - register fileshared step - register file

...

  1. Click Register. The system checks whether the data you have entered is valid for the selected base path and collection type:

    • If the data you have entered is not valid, the system displays an error message. 
    • If the data you have entered is valid, the system saves the new data file and metadata. The Data File page appears, displaying details about the new data file. For information, refer to Viewing Metadata via the GUI