Flask
Flask was built to help the user visualize their study before submitting the app to the Apple Appstore. A way to test their study as they build it. To gain access to Flask, you need to do the following:
- Download Flask
iOS: https://itunes.apple.com/us/app/axon-prod/id1160464791?ls=1&mt=8
Android: https://play.google.com/store/apps/details?id=com.medable.axon.flask
iOS Only
You are now presented with an Environment Picker, Organization search, and Study search.
Environment Selector - Choose the right environment
Prod - URL for your organization looks like this https://app.medable.com/example/sign-in
Dev - URL for your organization looks like this https://app.dev.medable.com/example/sign-in
Organization Search - Allows you to search for your organization. You can get your organization name from the URL for the Web Portal. Example: https://app.dev.medable.com/example/sign-in
Study Search - Allows you to select or search for studies in that organization
First Run
On first run of the Flask App:
- The app will show 3 tutorial welcome screens which can be customized before the app is published to the Apple App Store. NOTE: In a future iteration, you will be able to update these screens from the Researcher Portal in the study information section.
- Enter your Organization Name. This name is in the URL of the Researcher Portal. Example URL: https://app.medable.com/example/sign-in. In this instance the Organization name is "example."
- Pop-up screen with a list of studies in your Organization. Choose the one you want to test.
- If you do not have an Axon org, you can connect Flask to the example org. For an introduction to flask through the example org, download this easy to follow guide and learn more about Axon.
Flask App Navigation
Flask navigation runs along the bottom of the screen. Below is an explanation of each navigation tab.
Activities
The activities screen shows all available activities a user can complete. If the activity is set to a schedule that is not "Always Available" the activity will show in the completed section once it is completed.
Resources
This sections displays all of the study information from the Researcher Portal. Please refer to the Study information section of this guide to see the information you can add to this tab. Each record is a selectable section in the resources tab.
Profile
A user can view their profile from this screen. They can logout or leave the study. Leaving the study will not actually remove the user from the study. This function simply resets the app back to the tutorial pages. Since leaving a study has many different protocols, the process for leaving a study can be customized to your specific use case.
How does Flask Work?
Flask will do the following when displaying a study in the app:
- Flask will check to see what type of Enrollment the selected Study is configured for and shows the appropriate screens for that configuration. For example, if it is a Limited Enrollment Study, Flask will show the Email and Access Code screens first before showing the user anything else.
- Flask will evaluate all tasks in the public group and present them according to the flow rules defined for the public group
- Flask will present the login screen or allow you to sign up. If there is no authentication task in the public group, the app will give you an error if you click sign up.
- Once you are logged in, Flask will present all tasks in the group that the authenticated user belongs to and it will follow all flow rules in that group to present tasks to that user. If no tasks are assigned to that group, the user will receive an empty activities screen.
Updated 4 months ago