Creating asset endpoint subscriptions by using the UI

Edit online

To avoid unwanted alerts, you create a file that contains a list of asset endpoint subscriptions and upload the file to Environmental Intelligence Suite. You list only the asset endpoint subscriptions that are associated with rules that you want to receive alerts for.

About this task

Assets that do not subscribe to any criterias receive alerts for any active rules that you created using sample criterias from the Sample tab of the Criteria builder. To receive endpoint alerts for the active rules with any custom criterias, assets must subscribe to those criterias. You use the AssetEndpointSubscriptions object to subscribe an asset to single custom criteria or to a group of custom criteria.

Note: You must use criteria logical names in the subscriptions list in the AssetEndpointSubscriptions object. You can get the criteria logical name of the criteria from the Criteria detail.
Follow these rules to ensure the file upload works:
  • The file must be in JSON or CSV format.
  • The asset IDs must be unique.
  • Required fields and columns must be completed.
Note: The specified criteria or group of criteria must be associated to a rule for the notification to work. The rule defines which endpoint the alert is posted to.
Note: You can create asset endpoint subscriptions in JSON format by following this example. The asset_global_id follows the format {asset_id}.{asset_type}
{"eventCode": "objectUpsertEvent", "tenantId": "{tenant_id}", "eventDetails":
 {"businessObject": {"type": "AssetEndpointSubscriptions", "subscriptions":
 ["{criteria_name}"], "globalIdentifiers": [{"name": "eis.geospatial.globalId",
 "value": "{global_id}"}], "asset": {"globalIdentifiers": [{"name": 
"eis.geospatial.globalId", "value": "{asset_global_id}"}]}}}}
Note: You can create asset endpoint subscriptions in CSV format by following this example. The format is subscriptions,asset.assetIdentifier.
subscriptions,asset.assetIdentifier
winter_weather_warnings;summer_weather,0123456789

Procedure

  1. Prepare an asset endpoint subscriptions file by using the format in the About this task section.
  2. Form the side navigation menu, click Administration > Job management, then click New job.
  3. Select Import data as the job type and click Next.
  4. Click Add file and browse to or upload your CSV or JSON file.
  5. Select the default schema type and click Next.
  6. Review your date and click Import.

What to do next

To delete asset endpoint subscriptions by using a file, define the same configuration, but in Job Management, select Delete data. For a JSON file, set the event code to objectArchiveEvent.