Difference between revisions of "Activities"

Revision as of 11:28, 11 April 2016

Activity

Observers

Link to observer's help

Actors

• Actors are resources that define access control policies to thing and notification types
• Actors are defined for a tenant and they are not shared with other tenants (although their names must be unique accross tenants)
• Actors are associated to activities, meaning that the follower admin that subscribes to the service will adquire all those access control policies. The follower admin can then selectively give actors to the other followers he invites.

Thing types

Notification types

• Notifications are defined as types in the same way that things and observations are.
• A notification type contains well-known supported properties, such as subject and body.
• Notifications types can be used in actor's policies to define access to the instances of the notifications types
• Instances of a notification type can be generated using an action notify in a reasoner

Reasoners

example

Types of reasoners

Actions

See Actions

Observation production configuration

• Objective
  • Identify which thing types and observation types are required by observation type. The following example shows an example where a thing type LLRPReader produces 2 observations type observationresourcecrud and graiEPC
  • 
  • Configure observations' properties required to produce selected observations and enforce security including topic, targetthings, producer, guestusers, and guesttenants. The following example illustrates an graiEPC observation type with:
    • topic thingsInBoardroom/LLRPReader/#{smoothingResult}, placeholder #{smoothingResult} is used to group observations in child branches new or lost
    • producer reunionMexicoEDN:llrpantenna#{antennaId}, placeholder #{antennaId} is used to group identify what antenna id produced the observation
    • 
    • targetthings resource id reunionMexicoEDN:llrpantenna#{antennaId}:#{serialNumber}, placeholders #{antennaId} and #{serialNumber} are used to antenna id and prodcut serial number from graiEPC values to uniquely identify the target thing.
• Placeholders
• Relation with entities observation production configuration

Validation for publication

In order to be published, an activity must be a valid json resource according to its metadata. All resources contained in the activity must also be valid for their metadata. The follower specific validations are also performed on the activity (some generate warning, others generate errors that will not allow publication)

• Types involved in reasoners, observers and actors must be published
  • If there is an unpublished type that is used, and it is owned by the activity owner, a warning is generated
  • If the unpublished type is owned by another user, an error is generated
• Types used in actors are involved in reasoners or observers (if not, a warning is generated)
• Actors must not contain policies for notifications of a different activity

Publication