This page documents recently released REDCap versions and the dates installed on our standard REDCap system. Each release may also include changes to features that are not implemented at the University of Alberta, minor bug fixes and security fixes. Any such changes are omitted from these notes. If you require information relating to bug fixes please contact the helpdesk.
The validated install of REDCap uses the LTS release. We do not publish release notes for LTS, however each LTS release contains features that are included in these notes for versions with a lower number.
Major bug fix: For CDIS users, when background CDP/DDP fetches process larger clinical data pulls, the background workflow can stop before all selected data is processed and records can remain incomplete.
Major bug fix: If a calc or CALCTEXT field utilizes the Form Status field of a survey instrument, there are some scenarios in which data could be entered on the survey corresponding to the Form Status field, but the calc/CALCTEXT field would mistakenly not get triggered accordingly. (Ticket #274461)
Major bug fix: The Form Status values for some survey responses might have mistakenly ended up in a confused limbo state if a participant completed a survey and mistakenly bypassed one or more required fields on the survey due to a bug in REDCap 16.0.13 LTS or 16.1.1 Standard. In that situation, if a user viewed the response afterward (i.e., on the data entry form), the response would be automatically set permanently as a Completed response (this is not necessarily the desired behavior but just a by product of REDCap trying to resolve the confused/limbo state of the Form Status value). The fix here in this version (which applies SQL automatically during the REDCap upgrade) will revert those confused limbo responses to be set back to being Incomplete/Partial survey responses. However, the other responses that have inadvertently been converted to Completed responses already (by virtue of simply being viewed before the upgrade) will unfortunately not be able to be fixed retroactively by this fix here. (Ticket #272518b)
Bug and security fixes.
Improvement: When adding/editing the MyCap task in a MyCap-enabled project, users can also use the rich text editor for Intro page instructions and Capture page instructions for a couple of active tasks (Audio Recording and Selfie Capture) so that its formatted contents will appear in the MyCap app when a participant starts that task.
Bug and security fixes.
Note that as part of the installation of this release, and for security reasons, we have deleted code files relating to previous software versions. As a result, any bookmarks that specifically reference pages from earlier versions will cease to function.
Bug and security fixes.
Improvement: For MyCap-enabled projects, on the MyCap Participant Management -> Messages tab, users can now download a CSV file of all messages (such as Inbox, Outbox, and auto-generated ones like Joined, Rejoined, and Deleted) from all participants (if there is at least one message).
Improvement: The Add / Edit Records page now lets users set some preferences, such as to remember the last search target in the Data Search section, as well as to force searches to go to the Record Home Page of the record. In multi-arm projects, users can now have it maintain arm selection with Record Status Dashboard so the the Add/Edit Records page is sync'd arm-wise with the RSD page. Also, the Add/Edit Records page will remember and pre-select the last arm that was selected on that page.
Improvement: The Data Dictionary Codebook page now includes a download icon next to each instrument listed in the Instruments table at the top of the page, in which clicking on the icon will download the Instrument Zip file of that instrument. The icon will only appear to users with Project Design privileges. (Ticket #271536)
Bug fixes
Bug & security fixes
New feature: age_at_date() function - Calculate a person's age in years using their date of birth and another date. By default, an integer will be returned. If you wish to return the age in decimal format (e.g., 0.24 years for a newborn), append the parameter 'returnDecimal', which must be either false (default) or true. If datetime fields are provided, the time component of the datetime value will be ignored. Note: This function does not use leap year approximation like datediff() does, so the result will always be accurate.
Improvement: The rows of the Record Status Dashboard table will now be highlighted if hovered over or if they have keyboard focus.
New feature: The "Edit Project Settings" page for a given project now contains a project-level override for the system-level setting "File Repository upload max file size", which dictates the maximum file size of individual files uploaded by users to the File Repository.
Bug and security fixes.
Improvement: Users copying mappings to multiple events had to toggle each row individually, so the dialog now uses a sticky table header with a select-all checkbox, switch-style row toggles, and truncated event/arm labels with missing-data placeholders.
Improvement: When sending MyCap message/announcement to MyCap participants or editing a MyCap announcement, users can send it immediately or use the "Schedule at a certain date/time" option to schedule a MyCap message/announcement at a specific date/time so that the participant will receive that message/announcement at that date/time in the MyCap app.
Improvement: Additional project-level stats are shown on the Project Home stats table, such as when the project was created, when moved to production, and when moved to analysis/cleanup status.
Accessibility improvement: Keyboard users are now able to navigate to the date/time-picker for date/time fields on surveys and forms. Previously, they were not able to do so because tabbing would skip over the date/time-picker entirely. Additionally, screenreader users are now able to navigate inside the date/time-picker.
Accessibility improvement: Some issues with regard to the usage of HTML “BR” tags in field labels on forms and surveys have been fixed/improved.
Improvement: When adding/editing the MyCap task in a MyCap-enabled project, users can also use the rich text editor for task instruction and completion steps so that its formatted step contents will appear in the MyCap app when a participant starts that task
Improvement: When adding/editing the MyCap “About” page in a MyCap-enabled project, users can also use the rich text editor to add/edit “About” page contents so that it is possible to display the formatted page contents in the MyCap app.
Improvement: When calling the API method "Export a List of Files/Folders from the File Repository", it now also returns the unique User Role (as "role") and unique Data Access Group name (as "dag") for any folder that is role-restricted and/or DAG-restricted, respectively.
Improvement: The record and DAG drop-down filters for Data Quality rules have been enhanced so that multiple records or multiple DAGs can be selected at the same time, in which any DQ rules that are executed will only be executed on the selected records/DAGs.
Improvement: The "Project Statistics" table on the Project Home page now displays the number of instruments in the project, and if longitudinal, it also displays the number of events/arms.
Improvement: Custom field validations with “email” datatype (i.e., as defined in the redcap_validation_types database table) can now be used for the Designated Email Field and for survey invitation recipients, including ASIs. (Ticket #267892)
Improvement: The locking/e-signature settings found on the Record Locking Customization page in a project can now be exported and imported via a Project XML file.
Improvement: Several new categories/classifications were added to the “Standardized Field (CDE)” search feature (formerly known as the “Field Bank”).
Improvement: The calendar table on the Calendar page is now much wider to fill out the page better and allow more text to be viewed for individual calendar events.
Accessibility improvement: Descriptive Popups are now more accessible when using screen readers on surveys and data entry forms.
Improvement: In a MyCap-enabled project, the MyCap Participant List now contains a “Last accessed” column that denotes the last time the participant accessed the project in the MyCap app.
Improvement: In a MyCap-enabled project, the Messages->Announcements tab on the MyCap Participant Management page now has search functionality (similar to the search functionality currently on the Inbox and Outbox tabs). In addition, the Inbox, Outbox, and Announcement tabs now have a new option to filter by specific text in the message.
Accessibility improvement: If Multi-Language Management is enabled on a survey, the “lang” attribute for the “html” tag on the webpage will now be appropriately set to the MLM language code if it corresponds to an ISO 639-1 language code.