Skip to main content

Form B1a Submission (UDSv3)

Introduction

Alzheimer’s Disease Research Centers (ADRCs) can submit Form B1a: Evaluation Form — Blood Pressure Addendum for UDSv3 visits to NACC through the ADRC Portal. Please note that during the initial rollout, ADRCs will only be able to submit UDSv3 visit data for Form B1a. As a result, the submission process for Form B1a will follow different rules and utilize different entry points compared to the UDSv4 data streams currently accepted in the Portal.

This document covers how to:

  • Locate the Form B1a (UDSv3) submission area within the ADRC Portal.
  • Upload your Form B1a data using a CSV file.
  • Track how submissions are processed and check your QC status and results.
  • Access and interpret the error report if a submission fails.

Accessing the Portal and the Form B1a Submission Entry Point

Step-by-step guide

  1. Log in to the ADRC Portal.

  2. Go to Submit Data.

    Screenshot: b1a-udsv3-01-submit-data-nav.png.

  3. Select the UDSv3 tile (UDSv3 Retrospective Forms).

    Screenshot: b1a-udsv3-02-udsv3-tile.png.

  4. You will be taken to the UDSv3 Retrospective Form Submission page (the page layout is like the UDSv4 submission page but scoped to B1a forms only).

    Screenshot: b1a-udsv3-03-b1a-module-submission-page.png.

B1a Form Submission Method: Batch File Upload (CSV via Portal)

File requirements (UDSv3)

  • B1a form submissions require a specific filename suffix -b1a.csv.
  • The Portal validates the suffix before allowing upload.
  • The CSV column headers should match with the Data Element Dictionary for the B1a Form which can be found in the EDC File Downloads Page.

Mapping the B1a Form to the UDSv3 packet

PTID, VISITNUM, and VISITDATE of the B1a form should exactly match those of the respective UDSv3 packet.

Even when the visit is split into multiple days, the same VISITNUM and VISITDATE MUST be used for the header variables in both submissions (UDS and Form B1a). Guidance is to use the date that UDS Form A1 is filled as the VISITDATE for both. Individual form dates (FRMDATE[XX] variables) can be different depdending on when they are completed.

PACKET code:

For a B1a form collected for a UDSv3 IVP (packet code I or IT), use PACKET=I. For a B1a form collected for a UDSv3 FVP (packet code F or T), use PACKET=F.

Step-by-step guide

  1. In the Batch File Upload panel, select the CSV file you wish to upload using the Drag and drop files here or click to browse area.

    Screenshot: b1a-udsv3-04-b1a-module-submission-drag-drop.png.

  2. If the filename does not end with the required suffix, the Portal will block the upload and display a message indicating the file must end with -b1a.csv.

    Screenshot: b1a-udsv3-05-invalid-suffix-must-end-with-b1a-csv.png.

  3. Select a file with the correct suffix (ending in -b1a.csv), for example, test-file-b1a.csv. Once validated, the interface will show the file as ready for upload.

    Screenshot: b1a-udsv3-06-valid-suffix-ready-for-upload.png.

  4. Click Upload to submit the file.

    Screenshot: b1a-udsv3-07-upload-button.png.

  5. After a few seconds, you will be redirected to the UDSv3 Module Forms QC page, where you can review the QC status.

    Screenshot: b1a-udsv3-08-redirect-to-udsv3-qc-page.png.

Viewing QC Status (UDSv3 Module QC Page)

The UDSv3 QC page is almost identical in layout and functionality to the UDSv4 QC page, but it displays only UDSv3 module forms.

Step-by-step guide

  1. Use the sidebar menu to navigate to View, Audit, & Access → UDSv3 Module QC.

    Screenshot: b1a-udsv3-09-view-audit-access-udsv3-qc-nav.png.

  2. The interface will then display the UDSv3 Module Forms QC page.

    Screenshot: b1a-udsv3-10-module-forms-qc.png.

  3. In the Submissions for UDSv3 Module Forms panel, you can review the pipeline status for submitted files. For example, click PASS in the Batch Status column.

    Screenshot: b1a-udsv3-11-qc-file-batch-status.png.

  4. The interface will then display the Batch Status, such as:

  • Form Screening: Confirms that the submitted CSV is correctly named with the required B1a form suffix.

  • File Validator: Verifies that the CSV uses the correct headers and data types, consistent with the NACC-published data dictionary.

  • Identifier Lookup: Retrieves participant identifiers for the incoming data.

    Screenshot: b1a-udsv3-12-qc-display-batch-status.png.

  1. In the Visit-Level QC Status panel, you can review the QC status for each participant (PTID) and each record in the submitted files. For example, click PASS in the QC Status column.

    Screenshot: b1a-udsv3-13-qc-ptid-status.png.

  2. The interface will then display the QC Status, such as:

  • Identifier Lookup: Retrieves participant identifiers for the incoming data.

  • Form CSV to JSON Transformer: Converts the form data from CSV to JSON.

  • Form QC Coordinator: Coordinates validation across visits/modules for a given participant.

  • Form QC Checker: Runs NACC data quality checks on a participant’s visit record.

    Screenshot: b1a-udsv3-14-qc-display-qc-status.png.

Viewing and Using the Error Report

Step-by-step guide

  1. In the Errors and Alerts panel on the UDSv3 Module Forms QC page, click the Open full error report (USDSv3 Modules only) button to open the full error report for the submission.

    • This error report is scoped to UDSv3 modules (including the B1a form stream).

    Screenshot: b1a-udsv3-15-open-full-error-report.png.

  2. Review errors listed in the report and correct your source data/CSV accordingly.

  3. Re-upload the corrected CSV (ensuring the filename still ends with -b1a.csv).

NOTE

The Portal also has other QC or error-report areas for other data streams (for example, UDSv4 pages). Those will show different error reports. Be sure you are using the UDSv3 Module QC page for B1a form submissions.*

Notes and Differences vs. Other Portal Submissions

  • UDSv3 visits only (initially): B1a form submissions are restricted to UDSv3 visit data at first, which is different from other submissions currently accepted.
  • New navigation locations: The B1a form submission and QC pages may be marked as new and appear in different locations than existing workflows, while keeping a familiar UDSv4-like interface.
  • Legacy Portal visibility: A link to the Legacy Portal may still appear for other data streams; B1a form submissions should be performed using Submit Retrospective Forms under the UDSv3 area.

Troubleshooting (Common Issues)

  • Upload blocked immediately: Confirm the filename ends with -b1a.csv. If it does not, the Portal will not allow upload.
  • Need to find DS-specific QC results: Use the UDSv3 Module QC page under View, Audit, & Access, not the UDSv4 QC pages.
  • Errors in submission: Open the full error report, correct issues, and re-upload using the correct suffix.
NOTE

NACC-hosted REDCap Direct Entry option is NOT supported for UDSv3 Form B1a submissions.