Store Response Outputs for Dispatch and Customer Feedback Data Destinations

DispatchClosed The term "dispatch" refers to the act of sending a form to a mobile user or customer. Typically, a dispatched form includes some information pre-filled to give the recipient context for the work to be done. Dispatch can be manual or automated (using a Dispatch Data Destination or the TrueContext REST API). and Customer Feedback Data DestinationsClosed 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. provide a way to automatically dispatch follow-up forms after a user submits a form. When a Dispatch or Customer Feedback Data DestinationClosed 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 a Data Record in the TrueContext system and generates response outputs. This topic describes how to store response outputs, such as record identifiers, for use in subsequent Data Destinations that support your downstream processes.

Dispatch Data Destinations

Available on the Advanced and Enterprise tiers:

Essentials
Advanced
Enterprise

Customer Feedback Data Destinations

Available as standard on the Enterprise tier and as an add-on to the Advanced tier:

Essentials
Advanced +Add-on
Enterprise

Contents

How response outputs for Dispatch and Customer Feedback Data Destinations work

When a Dispatch or Customer Feedback Data Destination executes, it creates a Data Record in the TrueContext system and generates response outputs. Response outputs include a unique record identifier, reference number, and single-use URL (Customer Feedback forms only).

The system stores response outputs as key-value pairs. The following example shows the response outputs for a Customer Feedback destination:

Response Outputs for a Customer Feedback form. The outputs are displayed in a table as key-value pairs. The key names are "distributionUrl", "referenceNumber", and "id".

The following table describes each Data Destination and the response outputs you can store.

Data Destination type Description Response outputs
Dispatch Automatically dispatch one or more mobile forms after a user submits a form.
Response Key
Form Submission ID id
Reference Number referenceNumber

Tip:If the Dispatch Data Destination dispatches more than one form per execution, the system stores response outputs as a comma-separated list.

Customer Feedback Automatically dispatch one Customer Feedback form after a user submits a form.
Response Key
Form Submission ID id
Reference Number referenceNumber
Single-use distribution URL distributionUrl

Examples of how you can use response outputs

You can use stored response outputs for a variety of downstream processes in TrueContext or your third-party system.

In TrueContext:

Once your data is in your third-party system, you can:

Tip: To reference response outputs in Documents and subsequent Data Destinations, use the following DREL expression:

%o[DestinationUniqueIdentifier][key]

Set up your Data Destination to store response outputs

Prerequisites

Steps

  1. Navigate to the Dispatch or Customer Feedback Data Destination that you want to set up. You can choose a new or existing Data Destination.

    From the Manage Forms menu, create or edit a Data Destination.

    • To create a new Data Destination:

      Manage Forms > Data Destinations > Create Data Destination

      Select the type of Data Destination that you want to create.

    • To edit a Data Destination:

      Manage Forms > Data Destinations > Data Destination Name > Edit DATA DESTINATION

      where Data Destination Name is the Data Destination that you want to edit.

    Info:The topics Dispatch Data Destination and Customer Feedback Destination describe how to set up these Data Destinations in more detail.

  2. Go to the Response Configuration tab and select the option to Store all response outputs for use in later destinations.

  3. Create or Update your Data Destination when you finish setting it up.

    Result: When the Data Destination executes, the system stores the details of the dispatched forms.

Info:The topic View Destination Response Outputs in the Web Portal describes how to access the response outputs stored with your Data Destinations.