| Multiexcerpt include macro | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
Web apps can be used for:
...
While this feature allows you to test the most recent version of your application without having to deploy any changes, we do recommend deploying new versions of your application occasionally. This will allow you to have checkpoints to revert your application to in case you make a change that you cannot fix or breaks your application.
We recommend using the 1 question per screen setting, as multiple questions per screen can cause some slowness and performance issues. To enable this, select the ‘Settings’ button from the home screen of ‘Live Preview’ and select enable for this setting.
You can view any other languages you might have configured for your application by proceeding the ‘Settings’ page of Live Preview.
Be sure to sync to receive the latest data for your application, especially when using the 'Login As' functionality.
Limitations
Same limitations as Web Apps..
User-controlled repeat groups (i.e. Repeat groups where the user defines how many repeats to input) do not currently work. Repeat groups where the repeat count is pre-defined should work.
...
Some icons and images on questiosn may not work. Prior to deployment, we highly recommend testing on a mobile device first.
CommCare for Web Users
Web Apps
Users can access web apps by clicking on "Web Apps" at the top of the page. Note that the apps that appear here are the latest released version of the application, to ensure that your latest test changes don't affect current web apps users! This allows for more robust testing and use of the application, as it allows you to preview more than just the form as described in the section above.
To enable your application in Web Apps, see the setting up web apps section, here.
NOTE: Please note that there are several other known limitations with Web Apps that could affect web users experience, found here.
Login As Feature
In both Web Apps and in the Application Preview, there is a feature known as ‘Login As.’ This functionality allows a web user to access a form as if they were a mobile user from their project space. This is another powerful tool that allows you to truly experience what your application will look and feel like from the perspective of a mobile user. Please note that any forms or data submitted while using the Login As feature will be treated as live data and will appear in exports and reports as such.
...
To enable the Login As feature, you need be logged in as a Web User with certain permissions. The user’s Web User Role will need to have permission to do the following in your project space:
...
Any data submitted this way will be done so as if you were that mobile worker. The data will appear in exports and reports as such.
Any limitations that would apply to a mobile worker in Web Apps.
The only way to confirm a form was submitted on behalf of a mobile worker by a Web User, is to find the specific form itself. You can do this by searching for submissions in the Submit History. Once you find the form in the submit history, there will be a note at the top that states 'Submitted by Web User <name> on behalf of Mobile Worker <name>':
...
For more information on the Login As feature, please see this document.
...
CommCare for Mobile Workers
Lastly, you can also use your mobile username to view your case list and fill out forms on the web just as you would on a mobile phone.
...
You can upload an image in Application Settings to use as the logo of your app on the main Web Apps page, in place of the CommCare logo.
General Web Apps Notes
How to restrict Mobile workers from accessing certain Web Apps?
It is possible to limit a mobile worker’s access to certain Web apps.
'Web Apps Permissions' page (Legacy) - This legacy feature was available through this feature flag. It used mobile worker groups to limit access to specific apps. This involved creating user groups and using the 'Web Apps Permissions' page to define which group has access to each Web App in the project.
This functionality is now available via the roles and permissions page, where the permission for accessing web apps supports specifying a list of apps. The Web Apps Permissions page offers instructions to migrate to the new settings.
...
'Roles & Permissions' page (New) -
The Roles & Permissions modal has a section to manage Web Apps access. The dropdown for ‘Use Web Apps for online data entry’ offers three options -
No Access - Users of a given role would not be able to access web apps.
Access All - Users of a given role would be able to access all the web apps
Limited Access - this can be chosen to customize which web apps the given role could access.
...
Which version of my app is Web Apps using?
...
If a Web User is using the Login-As feature, a similar message using the localized name of the form will appear at the top of their screen after a form is successfully submitted without any of the form submission, case, or exporting data links.