diff --git a/data_submission/clin_biospec_assay.html b/data_submission/clin_biospec_assay.html index e4ab1b66..80b509c8 100644 --- a/data_submission/clin_biospec_assay.html +++ b/data_submission/clin_biospec_assay.html @@ -48,6 +48,7 @@

Submitting Assay Data and Metadata

As stated in Data Submission Overview, data submission involves two key steps: 1. Uploading assay data files to Synapse; and 2. Completing and validating metadata using the Data Curator App (DCA).

+

!!! Once assay data files are submitted to Synapse, the files will have entityIDs (e.g. syn12345670) assigned to them. These can then be prepopulated into the manifests on the DCA. For this reason, assay files should be submitted before generating the associated manifests. !!!

This page provides details regarding those steps.

@@ -97,7 +98,8 @@

Validate and submit metadata using Synapse’s Data Curator App (DCA).

-

The DCA contains HTAN-specific metadata templates which can be completed on the app or downloaded. Once these are completed by your center, they should then be validated and submitted via the DCA.

+

The DCA contains HTAN-specific manifests (metadata templates) which can be 1) completed on the app, or 2) downloaded, completed and uploaded back to the DCA. Manifests for assay data will be pre-populated with assay file entityIDs once they are associated with a particular dataset folder. Once the metadata templates are completed by your center, they should then be validated and submitted via the DCA.

+

!!! Please note: If you have added files where a pre-existing manifest exists, please add to data to the existing manifest on the DCA app or download the existing manifest from the DCA to make updates. Do not use a local copy of the manifest at your center. !!!

Please see Synapse’s Data Ingress Docs for more details regarding the web app.

diff --git a/data_submission/clin_biospec_assay.md b/data_submission/clin_biospec_assay.md index 5a973fb4..ffda5224 100644 --- a/data_submission/clin_biospec_assay.md +++ b/data_submission/clin_biospec_assay.md @@ -68,9 +68,16 @@ Data files can be transferred using the Synapse User Interface (Synapse UI) or p !!! If you upload files to Synapse programmatically, please use synapseclient version 3.0.0 or higher. !!! - ## Validate and submit metadata using Synapse's Data Curator App (DCA). -The DCA contains HTAN-specific metadata templates which can be completed on the app or downloaded. Once these are completed by your center, they should then be validated and submitted via the DCA. +The DCA contains HTAN-specific manifests (metadata templates) which can be + +1. completed on the app, or +2. downloaded, completed and uploaded back to the DCA. + +Manifests for assay data will be pre-populated with assay file entityIDs once they are associated with a particular Synapse dataset folder. Once the manifests are completed by your center, they should then be validated and submitted via the DCA. DCA validation checks for a subset of common errors. If any of these errors are found, you can edit the metadata and then revalidate and submit. + +!!! Please note: If you have added assay files to a Synapse folder where there is a pre-existing manifest or you are adding records to a pre-existing clinical data or biospecimen manifest, **please update the existing manifest on the DCA app or download the existing manifest from the DCA** to make updates. **Do not use a local copy of the manifest at your center to make updates**. Local copies may be out of sync with the data in Synapse +!!! Please see Synapse's [Data Ingress Docs](https://dca-docs.scrollhelp.site/DCA/Working-version/HTAN/validate-and-submit-your-metadata) for more details regarding the web app.