Creation of a Registry: Workflows for Design and User Modes¶
Overview¶
There are two basic modes in which RDRF is intended to be used: Design mode (for creating new registries) and User Mode (for adding/editing and viewing patient data in a registry that has been created).
Only administrators can add new registries, forms, sections or data elements.
Important Point: Once data elements and sections are created they can be used by more than one registry. But altering a data element or section that is in use will immediately affect any registries which use it.
Additionally, a public interface is provided when a registry form is nominated to be a questionnaire. See questionnaires.
Roles¶
Each workflow in RDRF is intended to be performed by a user with a distinct role.
Admin¶
- Can do anything
- Create and modify registry definitions
- Import and Export registries
- Manage user permissions
Curators¶
Manage membership of patients in working groups within a registry
Clinicians¶
Enter and view data on patients in a working group within a registry
Design Mode Workflow¶
Modelling¶
- Do this first on pen and paper!
- Gather requirements of the data fields ( “DEs” ) required
- For each data field required, decide its datatype. If a field is logically a range, work out the allowed permitted values. Depending on the datatype, decide any validation rules for a numeric or float data type (max and/or min), and for a string data type, the maximum length or pattern. Decide if any Derived Data Elements (calculated data type) are required.
- Split them into logical groups (sections). Decide whether a section might be multiple
- Portion related sections into forms
- If a questionnaire is required for the registry, nominate a single form as a questionnaire
Creating a Registry¶
Assuming all Data Elements (DEs) have already been created
- Admin logs in and navigates to “Registries” from “Admin Page”
- Admin clicks on green “Add” button
- Admin fills in Name, code and description of registry (code must be unique and not contain spaces)
- Admin pastes a html splash screen into the Splash screen field (this will be linked to on the main page)
- Admin navigates to “Registry Forms” from “Admin Page” and for each desired form in the registry, clicks the green “Add” button.
- Admin Selects the registry just created from the drop down list
- Admin enters a name into the name field (this name will appear on the form, eg “Physical Info”)
- Admin enters a comma-separated list of form section codes (E.g. “FHPhysicalSection,FHPersonalitySection,FHAmbulatorySection” (Note: The codes should be unique and have no spaces - no quotes! - prefixing with registry code is conventional but advised). If the form is intended to be a public questionnaire form, check the questionnaire checkbox
- Save the form definition
- For each section referred to in the comma separated list, add a section object by navigating to “Registry Sections” from “Admin Page”
- Click the green “Add” button and enter the section code (used in the form definition)
- Enter a display name for the section (this will appear on the form above the fields defined for the section)
- Enter the DE codes of any fields required in the elements list (as a comma-separated list) E.g. “CDEName,CDEAge,CDEHeight” (Note- The system will check whether any entered DE codes exist when the section object is saved - if any DE code cannot be found in the system, the section object will not be created)
User Mode Workflows¶
Adding a user (curator or clinician, or genetic staff)¶
- Admin logs in
- Clicks on “Users” from the “Menu” button
- Clicks Add User button on right
- Enters Username and password
- Clicks Next
- Enters personal information
- Checks “Staff Status”
- Control-Clicks Working Group Curators for curator (or Clinical Staff for clinician, or Genetic Staff for genetic staff)
- Control-clicks the required working groups and registries (if more than one)
- Clicks save
Adding a Patient to a Registry¶
- Curator or clinician logs in
- Click “Add Patient” (or click on the Patients name to edit patient)
- Control-click on each registry that is listed that you would like the patient to be a member of (NB. If a clinician or curator has access to only one registry, it will already be assigned)
Entering (and viewing existing) Demographic Data for a Patient¶
- Login as a clinician
- Click the Patient’s name in the Patient column of the Patient List
- Edit contact details for the patient
- Click Save button
Changing Working Group for a Patient¶
- Login as curator
- Click the Patient’s name in the Patient column of the Patient List
- Select required working group (NB. workings group in the dropdown will only be those for which the curator has access)
Entering / editing existing Clinical Data for a Patient¶
- Login in as a clinician
- If clinician has access to more than one registry a drop down of registries is shown in the search area, otherwise no registry dropdown will appear and all operations will occur in the one registry
- Click the “Show Modules” button in the patients list for the required patient - a pop up of available forms will appear (except if there is only one defined clinical data form)
- Click the desired clinical data entry form
- The screen will show the required form
- Edit and click Save
Approving/Rejecting a Questionnaire response¶
- Curator or clinician logs in.
- Click “Questionnaire Responses” under “Menu”
- Click “Review” under “Process Questionnaire” to approve/reject a questionanaire
- User reviews information in the submitted form and clicks approve (or reject)
- If approve is clicked, a new patient will be created in the registry and working group indicated in the form
- If reject is clicked, no patient record will be created
Adding a new working group¶
- Admin logs in
- Click on “Working Groups” under the “Menu” button
- Click the green “Add” button
- Enter name and save
Changing the Working Groups of a Curator¶
- As an admin, click on “Users” under the “Menu” button
- Click on the username of the curator required
- Control-click (command-click for Mac) on each working group in the combo box required for that user (a curator in 2 working groups will see patients in both groups)
- Click the Save button
Assigning a curator (or clinician) to a registry¶
- As an admin, login and then click on “Users” under the “Menu” button
- Click on the username of the user required
- Control-click (command-click for Mac) on each registry the user is meant to have access to
- Click the Save button
Adding Genes¶
- Admin logs in
- Click on “Genes” under the “Menu” button
- Click on “Add” and add details
- Click Save
Adding Laboratory¶
- Admin logs in
- Click on “Laboratories” under “Menu”
- Click on “Add” and add details
- Click Save