Inter-App Dispatching

 

About

ProntoForms supports inter-app communication and pushing data between a third-party app and the ProntoForms app. This means that it is possible to take data from one app and dispatch it to forms in the ProntoForms mobile app.

For information on URL schema and supported actions, please read: Inter-App Communications.

 

Dispatching from a Third-Party App into ProntoForms

Building an inter-app dispatch URL uses the Open action and the form ID, form name, or form iteration ID as described in the ProntoForms Inter-App Communication documentation, and adds parameters - strings of information separated by & symbols - to push information from the third-party app into the ProntoForms app. It uses the form's question labels to tell the information where to go in the form.

When using the Form Name with the Open action to Dispatch, it is possible to have partial string matches. This means that the app will bring up a list of forms with names that are partial matches to the string. Users select the appropriate form if there are multiple matches, and the data is pushed to the appropriate question labels.

As it is a URL, the question label and the data you are trying to dispatch into the form must be percent-encoded (for more information on percent encoding, look at wikipedia's article), and each parameter must be separated by an & symbol.

Example:

prontoforms://x-callback-url/open?name=Construction+Estimate&Job+Phone+%23=416-555-0192

This example will search for a form named "Construction Estimate". If there are multiple matches, it will open the app to the Form Selection screen and prompt the user to select the correct form. Then, it fills the Job Phone # (note that %23 is percent encoding for #) question with "416-555-0192" on that particular form. 

Note: The type of data being dispatched must match the question it is being dispatched into. If dispatching into a numeric question, ensure that your data is numeric. When dispatching into a dropdown question, ensure the answer you are dispatching is one of the answers available to that dropdown question.

 

Dispatching to Multiple Questions

You can use the same URL structure to dispatch from a third-party app into a ProntoForms form. Simply add parameters after the first, each separated by an &.

Example:

prontoforms://x-callback-url/open?name=Construction+Estimate&Job+Phone+%23=416-555-0192&Job+Location=2195+Still+St.+Rogers%2C+AR%2C+72756

This would fill the Job Phone # question with "416-555-0192", and the Job Location question with "2195 Still St., Rogers, AR, 72756."

If your dispatch string contains parameters (question labels) that are not contained in the form, that data will be ignored. 

Unsupported Question and Data Types

ProntoForms does not support inter-app dispatching of information into the following question and data types:

  • Label information
  • Button Group
  • Concatenation 
  • Digit Extraction 
  • Time based math and calculations
  • Number (currency) calculation
  • Date/Time Stamp
  • Slider
  • Range Slider
  • Attachments
  • Geolocation/GPS-related questions
  • Barcode
  • Credit card
  • Multi-Select Questions

[ top ]

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments