Getting started with BRIDGE

Access ISARIC BRIDGE web application here: BRIDGE

Introduction

BRIDGE is an ISARIC developed web application that assists in the creation of Clinical Report Forms (CRFs). It is based on ARC.

ARC is a comprehensive machine-readable document in CSV format, designed for use in Clinical Report Forms (CRFs) during disease outbreaks. It includes a library of questions covering demographics, comorbidities, symptoms, medications, and outcomes. Each question is based on a standardized schema, has specific definitions mapped to controlled terminologies, and has built-in quality control. ARC is openly accessible, with version control via GitHub ensuring document integrity and collaboration.

BRIDGE is a web-based application designed to operationalize ARC and edit any ISARIC CRF and tailor it to an outbreak's particular context. By selecting and customizing clinical questions and ensuring necessary data points for each, BRIDGE automates the creation of Case Report Forms (CRFs) for each disease and specific research context. It generates the data dictionary and XML needed to create a REDCap database for capturing data in the ARC structure. Additionally, it produces paper-like versions of the CRFs and completion guides.

Structure

BRIDGE is divided into three components:

1. The tool bar is located on the left and allows the user to enter the settings and the templates. To open each of those you should click on the respective icon and click back when you want to return to the general view.
2. The ARC checkable tree is in the central panel of the application. It presents ARC as a tree structure with different levels: ARC version, forms, sections, and questions.
3. The CRF representation panel shows how the CRF is going to be when generating, including selected questions and support questions needed to be functional (that are automatically added by BRIDGE).

Settings

In the settings panel, users can select the version of ARC they want to use and the BRIDGE outcomes they want to generate:

• ISARIC Clinical Characterization XML: This file can be used to generate a REDCap project. It contains the clinical characterization structure that can be uploaded to REDCap to generate a project that allows data capture in the ARC structure.
• REDCap Data Dictionary: This file can be used to add the specific forms and questions selected in BRIDGE to the REDCap project.
• Paper-like CRF: This is a PDF file that can be printed and used to collect data manually, allowing sites that cannot capture data electronically to collect information that can later be uploaded to the REDCap database.

Templates

Templates are pre-selected groups of questions. Users can click on the Templates tab and select those they want to include in the CRF.

ISARIC templates allow users to start the CRF creation process based on a set of pre-selected questions that ISARIC has curated for a particular disease or score.

Disease templates have been generated by the ISARIC network and have followed the CRF creation process that seeks to ensure that the questions included in such CRFs are adequate and sufficient to answer pertinent research questions. If you want to know more about the ISARIC creation process, please write to data@isaric.org.

Score templates are subsets of questions necessary to compute commonly used clinical scores, for example, the Charlson Comorbidity Index or SOFA.

If multiple templates are selected, the obtained CRF is the union of the questions from all the selected templates. Additionally, the CRF can be customized. See How to Create a CRF with BRIDGE section.

How to Create a CRF with BRIDGE

To create a CRF in BRIDGE, users need to navigate the checkable tree and select the questions they want to include in the CRF. After this is done, a representation of the questions will appear in the CRF representation panel. Sometimes additional questions will appear because BRIDGE handles retro-inclusion of questions. For example, when the user checks the ‘Pregnant’ question, the ‘Sex at birth’ question is also added to the CRF.

Similarly, BRIDGE also generates and adds questions that improve electronic data collection. For example, when the user selects the question ‘Other sign(s) or abnormality,’ additional questions are added that promote the inclusion of up to five additional unlisted signs at presentation.

User Defined Questions

In addition to allowing the selection of questions for a particular CRF, BRIDGE allows further question customization in the following ways:

• ‘Select units’ question: Measurement units can be selected in questions that have the text ‘(select units)’ in the label. Users can select the units they want to include in the CRF, and BRIDGE will add the pertinent questions for this. For example, if a user selects a single unit for a question, such as cm in ‘Height,’ the numeric question ‘Height (cm)’ will be added. If the user selects multiple units, such as cm and in, BRIDGE will generate a numeric question for ‘Height’ and another radio question for ‘Select Height units’ with the selected units.

• ‘User list’ question: For particular questions, the options that are adequate for the disease and/or site can be selected by the user. The user needs to click the LABEL of the question with this symbol ↳ in the checkable tree. This will open a new window that allows users to select the pertinent options for such questions. This will generate a radio question with the user-selected options and the ‘Other’ option. It will also generate a dropdown question with the options that were not selected by the user, which corresponds to a second layer of possible options to limit free text. A third question for free text is also added and will appear in electronic capture when the ‘Other’ option in the second layer dropdown is selected.

• ‘Multi list’ question: The question with this symbol on the label ⇉ has a similar behavior to the ‘User list’ question, with the only difference being that the layer one options are checkboxes, not radios, allowing multiple selections.

After choosing the variables, users can generate the pertinent files. They need to enter a CRF name in the textbox below the CRF representation panel and click the generate button.

How to Use BRIDGE Generated Files

As mentioned, BRIDGE generates three files:

• ISARIC Clinical Characterization XML: This XML file can be used to create a project in REDCap. To do this, navigate to the 'Project Setup' section in REDCap, and under 'Design your data collection instruments & enable your project,' click on 'Upload Instrument Zip file' and upload the XML file generated by BRIDGE.

• This file creates a REDCap project with the following event structure:

• REDCap Data Dictionary CSV: This CSV file can be used to update an existing REDCap project. Go to the 'Data Dictionary' section in REDCap, click 'Choose File,' and upload the CSV file generated by BRIDGE. Click 'Upload File' to apply the changes.

• Paper-like CRF: This PDF file can be printed and used for manual data capture in sites that cannot collect data electronically. The collected data can later be entered into the REDCap database.