thing.find Action

Action

This trigger action is found under the Thing heading.

Canvas

When dragged onto the canvas, the appearance of the action is a rectangle with two routing points.

The left routing point (red) is the failure route. This route will be taken if there is an error during execution.

The right routing point (green) is the success route. This route will be taken if action executes successfully.

Form

Thing Identifier Parameters


Name	Type	Description
thingKey	String	The identifier of the thing that the connection is related to. For example, it can be the thing key associated with the trigger event: $(event.thing.key).
esn	String	Esn of the thing
iccid	String	Iccid of the thing
imei	String	Imei of the thing
imsi	String	Imsi of the thing
meid	String	Meid of the thing
msisdn	String	Msisdn of the thing

Action Variable


Name	Type	Description
$(action.X.`field`)	Array	A field from the thing data structure.

To access data within the thing structure, you would construct the path to the data and replace field with that path. For example, to access the key of the thing, replace <field> with name: $(action.X.key).

More examples:

$(action.2.name)
- 2 is the index of the action being referenced
- name is the element of the thing structure to be used
$(action.1.properties.propertyKey.value)
- 1 is the index of the action being referenced
- properties is the thing's property substructure
- propertyKey is the key of the property
- value is the value of the property to be used
$(action.0.loc.speed)
- 0 is the index of the action being referenced
- loc is the thing's location substructure
- speed is the element within the location substructure to be used
$(action.3.apiCounts.monthToDate)
- 3 is the index of the action being referenced
- apiCounts is the thing's apiCount substructure
- monthToDate is the element within the apiCount substructure to be used