Triggers

Overview

Triggers define the respective condition(s) upon which an Automation Rule will be be run against a Tile that has been aggregated into your respective Stack.

Operations

Stackla supports a range of comparison, logical, element, elevation and array query operators, allowing clients to define complex triggers to best define their Automation Rules.

These operations can be utilised when defining Rules via the Rules API

Comparison Query Operators

Operator Description
$gte Matches values that are greater than or equal to a specified value.
$gt Matches values that are greater than a specified value.
$lte Matches values that are less than or equal to a specified value.
$lt Matches values that are less than a specified value.
$eq Matches values that are equal to a specified value.
$ne Matches all values that are not equal to a specified value.

Logical Query Operators

Operator Description
$and Joins query clauses with a logical AND returns all documents that match the conditions of both clauses.
$or Joins query clauses with a logical OR returns all documents that match the conditions of either clause.
$nor Joins query clauses with a logical NOR returns all documents that fail to match both clauses.
$not Inverts the effect of a query expression and returns documents that do not match the query expression.

Element Query Operators

Operator Description
$exists Matches documents that have the specified field.
$type Selects documents if a field is of the specified type.

Elevation Query Operators

Operator Description
$regex Selects documents where values match a specified regular expression.
$where Matches documents that satisfy a JavaScript expression.

Array Query Operators

Operator Description
$all Matches arrays that contain all elements specified in the query.
$elemMatch Selects documents if element in the array field matches all the specified $elemMatch conditions.
$size Selects documents if the array field is a specified size.

Fields

Automation Rules supports any field available within the Tile data being used in a defined condition within the Trigger.

Listed below are some of the key parameters which could be considered when defining an Automation Rule via the Rules API.

Field Description
claimed Defines whether the Tile has been Rights Managed
geohash Location expressed in a short alphanumeric string
lang Identified Language on Tile
image_tags Visual Recognition Concepts
location.name Name of Location associated with Tile
media Media Type of the Tile
message Text Message associated with Tile
name Username associated with Tile
user User Handle associated with Tile
stackla_sentiment_score Sentiment Score applied to the Tile
tags Tag(s) applied to the Tile
terms Term(s) in which the Tile has been aggregated through

Back to Top