Looking for information about ProntoForms features and functionality? Visit our Product Documentation Portal.
ServiceMax users can specify x‑callback parameters. These parameters tell the ProntoForms app what to do when a user submits or discards a form, or when there’s an error. The ProntoForms app can bring ServiceMax Go back to the foreground and send it the submitted form data and metadata.
This topic describes how to specify x‑callback parameters using a ServiceMax App‑to‑App User-defined Custom Action.
Tip:You can’t specify x‑callback parameters for the URL Action Type. For a URL Action Type, the front-line workers must manually switch back from the ProntoForms app to the ServiceMax web page.
Note:Make sure that you meet the Prerequisites for Using App‑to‑App Communication with ServiceMax Go
Steps to specify x‑callback parameters in ServiceMax
Do you have a ServiceMax User-defined Custom Action configured with a ProntoForms inbound App‑to‑App request?
If yes, edit the existing custom action.
If no, create a custom action using the steps described in the topic Open and Prepopulate a ProntoForms Form from the ServiceMax Go App.
Configure the x‑callback parameters to include in the request from the ServiceMax app to the ProntoForms app as follows:
For the Parameter Name, enter the ProntoForms callback parameters as described in the following table.
When… The system triggers an… the user saves or sends a form, or when they transfer a ProntoForms Teamwork-enabled form
the user cancels an action, such as discarding any changes made to the form
the system can’t complete the requested action and generates an error
Note:To make sure that the user always returns to the ServiceMax Go app, you must configure all three x‑callback parameters.
For the Parameter Value Type, select Value.
https://go.servicemax.iolaunches the ServiceMax Go app.
Do you want to return the submitted form data from ProntoForms to ServiceMax Go?
If yes, you must configure the x‑success callback parameter value as per the ServiceMax documentation.Note:
Your ServiceMax app must be configured to handle the callbacks and any data returned from ProntoForms. You might need to check with your own experts to set this up for your specific app.
Use the ProntoForms Form Builder to configure custom callback parameters.
We recommend that you configure a custom App‑to‑App allow list to manage the apps that can receive data from ProntoForms.
If no, go to step 4.
Select Save and Close.
Is the configured custom action part of an active wizard?
If yes, go to step 6.
Test the configuration.
Launch the ServiceMax Go app, open a work order, and select the configured custom action.
Result: ServiceMax Go launches the ProntoForms app. When a user submits or discards a form, or when there’s an error, the callbacks are triggered. The system brings the ServiceMax Go app back to the foreground and if configured, returns the ProntoForms form data.