Observation production config

From AMTech WikiDocs
Revision as of 17:12, 12 October 2016 by Amarrero (Talk | contribs)

Jump to: navigation, search

Configuration options

The goal of this configuration is to identify the observation types that a thing of a given type produces behind a bridge.

  • When you access this configuration, you're presented with a list of thing types (initially empty).
  • You can add new thing types as a way of expressing a production for all the bridge thing instances belonging to that type. Therefore only those types associated to the things that are already configured as bridge instances are shown (things in the bridgeInstances property).
  • Once the type is added to the observation production configuration you can navigate to the produced observations and add new observation types. This allows you to express that those bridge instances that belong to the selected type can produce the observation that you're about to add/modify.
  • So you select an observation type. It has got to be an observation type listed in the observation types that this thing type can produce. See the definition of the corresponding thing type, observationproductionconfig property
  • Once selected you should configure the following properties:

Remarks: The Amtech M2M bridge uses this configuration to automatically fill this fields in the observations it sends. The follower must have a role with access polices to the thing type in order to get this information

Example

Let's show some more configuration details through an example:

  • As we can appreciate from the previous explanation, the configuration involves thing types and the observation types they produce. The first step is to open the bridge and go to observation production configuration setting:
Open bridge and go to observation production configuration settings
  • When you navigate into it you're presented with a list of already configured thing types (initially empty):
Thing type list for observation production configuration
  • Then you can add or navigate to an existing entity type. Let's choose LLRPReader for the example:
Specific thing type configuration
  • Then you can browse the list of observation types that it produces:
Observation type list for a give thing type
  • Again you can add or delete existing entries: observation types in this case. Let's go to graiEPC config:
Specific observation type configuration
The example shows a LLRPReader that is configured to produce observations of type graiEPC. Then you configure the observation properties required to produce this observation and enforce security including fixed settings for topic, targetthings, producer, guestusers and guesttenants (See Observations and observation types). In the example we set:
    • topic to /thingsInBoardroom/LLRPReader/#{smoothingResult}. #{smoothingResult} placeholder evaluated to new or lost so it allows us to group observations in corresponding child topics.
    • producer to #{thingId}. #{thingId} placeholder is replaced but the thing ID of the thing sending the observation.
    • topic, producer, guest tenant and guest user
    • targetthings - resource id reunionMexicoEDN:llrpantenna#{antennaId}:#{serialNumber}, placeholders #{antennaId} and #{serialNumber} are used to antenna id and product serial number from graiEPC values to uniquely identify the target thing.
      • targetthings
  • Placeholders
    • Allows to set identifiers that will be substituted by real values at different intelligence layers, the following example illustrates.
    • guesttenants #{companyPrefix} - placeholder is used to set a guesttenants from graiEPC value companyPrefix allowing to control the access to observations and things from the intelligence in the edge.
    • topic thingsInBoardroom/LLRPReader/#{smoothingResult}/#{country} - placeholder is used to group observations in child branches by countries.
    • placeholder
  • Relation with thing types observation production configuration (See Thing types)
    • Each thing type defines which observation types produces as part of the type semantic. The following example illustrates selecting observation type graiEPC produced by LLRPReader type.
    • Select observation type