Configure App‑to‑App Custom Callback Parameters

This topic describes how to use the TrueContext Form Builder to configure custom callback parameters. It describes in detail how to define parameter names and corresponding DRELClosed Data Reference Expression Language (DREL) is used to get form data and metadata and add it to a string, such as dates, usernames, or answers to questions in forms. expressions to retrieve and share form data and metadata between apps on a mobile device.

Available on the Advanced and Enterprise tiers:




The following limitations apply to custom callback parameters:

Info:The DREL expression can contain multiple DREL references, static text, or a plain text string, such as JSON.

Steps to configure App‑to‑App custom callback parameters

  1. From the Manage Forms menu, navigate to the form you want to set up.

  2. Select Edit Form, and then select Settings > Workflow settings.

  3. In the App‑to‑App Callbacks section, define up to five parameter names and associated DREL expressions.

    The following example shows custom parameters that return the

    • answers to two of the questions on the form

    • unique identifier of the form on the mobile user’s device (clientDataRecordId), and

    • date and time that the user submitted the form.

      App-to-App Callbacks section with four parameters and corresponding DREL expressions defined. For example, Parameter = JobStartDate (to match the source app) and %a[Job - start date], which returns the answer to the question with that unique ID

      • The DREL expression can contain multiple DREL references, static text, or a plain text string, such as JSON.
      • You can use DREL properties to define the format of form submission dates and times.
      • If you want to rename a standard parameter that’s returned by default with the x-success callback, you can include it in the custom parameters. In this example, the clientDataRecordID value is returned as the custom callback parameter “RecordID”.

    Info:The topic DREL Quick Reference provides information about how to construct a DREL Expression.

  4. Save the form or continue editing.

    The x-success callback is triggered when the mobile device user saves or sends a form or transfers a TrueContext Teamwork-enabled form. The x-success callback opens the success URL and returns the standard and custom callback parameter names and values:


    Tip:In this example, the clientDataRecordID value is passed twice, once with the standard parameter name and also as a custom callback parameter with the name RecordID.