Configure Response Data Handling for HTTP Data Destinations

When a Data Destination A Data Destination specifies where to send data from a submitted form. You can use Data Destinations to automate data sharing and storage, routing data to a specific service (such as email or cloud storage) in several different formats. executes, it creates or updates a record in TrueContext or a third-party system. Response Data Handling enables you to store response outputs, such as record identifiers, after a Data Destination executes. You can reference the output stored in a “parent” destination in subsequent “child” destinations to make sequential requests to a third-party system. This topic demonstrates how you might use response data handling with HTTP Data Destinations A Data Destination specifies where to send data from a submitted form. You can use Data Destinations to automate data sharing and storage, routing data to a specific service (such as email or cloud storage) in several different formats.. In the example, an initial HTTP Data Destination executes and sends an HTTP POST request to an HTTP server. With Response Data Handling, the initial destination captures the response from the server and stores the data as key-value pairs. The subsequent Email Data Destination executes and uses the stored values to populate an email Subject field.

Available on the Advanced and Enterprise tiers:

1. In your HTTP endpoint, configure the request and its response.

   

2. In TrueContext, configure your initial HTTP Data Destination.

3. On the Destination Basics tab, add a Destination Unique Identifier for the destination. This ID must be unique to each FormSpace FormSpaces are where forms are stored and organized in the TrueContext Web Portal. A TrueContext Team may have multiple FormSpaces, depending on their needs. Admins can set FormSpace permissions to control which users have access to the forms in that FormSpace..

4. On the Response Configuration tab, in the Response Data Handling section, select Store all response outputs….

   

5. Save the initial Data Destination.

6. Configure a subsequent Email Data Destination to use the response output stored in the initial HTTP Data Destination.

7. On the Email Headers tab, enter the following DREL 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. expression in the Email Subject Line Expression field:

   Customer: %o[http][body.customer] - Status: %o[http][body.status]

8. Save this Email Data Destination.

9. In the Form Builder The Form Builder is the tool that form designers use to create forms. In the Form Builder, accessed from the TrueContext Web Portal, form designers can add and edit pages, sections, and questions, as well as attach data destinations and configure the form's settings., add both Data Destinations to your form. The initial HTTP Data Destination must precede the subsequent Email Data Destination.

   Result: When a user submits the form, each destination executes in sequence. The Email destination sends an email with the Subject “Customer: Doctors Without Borders - Status: Pending” using the values stored in the initial destination. By default, the email is sent to the form submitter, but you can Email Recipients.

   Tip:You can use the data stored in a preceding destination in any number of subsequent destinations.