5.2. Upload metadata

To upload a Metadata to a Folder you need to have WRITE permission for that folder and the ROLE_ENTITY_MANAGER role. For more information see 13. Permissions.

Each folder allows uploading metadata to its space. But to get the full set of features it is advised to upload the metadata into the special types of folders called Projects. How to create a project described here.
Uploading could be executed from the csv or tsv file. The structure of load file should be as in Table 1.

Table 1 - Load file structure

(referenced_entity_type):ID membership:MembershipAttributeName:(referenced_entity_type):ID AttributeName
referenced_uid_value referenced_uid_value attribute_value
referenced_uid_value referenced_uid_value attribute_value
referenced_uid_value referenced_uid_value attribute_value

Examples: wes-11-rep-samples.csv, wes-11-rep-set.csv

  • (referenced_entity_type):ID - here you set up what type of entity you are uploading and what is an ID of it, e.g. Sample:ID = FZ700059549.
  • membership:MembershipAttributeName:(referenced_entity_type):ID - this is a reference to an instance of another entity. If you have a sample owned by a participant, you can show this connection - membership:Participants:Participant:ID = TY90000044343.
    Note: make sure, that the reference entity id already exists in the system.
  • AttributeName - any attribute name of an instance, e.g. RNA or DNA type, Blood or Tissue, etc.

Upload instances of an entity

  1. Click on CP_UploadMetadata button.
  2. The Uploading metadata window is open.
  3. Select the appropriate file.
  4. Confirm choice by clicking OK.
    Note: if your file contains a link to the instance that doesn't exist, the whole metadata file won't be uploaded. For example, you set a link to a participant ID that doesn't exist in the file with samples.
    Note: while uploading the progress bar will be shown:
  5. The new metadata is uploaded in the folder of a specific entity in the project.
    Note: the instances will be uploaded to the entity with a name, related to the first column if exists (e.g. "Sample"). Otherwise, the new entity folder will be created.
    Note: if the file contains instances already exist in the system, the attributes of it will be updated.