The Amazon Web Services (AWS) SNS output in ArcGIS Velocity allows you to write output features or values created using Arcade to Amazon Simple Notification Service (SNS). SNS is a fully managed pub or sub service for A2A (application to application) and A2P (application to person) messaging. Velocity uses the AWS SNS output to integrate and decouple distributed applications and provide notifications through SMS texts, push notifications, and email using the Amazon SNS platform.
Example
The following is an example use case for the output:
When a certain spatial or attribute condition is identified by an Velocity real-time analytic, the AWS SNS output can send features or messages built using Arcade to Amazon SNS, which can then be configured to send app push notifications and text messages to a field worker.
Usage notes
Keep the following in mind when working with the output:
The secret key is encrypted the first time the analytic is saved, and it is stored in an encrypted state.
The following output data formats are available:
- Delimited
- JSON
- GeoJSON
- EsriJSON
Note:
Alternatively, you can configure an Arcade expression to control the message sent to Amazon SNS.
Data exported in the JSON format provides geometry in the EsriJSON format.
- Certain Amazon SNS actions are required for your user policy associated with the provided Amazon key for Velocity to connect and write to an Amazon SNS Amazon Resource Name (ARN).
Parameters
The following are the parameters for the output:
| Parameter | Description | Data type |
|---|---|---|
Access key | The Amazon access key ID for the S3 queue, for example, AKIAIOSFODNN7EXAMPLE. | String |
Secret key | The Amazon secret access key for the S3 bucket, for example, wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY. Velocity uses the provided access key to load specified data sources into the application. The secret key is encrypted the first time the analytic is saved and is stored in an encrypted state. | Password (string) |
| Region | The region associated with Amazon SNS, for example, s3.us-east-1.amazonaws.com. | String |
| Topic ARN | The ARN identifier for the SNS topic, for example, arn:aws:sns:us-east-2:541649011075:yourSNStopicName. | String |
| Subject (optional) | A subject for the Amazon SNS messages. | String |
Configure message from an Arcade expression | The message constructed using an ArcGIS Arcade expression. When you choose this parameter, the Message option appears. The expression is configured in the Arcade expression builder, accessed by clicking the Configure an Arcade Expression option under the Message option. | Arcade expression |
| Send feature to AWS SNS in specified format | The feature sent to AWS SNS in a specified format. When you choose this parameter, the Data format option appears. The default data format option is GeoJSON. Other supported formats are EsriJSON, Delimited, and JSON . | Data format type |