Difference between revisions of "Actions"

From AMTech WikiDocs
Jump to: navigation, search
(Blanked the page)
Line 1: Line 1:
 +
== Create thing ==
  
 +
* This action is configured to create a new thing.
 +
 +
* The name property will be used to generate a uniq ID for this thing.
 +
 +
* Things aren't immediately created. The creation action is queued as a promise. See [[CRUD promises]].
 +
 +
== Update thing ==
 +
 +
* This is only available in a for-each reasoner.
 +
 +
* This action is configured to update an existing thing: the thing that is currently being visited by the for-each reasoner.
 +
 +
* Things aren't immediately updated. The update action is queued as a promise. See [[CRUD promises]].
 +
 +
* In the configuration context (and also at execution time) the object referencing "the thing" doesn't change after the action update. It means that any further action using "the current thing" object will work with the same object that the observer retrieved from the DAP.
 +
 +
== Delete thing ==
 +
 +
* This action is only available in a for-each reasoner.
 +
 +
* This action is configured to delete the thing that is currently being visited by the for-each reasoner.
 +
 +
* The thing is not immediately delete. The deletion action is queued as a promise instead. See [[CRUD promises]].
 +
 +
== Send observation ==
 +
 +
* This action can be configured to send an observation to the [[Sensor's network]].
 +
 +
* Most mandatory data must be configured in this action. See [[Sensor's network#Observations and observation types|Observations and observation types]] in the [[Sensor's network]] page.
 +
 +
== Send command ==
 +
 +
* This action can be configured to send a command. See [[commands]]
 +
 +
* Command objects are no different from observation objects. In fact, you will be asked to provide an observation type as if you were sending a regular observation.
 +
 +
* You will not configure the <code>topic</code> or the <code>targetthings</code> properties. This info will be internally filled instead. The "Type of thing receiving the command" asked in the New Action dialog and the "Target URI" will be used for that purpose.
 +
 +
== Send notification ==
 +
 +
* This action can be configured to send a notification. See [[notifications]]
 +
 +
== Send scheduled observation ==

Revision as of 10:33, 9 March 2016

Create thing

  • This action is configured to create a new thing.
  • The name property will be used to generate a uniq ID for this thing.
  • Things aren't immediately created. The creation action is queued as a promise. See CRUD promises.

Update thing

  • This is only available in a for-each reasoner.
  • This action is configured to update an existing thing: the thing that is currently being visited by the for-each reasoner.
  • Things aren't immediately updated. The update action is queued as a promise. See CRUD promises.
  • In the configuration context (and also at execution time) the object referencing "the thing" doesn't change after the action update. It means that any further action using "the current thing" object will work with the same object that the observer retrieved from the DAP.

Delete thing

  • This action is only available in a for-each reasoner.
  • This action is configured to delete the thing that is currently being visited by the for-each reasoner.
  • The thing is not immediately delete. The deletion action is queued as a promise instead. See CRUD promises.

Send observation

Send command

  • This action can be configured to send a command. See commands
  • Command objects are no different from observation objects. In fact, you will be asked to provide an observation type as if you were sending a regular observation.
  • You will not configure the topic or the targetthings properties. This info will be internally filled instead. The "Type of thing receiving the command" asked in the New Action dialog and the "Target URI" will be used for that purpose.

Send notification

  • This action can be configured to send a notification. See notifications

Send scheduled observation