Amazon SNS Data Destination

Contents

Available on the Enterprise tier only:

Essentials
Advanced
Enterprise

About

The Amazon SNS data destination routes data from submitted forms and activates applicable notifications or processes configured in Amazon SNS. This data destination is intended for use by enterprise customers and system integrators, and is typically used in conjunction with other Amazon web services (like Amazon S3, SQS or Amazon data pipeline). For example, data collected by mobile forms could be stored in S3, and a separate system to process the data could be activated via an SNS message.

Data destinations automatically back up data collected in the field. They reduce the need to visit the web portal by making submitted forms available through the services you already use. Different documents can also be sent to different services with a single form submission. Read here for more information on data destinations.

Amazon SNS (Simple Notification Service) is a flexible messaging service that allows messages to be transmitted to a variety of endpoints - whether the recipient is human or a distributed service. A single SNS "topic" or access point can use multiple notification delivery methods.

Several common cloud application design patterns can make use of the SNS service, and SNS can also be used for other advanced notification requirements (SMS, HTTP/HTTPS, Email/Email-JSON).

Connection

SNS Topic ARN

When you create a Topic in SNS, the topic is used to create a unique identifier or Amazon Resource Name (ARN). This identifier is is used to access the topic. To find the ARN, simply view the topic in SNS. Information about the topic (including the ARN) is displayed at the top of the page.

Connection Configuration

Set up an Amazon Web Services Connection or use an existing connection. To set up an Amazon SNS 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., your AWS account must have the sns:Publish IAM permission.

Subject

Use Data Reference Expression Language to build a subject that contains data from submitted forms.

  • %f - to sort submissions into folders named after the form.
  • %u - to sort submissions into folders named after the user submitting the form.
  • %a[Question Label] - to sort submissions into folders named with the answer to a chosen question.
  • Optionally add static text for formatting - eg.  "%f -- %a[Customer Name]"

For example, entering "A %f has been completed for %a[CustomerName]." could send a notification with a subject like "A General Inspection Form has been completed for Company ABC." Note that for some notification types (like SMS), the subject is all that will be sent.

Message

Use Data Reference Expression Language to build a message that contains data from submitted forms (see examples above). Please note that some notification types (like SMS) will only include a subject, not the message, in the notification.

Testing and Troubleshooting Data Destinations

Data destinations should be configured and tested carefully before using them in production. This is key to ensuring that TrueContext data is received correctly. Please consult the recommendations for testing and troubleshooting data destinations.