Registering a Data File via the GUI

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 a data file to that collection. This page describes how to register one data file at a time. For instructions on registering multiple files, refer to Uploading 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 the data destination, browse for it, as described in Browsing for Data via the GUI. Navigate to and right-click the collection in which you want to register your data file. Click Add Data File. The Register Data File page appears.
   • If you are familiar with the data destination, select this method: In the left panel, click Register > Data File. The Register Data File page appears.
     
      
     
     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. An information icon () appears next to the Base Path field and the system begins to populate values in the Collection Type field and the Data File Path field.  
      
      

      Consider examining the valid hierarchies for the selected base path. To do so, click the information icon next to the Base Path field. A Valid Hierarchies chart appears indicating the collection type or types allowed within each collection type. In the chart, a check mark indicates each collection in which you can register data files. 
      
      

      To close the Valid Hierarchies chart, click elsewhere on the page.

   2. If there is more than one collection type, select the one in which you want to upload 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. By default, the system does not perform this calculation because it can increase the time required to register the data, depending on the file size.

   2. Unable to render {include} The included page could not be found.
5. Unable to render {include} The included page could not be found.
6. Consider hovering over the information icon () for each required attribute. A tooltip appears with information about that attribute. 
    
7. Specify the file metadata:
   
   
   1. To add a metadata attribute: 

      1. Click Add Metadata, visible on the right or left side of the page. A blank attribute row appears. 
         
         
      2. Specify a unique attribute name. 

      If you change your mind about adding an attribute, leave the name and value fields blank for that attribute. The system ignores a blank row. If you proceed to update the collection with a new attribute, the attribute name is permanent.

   2. In each attribute row, specify a unique value that describes the content you are registering. The character limit for each metadata value is 2700.

      Example Attribute	Example Value
      data_owner	Jane Doe
      project_id	1234567890
      sample_name	L1
      project_start_date	2020-12-31

      For some date attributes, such as project_start_date, the system expects the "yyyy-MM-dd" format, as in the above example. 

8. Unable to render {include} The included page could not be found.