NIH | National Cancer Institute | NCI Wiki  

This page describes how to create an empty collection from the Browse page or the Register menu. The following conditions must be true for the existing collection in which you intend to create the empty collection:

  • Your user account has the Write or Own permission level on the existing collection.
  • That existing collection has been configured to contain another collection. 

To create a collection:

  1. Log in as described in Logging In via the GUI. The Dashboard appears.
  2. Browse for the data destination, as described in Browsing for Data via the GUI. Navigate to and right-click the existing collection in which you want to create your new collection. Click Add Collection. (Another option is as follows: Click Register > Collection.) The Register Collection page appears. 

    The Register Collection page. 

    If you browsed to the data destination, that portion of the page has only the Collection Type and Collection Path fields, with a system-generated collection path already specified.
  3. If the Base Path field is available, select the base path specified by your group administrator. An information icon (The information icon for the base path.) appears next to the Base Path field and the system begins to populate values in the Collection Type field. 

    A portion of the Register Collection page with the hierarchies icon.

    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 Metadata Structure chart appears. For details, refer to Viewing the Data Hierarchy and Metadata Structure for an Archive

  4. Specify the rest of the data destination:
    1. If there is more than one collection type, select one for the new collection. For guidance on selecting a collection type, refer to your group administrator. For some collection types, the system displays a list of required and/or optional metadata attributes. 

    2. In the Collection Path field, specify the full path, including the base path and the name of the collection you intend to create. Avoid using invalid characters such as the space character, question mark (?), semicolon (;), backslash (\), or double quote ("). Consider the following example: 

      PathExample
      Base path/SAMPLE_Archive
      Collection path/SAMPLE_Archive/Sample_Collection_Name
  5. 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.
  6. Specify the collection 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. 

        Attribute portion of the page with a new attribute.
      2. Specify a unique attribute name. 

      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. 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 AttributeExample Value
      data_ownerJane Doe
      project_id1234567890
      sample_nameL1
      project_start_date2020-12-31

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

  7. Click Register Collection. 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 collection. The Collection page appears, displaying details about the new collection. For information, refer to Viewing Metadata via the GUI


  • No labels