From 6c583055ab1d6dbf9ea157b77db25e24a0365067 Mon Sep 17 00:00:00 2001 From: Jennifer Altreuter Date: Fri, 9 Aug 2024 09:17:40 -0400 Subject: [PATCH 1/3] minor grammar edits for index date page. --- data_submission/dates.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/data_submission/dates.md b/data_submission/dates.md index 9a938512..dd319e66 100644 --- a/data_submission/dates.md +++ b/data_submission/dates.md @@ -4,7 +4,7 @@ order: 995 # What is the index date? -HTAN cannot accept dates because they are considered Protect Health Information (PHI). In order to obfuscate dates, they should be converted to days from an index date. For most data case, the index date is the participant's date of birth. For example, a participant's therapy start date would be recorded as 365 days if the therapy took place 365 days after a participant's date of birth. +HTAN cannot accept dates because they are considered Protect Health Information (PHI). In order to obfuscate dates, they should be converted to days from an index date. For most data, the index date is the participant's date of birth. For example, a participant's therapy start date would be recorded as 365 days if the therapy took place 365 days after a participant's date of birth. !!! :warning: If your center has data indexed to enrollment date, the data needs to be converted to days from birth. @@ -26,4 +26,4 @@ The 'Diagnosis' manifest includes two attributes which are not indexed: - Days to Last Follow up; and - Days to Last Known Disease Status. -Please provide these time intervals for these attributes as described in the data model. \ No newline at end of file +Please provide these time intervals as described in the data model. \ No newline at end of file From 23ac5d1c0b4513d9205e5a82b91c3ee5ed53fec1 Mon Sep 17 00:00:00 2001 From: Jennifer Altreuter Date: Wed, 14 Aug 2024 09:17:26 -0400 Subject: [PATCH 2/3] Added info re: existing manifests to submitting metadata section. --- data_submission/clin_biospec_assay.html | 4 +++- data_submission/clin_biospec_assay.md | 11 +++++++++-- 2 files changed, 12 insertions(+), 3 deletions(-) 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. From 421c76d698d6008e04740fbba7b1cd82173057c2 Mon Sep 17 00:00:00 2001 From: Jennifer Altreuter Date: Wed, 14 Aug 2024 09:19:55 -0400 Subject: [PATCH 3/3] adding punctuation. --- data_submission/clin_biospec_assay.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data_submission/clin_biospec_assay.md b/data_submission/clin_biospec_assay.md index ffda5224..569cb975 100644 --- a/data_submission/clin_biospec_assay.md +++ b/data_submission/clin_biospec_assay.md @@ -77,7 +77,7 @@ The DCA contains HTAN-specific manifests (metadata templates) which can be 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 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.