Release 3.4.0

Fixed/Updated

Assessment & Evaluation

• Ability to submit partially completed forms when the assessment method allows (e.g., complete and confirm via email)

• Correctly enforce mandatory versus optional items

• Correctly visualize free-text comment boxes that are linked to scale items, including prompted, optional, and mandatory comments

• Hide & ignore validation of concerns items and form feedback items for student/resident users

• Display anchored response descriptors in-line for rubric items

• Correctly load default item responses (when enabled)

• Display form elements and items in correct order

• Improvements to Save & Submit functionalities

  • Automatically save assessment & evaluation progress without needing to click 'Save Draft' (i.e., auto-save each time a new response is selected)

  • New "Save/Submit" button that provides a secondary confirmation before saving or submitting the assessment

    • includes real-time feedback on save progress (traditional 'spinning' load icon beside the Save/Submit button while the item is saving)

    • button turns red if there is an error with saving or submitting and modal will include the error message

Calendar

• Main calendar landing page correctly lists today's events

• Upcoming page correctly lists upcoming events within the next week

Notices

• Apostrophes are properly rendered

• Ability to open previously read notices from the "Read" page

• "Pull to refresh" added to all pages

• Swipe between pages to go forward/back between notices

Added

Authentication

• Single Sign-On (SSO) and enhanced authentication options

  • The mobile app now supports different authentication flows depending on what your server is set up to support:

    • SSO only

    • dual SSO and local login/LDAP options

    • local login/LDAP only (default)

  • In order to enable SSO on mobile, you will need to update to API version 3.x to add a new endpoint that indicates which methods are supported. If you don't add this endpoint, the mobile app will default to local/LDAP login only (however, without API 3.x you will encounter other assessment errors).

  • Clicking the "Login with SSO" button will open your institution's SSO portal using a Webview. You will be automatically redirected to the standard app user-interface upon successful authentication.

Assessment & Evaluation

• Item & form navigation

  • Ability to swipe between items

  • New Save/Submit button and navigation arrows that are always accessible

• Procedure form support - new modal for selecting the procedure

• UGME EPA triggering (Queen's)- assessments can be triggered for EPAs with custom codes (e.g., EPA1, EPA2, instead of D,F,C,P)

• Assessment cues

  • ability for target to optionally enter cue for all supported assessment methods

  • visualized to the assessor on mobile when completing assessments

• Visualize EPA titles at the beginning of Rubric/Flex forms

• Visualize form instructions and free-text items in scrollable and easily identifiable information pages

• Multi-select contextual variables are now supported

• Triggering interface:

  • Honours CBME enabled setting to display only relevant courses/programs

  • Skips the course/program selector if the student/resident is only enrolled in one active CBME enabled course/program

  • Honours assessment methods settings to display only relevant assessment methods for the selected course/program

Technical Considerations

For a complete list of all issues that were merged for this release, please log in to JIRA and view the Mobile App project Kanban board. There is a filter preset for fix version 3.4.0.

• React-native and react-navigation upgraded to version 4

  • Cleaned up the way that assessment and evaluation data is handled

  • Removed a number of deprecated react native components

  • Removed legacy reducers including

    • assessment details reducer, assessment save progress reducer, & assessment draft reducer

  • Improved navigation flows

    • moved all navigation logic to root

    • updated navigation stacks

    • removed deprecated navigation code

• New and updated API endpoints. Please upgrade your API version to 3.x (compatible with ME 1.16 and 1.17 releases) or you will encounter difficulties with triggering assessments. The following features absolutely require the newest API version, or cherry-pick the commits:

  • new auth flow (API-28)

  • procedure form modal (APP-124)

  • Queen's UGME EPA triggering (APP-151)

  • cbme_only flag (APP-133)

  • aprogress_id 500 error (APP-144)

  • assessment cue for self-assessment method (APP-186)

  • email blank form to external assessor (APP-195)

Implementation Notes:

In addition to the comments above regarding the API, please note the following PRs that may need to be cherry-picked to ME (these are merged in release 1.17.1, only prior releases need to cherry-pick):

• The /assessments/courses endpoint has been modified to accept a cbme_only boolean flag that will limit the course picker to only CBME courses if the flag is enabled. You will also need this PR to receive the flag from ME:

  • https://elentra.atlassian.net/browse/ME-2894