ThingWorx Model Definition in Composer > Modeling > Things > Alerts > AddOrUpdateAlert Service Attributes
AddOrUpdateAlert Service Attributes
The attributes parameter on the AddOrUpdateAlert service is an infotable with no defined Data Shape. Because of this, the Execute button for the service does not allow you to define the infotable for this parameter. The infotable expected by this service varies depending on the type of alert and the base type of the property configured for the alert. In order to call the AddOrUpdateAlert service, the infotable must be dynamically configured as described in the tables below.
Parameter Definitions
Parameter
Definition
value
Specifies the target value, used in EqualTo / NotEqualTo or DeviationAbove / DeviationBelow alerts.
limit
Specifies the threshold value when used in Above / Below alerts.
Specifies the minimum amount that a value must deviate from the target to trigger DeviationAbove / DeviationBelow alerts.
limitInclusive
Includes values equal to the limit value in the comparison.
minimum
The lowest target value for InRange / OutOfRange alerts.
minimumInclusive
Includes values equal to the minimum in the comparison.
maximum
The highest target value for InRange / OutOfRange alerts.
maximumInclusive
Includes the values equal to the maximum in the comparison.
BOOLEAN
Alert Types
Expected Attributes (Infotable's Data Shape)
EqualTo / NotEqualTo
value: BOOLEAN
DATETIME
Alert Types
Expected Attributes (Infotable's Data Shape)
Above / Below
limit: DATETIME
limitInclusive: BOOLEAN
EqualTo / NotEqualTo
value: DATETIME
InRange / OutOfRange
minimum: DATETIME
minimumInclusive: BOOLEAN
maximum: DATETIME
maximumInclusive: BOOLEAN
DeviationAbove / DeviationBelow
value: DATETIME
limit: NUMBER
limitInclusive: BOOLEAN
units: STRING, one of the following values:
S - seconds
M - minutes
H - Hours
D - Days
N - Months
Y - Years
INFOTABLE
Infotable alerts trigger changes to the row count in the infotable.
Alert Types
Expected Attributes (Infotable's Data Shape)
Above / Below
limit: INTEGER
limitInclusive: BOOLEAN
EqualTo / NotEqualTo
value: INTEGER
INTEGER, NUMBER, and LONG
Alert Types
Expected Attributes (Infotable's Data Shape)
Above / Below
limit: <BASETYPE>
limitInclusive: BOOLEAN
EqualTo / NotEqualTo
value: <BASETYPE>
InRange / OutOfRange
minimum: <BASETYPE>
minimumInclusive: BOOLEAN
maximum: <BASETYPE>
maximumInclusive: BOOLEAN
DeviationAbove / DeviationBelow
value: <BASETYPE>
limit: <BASETYPE>
limitInclusive: BOOLEAN
LOCATION
Alert Types
Expected Attributes (Infotable's Data Shape)
EqualTo / NotEqualTo
value: LOCATION
DeviationAbove / DeviationBelow
value: LOCATION
limit: NUMBER
limitInclusive: BOOLEAN
units: STRING, one of the following values:
M: Miles
K: Kilometers
N: Nautical Miles
STRING
Alert Types
Expected Attributes (Infotable's Data Shape)
EqualTo / NotEqualTo
value: STRING
Example
Refer to this article for an example on using the AddOrUpdateAlert service.
Related Links
Was this helpful?