Looking for information about ProntoForms features and functionality? Visit our Product Documentation Portal.
- Configuring Push Notifications
- Suppressing Push Notifications on Specific Actions
- Push Notification Hierarchy
Push notifications let your mobile app users know instantly when there is something new for them on the ProntoForms app. ProntoForms uses "native push" -- even if the app is not running on the device, a notice pops up and invites you to click, start the app if necessary, and perform a send/receive with the server.
What is Pushed?
Notifications may be pushed if one of the following occurs:
- A new form dispatch is assigned to your user account
- A new form is added for a user (newly created, copied, etc.)
- An existing form is updated
- The content of a data source or form resource is updated
Note: Users will only get a push notification if they have "can submit" permissions on the form or data source that has changed.
Depending on the device notification configuration, an initial prompt will normally show in the device notifications area. Selecting the notifications area will show details. Tapping on the notification text will launch ProntoForms and begin a normal reconcile to download the updates.
To enable push notifications in your ProntoForms solution, follow the steps for both the ProntoForms server and on the mobile device. Follow the links below for details:
- Turning Push Notifications On/Off
- Enabling Push Notifications on Your Mobile Device
Administrators making changes in the web portal generates many push notifications to mobile users. Some mobile users may find this undesirable. Administrators can check the "Suppress Push Notifications for this Action" option at the bottom of "create" or "edit" pages. This gives administrators the ability to make a series of changes without notifying users until the end. For more information about which actions have suppressible push notifications, follow this link.
The option to suppress push messages has also been added to the REST API call for Updating a Data Source (Lookup).
Please keep in mind that the formspace push notification setting will take precedence over the team level setting. This allows a team to turn on push notifications globally, and then turn off push notification just for specific formspaces (like testing formspaces).
When using the "Suppress Push Message notification..." option, it will override the formspace and team level setting. The hierarchy is therefore:
- Data Source (or any Create/Update user action that has the "Suppress Push Notification" option.
Please note that you can only configure push notifications at the FormSpace or team level; you cannot permanently enable push notifications for data source updates.