Difference between revisions of "Reasoners"

From AMTech WikiDocs
Jump to: navigation, search
(Create)
Line 1: Line 1:
 
=Reasoner by property=
 
=Reasoner by property=
 
  
 
[[File:ReasonerByProperty.png]]
 
[[File:ReasonerByProperty.png]]
 
  
 
==Reasoner For Each ==
 
==Reasoner For Each ==
 
 
  
 
[[File:ReasonerForEachCreate.png]]
 
[[File:ReasonerForEachCreate.png]]
Line 17: Line 13:
 
For each entity that was returned by observer the system will create a new entity with the settings assigned
 
For each entity that was returned by observer the system will create a new entity with the settings assigned
  
1-MainMenu/Activities/Reasoner
+
# MainMenu/Activities/Reasoner
 
+
# Click create
2-Click create
+
# Select For each
 
+
# Enter a Name
3-Select For each
+
# Once The Reasoner editor is open
 
+
# Enter Description
3-Enter a Name
+
# Select the observer
 
+
# Select Topics from where you are getting the observation
4-Once The Reasoner editor is open
+
# Select Action Create
 
+
# Dialog Box for create will be open
5-Enter Description
+
# Select type of entity you want to create
 
+
# Enter a label to identify the action
6-Select the observer
+
# On action on the right side select The Action label for Create  inside will be a list of fields :  
 
+
#: '''Continue on failure'''  is a boolean true or false. User can said if he wants to continue even if there is failure.
7-Select Topics from where you are getting the observation
+
#: '''Update if exist'''  is a boolean or or false. If true user can update any fields
 
+
#: '''New Entity'''  fieldsUser will fill all the required fields to Create the new Entity
8-Select Action Create
+
#: [[File:ReasonerForEachCreateContfailureUpdateIfExist.png]]
 
+
#: [[File:ReasonerForeachCreateFillingFields.png]]
9-Dialog Box for create will be open
+
# Run the reasoner
 
+
# Select observation from where user wants to get the info for the binding etc
10-Select type of entity you want to create
+
 
+
11-Enter a label to identify the action
+
 
+
12-On action on the right side select The Action label for Create  inside will be a list of fields :  
+
 
+
+
'''Continue on failure'''  is a boolean true or false. User can said if he wants to continue even if there is failure.
+
 
+
'''Update if exist'''  is a boolean or or false. If true user can update any fields
+
 
+
'''New Entity'''  fieldsUser will fill all the required fields to Create the new Entity
+
 
+
[[File:ReasonerForEachCreateContfailureUpdateIfExist.png]]
+
 
+
[[File:ReasonerForeachCreateFillingFields.png]]
+
 
+
12-Run the reasoner
+
 
+
13-Select observation from where user wants to get the info for the binding etc
+
  
 
=== Update===
 
=== Update===
Line 67: Line 43:
 
  '''Entity fields''' User will fill all the required fields to Update the Entity
 
  '''Entity fields''' User will fill all the required fields to Update the Entity
  
-Run the reasoner
+
* Run the reasoner
 
+
* Select observation from where user wants to get the info
-Select observation from where user wants to get the info
+
  
 
=== Delete===
 
=== Delete===
Line 78: Line 53:
 
Same steps as create just  
 
Same steps as create just  
  
-Select Action Delete
+
* Select Action Delete
 
+
* Enter a name for the action Delete
-Enter a name for the action Delete
+
* Click Run to run reasoner
 
+
* Select observation
-Click Run to run reasoner
+
 
+
- Select observation
+
  
 
=== Send Notifications===
 
=== Send Notifications===
Line 93: Line 65:
 
Same steps as Create
 
Same steps as Create
  
-On  Action, Select Send Notification. The dialog box to configure the action Send Notification will be open.
+
* On  Action, Select Send Notification. The dialog box to configure the action Send Notification will be open.
 
+
* Enter a name for the action Send Notification, Select the Notification template, Select by property
-Enter a name for the action Send Notification, Select the Notification template, Select by property
+
* On action on the right side select the Send Notification action inside user will see
 
+
-On action on the right side select the Send Notification action inside user will see
+
  
 
Action Send Notification Fields
 
Action Send Notification Fields
Line 116: Line 86:
 
note: If the notification template does not have placeholder there will not be notification fields
 
note: If the notification template does not have placeholder there will not be notification fields
 
   
 
   
 
+
* Click Run to run reasoner
-Click Run to run reasoner
+
* Select observation
 
+
- Select observation
+
  
 
=== Send Observations===
 
=== Send Observations===
Line 128: Line 96:
 
Same steps as Create
 
Same steps as Create
  
-On on Action and Select Send Observation action
+
* On on Action and Select Send Observation action
 
+
* Dialog box for the settings for the action will be open, select the type of observation, select by property and Enter a name for the Observation to be send
-Dialog box for the settings for the action will be open, select the type of observation, select by property and Enter a name for the Observation to be send
+
* On action on the right side select the Send Observation  inside will be a list of fields :
 
+
-On action on the right side select the Send Observation  inside will be a list of fields :
+
  
 
Action Send Observation Fields
 
Action Send Observation Fields
Line 142: Line 108:
 
     '''New Observation fields''' User will fill all the required fields to send that observation
 
     '''New Observation fields''' User will fill all the required fields to send that observation
  
-Run the reasoner
+
* Run the reasoner
 
+
* Select observation from where user wants to get the info
-Select observation from where user wants to get the info
+
  
 
===Schedule Observations===
 
===Schedule Observations===
Line 156: Line 121:
 
    
 
    
  
-Select Action Schedule Observation
+
* Select Action Schedule Observation
 
+
* Enter a name for the Schedule  
-Enter a name for the Schedule  
+
* Select the type of Observation to be send
 
+
* On action on the right side select the Schedule Observation  inside will be a list of fields :  
-Select the type of Observation to be send
+
 
+
-On action on the right side select the Schedule Observation  inside will be a list of fields :  
+
  
 
[[File:ReasonerForEachScheduleSEndObs.png]]
 
[[File:ReasonerForEachScheduleSEndObs.png]]
Line 190: Line 152:
 
   New Observation fields User will fill all the required fields to send that observation
 
   New Observation fields User will fill all the required fields to send that observation
  
-Run the reasoner
+
* Run the reasoner
  
-Select observation from where user wants to get the info
+
* Select observation from where user wants to get the info
  
 
==Reasoner At Least One ==
 
==Reasoner At Least One ==
Line 204: Line 166:
 
If observer return at least one entity the system will create a new entity with the settings assigned
 
If observer return at least one entity the system will create a new entity with the settings assigned
  
1-MainMenu/Activities/Reasoner
+
# MainMenu/Activities/Reasoner
 
+
# Click create
2-Click create
+
# Select At least one entity
 
+
# Enter a Name
3-Select At least one entity
+
# Once The Reasoner editor is open
 
+
# Enter Description
4-Enter a Name
+
# Select the observer
 
+
# Select Topic from where you are getting the observation
5-Once The Reasoner editor is open
+
# Select Action Create
 
+
# Dialog Box for create will be open
6-Enter Description
+
# Select type of entity you want to create
 
+
# Enter a label to identify the action
7-Select the observer
+
# On action on the right side select The Action label for Create  inside will be a list of fields :  
 
+
#: Tenant Binding, where user will specify in which Tenant he wants to Create the Entity
8-Select Topic from where you are getting the observation
+
#: Continue on failure is a boolean true or false. User can said if he wants to continue even if there is failure
 
+
#: New Entity fields User will fill all the required fields to Create the new Entity
9-Select Action Create
+
# Run the reasoner
 
+
# Select observation from where user wants to get the info for the binding etc
10-Dialog Box for create will be open
+
 
+
11-Select type of entity you want to create
+
 
+
12-Enter a label to identify the action
+
 
+
13-On action on the right side select The Action label for Create  inside will be a list of fields :  
+
 
+
  Tenant Binding, where user will specify in which Tenant he wants to Create the Entity
+
 
+
  Continue on failure is a boolean true or false. User can said if he wants to continue even if there is failure
+
 
+
  New Entity fields User will fill all the required fields to Create the new Entity
+
 
+
14-Run the reasoner
+
 
+
15-Select observation from where user wants to get the info for the binding etc
+
  
 
===Send Notifications===
 
===Send Notifications===
Line 282: Line 227:
 
Assign values on the right side to the observation fields
 
Assign values on the right side to the observation fields
  
-Run the reasoner
+
* Run the reasoner
 
+
* Select observation from where user wants to get the info
-Select observation from where user wants to get the info
+
  
 
===Schedule Observations===
 
===Schedule Observations===
Line 306: Line 250:
 
===Create===
 
===Create===
  
1-MainMenu/Activities/Reasoner
+
# MainMenu/Activities/Reasoner
 +
# Click create
 +
# Select Only Observation
 +
# Enter a Name
 +
# Once The Reasoner editor is open
 +
# Enter Description
 +
# Select the observer
 +
# Select Topic from where you are getting the observation
 +
# Select Action Create
 +
# Dialog Box for create will be open
 +
# Select type of entity you want to create
 +
# Enter a label to identify the action
 +
# On action on the right side select Enter Info for required fileds to Create the new Entity
 +
# Run the reasoner
 +
# Select observation from where user wants to get the info for the binding etc
  
2-Click create
+
Expected results  
 
+
3-Select Only Observation
+
 
+
4-Enter a Name
+
 
+
5-Once The Reasoner editor is open
+
 
+
6-Enter Description
+
 
+
7-Select the observer
+
 
+
8-Select Topic from where you are getting the observation
+
 
+
9-Select Action Create
+
 
+
10-Dialog Box for create will be open
+
 
+
11-Select type of entity you want to create
+
 
+
12-Enter a label to identify the action
+
 
+
13-On action on the right side select Enter Info for required fileds to Create the new Entity
+
 
+
14-Run the reasoner
+
 
+
15-Select observation from where user wants to get the info for the binding etc
+
 
+
expected results  
+
  
 
If Observer results is positive The system will Create a new Entity with the information entered on the settings
 
If Observer results is positive The system will Create a new Entity with the information entered on the settings
Line 342: Line 272:
 
===Send Notifications===
 
===Send Notifications===
  
-Enter a name for the action Send Notification
+
* Enter a name for the action Send Notification
 +
* Select the notification template
 +
* On action on the right side select the Send Notification .Enter info 
 +
* Click Run to run reasoner
 +
* Select observation
  
Select the notification template
+
Expected results
 
+
-On action on the right side select the Send Notification .Enter info 
+
 
+
-Click Run to run reasoner
+
 
+
- Select observation
+
 
+
expected results
+
  
 
If the run of observer is positive The system will send the notification to the specified tenant according to the setting on media
 
If the run of observer is positive The system will send the notification to the specified tenant according to the setting on media
Line 358: Line 284:
 
===Send Observations===
 
===Send Observations===
  
-Select Action Send Observation
+
* Select Action Send Observation
 +
* Enter a name for the Observation
 +
* Select the type of Observation to be send
 +
* On action on the right side select the Send Observation  inside will be a list of fields :
 +
* Filelds are the same for all sendObservation
 +
* Run the reasoner
 +
* Select observation from where user wants to get the info
  
-Enter a name for the Observation
+
Expected results
 
+
-Select the type of Observation to be send
+
 
+
-On action on the right side select the Send Observation  inside will be a list of fields :
+
 
+
- Filelds are the same for all sendObservation
+
 
+
-Run the reasoner
+
 
+
-Select observation from where user wants to get the info
+
 
+
expected results
+
  
 
If the run of observer is positive The system will send a new observation with the information entered on new observation fields
 
If the run of observer is positive The system will send a new observation with the information entered on new observation fields
Line 394: Line 314:
 
===Create===
 
===Create===
  
1-MainMenu/Activities/Reasoner
+
# MainMenu/Activities/Reasoner
 +
# Click create
 +
# Select Observer does not return Entity
 +
# Enter a Name
 +
# Once The Reasoner editor is open
 +
# Enter Description
 +
# Select the observer
 +
# Select Topic from where you are getting the observation
 +
# Select Action Create
 +
# Dialog Box for create will be open
 +
# Select type of entity you want to create
 +
# Enter a label to identify the action
 +
# On action on the right side select The Action label for Create  inside will be a list of fields :
 +
#: Fields are the same for all create actions
 +
# Run the reasoner
 +
# Select observation from where user wants to get the info for the binding etc
  
2-Click create
+
Expected results
 
+
3-Select Observer does not return Entity
+
 
+
4-Enter a Name
+
 
+
5-Once The Reasoner editor is open
+
 
+
6-Enter Description
+
 
+
7-Select the observer
+
 
+
8-Select Topic from where you are getting the observation
+
 
+
9-Select Action Create
+
 
+
10-Dialog Box for create will be open
+
 
+
11-Select type of entity you want to create
+
 
+
12-Enter a label to identify the action
+
 
+
13-On action on the right side select The Action label for Create  inside will be a list of fields :
+
 
+
Fields are the same for all create actions
+
 
+
14-Run the reasoner
+
 
+
15-Select observation from where user wants to get the info for the binding etc
+
 
+
expected results
+
  
 
If observer run is positive and does not return Entity  the system will create a new entity with the settings assigned
 
If observer run is positive and does not return Entity  the system will create a new entity with the settings assigned
Line 442: Line 347:
 
     Media has three options
 
     Media has three options
  
      -”dap” to display the notification on the screen of tenant only
+
* ”dap” to display the notification on the screen of tenant only
 
+
* ”mail” notification by mail only
      -”mail” notification by mail only
+
* ”dap,mail” by mail and screen both
 
+
      -”dap,mail” by mail and screen both
+
  
 
   Continue on failure is a boolean true or false. User can said if he wants to continue even if there is failure
 
   Continue on failure is a boolean true or false. User can said if he wants to continue even if there is failure
Line 467: Line 370:
 
Select Action Send Observation
 
Select Action Send Observation
  
-Enter a name for the Observation  
+
* Enter a name for the Observation  
 
+
* Select the type of Observation to be send
-Select the type of Observation to be send
+
* On action on the right side select the Send Observation  inside will be a list of fields :  
 
+
* Enter values for those fields
-On action on the right side select the Send Observation  inside will be a list of fields :  
+
* Run the reasoner
 
+
* Select observation from where user wants to get the info
Enter values for those fields
+
 
+
-Run the reasoner
+
 
+
 
+
-Select observation from where user wants to get the info
+
  
 
expected results
 
expected results
Line 486: Line 383:
 
===Schedule Observations===
 
===Schedule Observations===
  
-Select Action Schedule Observation
+
* Select Action Schedule Observation
 
+
* Enter a name for the Schedule  
-Enter a name for the Schedule  
+
* Select the type of Observation to be send
 
+
* On action on the right side select the Schedule Observation  inside will be a list of fields :  
-Select the type of Observation to be send
+
*: user needs to specify Initiation Date and time, occurrence and frequency
 
+
*: '''Note:'''
-On action on the right side select the Schedule Observation  inside will be a list of fields :  
+
*: Occurrence 0 must enter frequency like; sec, mins, hours etc If user for example enters frequency days that means observation will be send every day forever Starting on the Start date and Time
 
+
*: Occurrence 1 frequency will be ignore. The system will send that schedule observation on the Start Date and Time only once
user needs to specify Initiation Date and time, occurrence and frequency
+
*: Occurrence 2 or more must enter frequency. The system will send the observation according to frequency and Start Date and Time
 
+
* Run the reasoner
'''Note:'''
+
* Select observation from where user wants to get the info
 
+
Occurrence 0 must enter frequency like; sec, mins, hours etc If user for example enters frequency days that means observation will be send every day forever Starting on the Start date and Time
+
 
+
Occurrence 1 frequency will be ignore. The system will send that schedule observation on the Start Date and Time only once
+
 
+
Occurrence 2 or more must enter frequency. The system will send the observation according to frequency and Start Date and Time
+
 
+
-Run the reasoner
+
 
+
Select observation from where user wants to get the info
+
  
 
Expected results
 
Expected results
Line 522: Line 409:
 
====Create====
 
====Create====
  
1-MainMenu/Activities/Reasoner
+
# MainMenu/Activities/Reasoner
 
+
# Click create
2-Click create
+
# Select For Each entity  
 
+
# Enter a Name
3-Select For Each entity  
+
# Once The Reasoner editor is open
 
+
# Enter Description
4-Enter a Name
+
# Select the observer
 
+
# Select Topic from where you are getting the observation
5-Once The Reasoner editor is open
+
# Select Action Create,  
 
+
# Dialog Box for create will be open Select by recurso
6-Enter Description
+
# Select type of entity you want to create
 
+
# Enter a label to identify the action
7-Select the observer
+
# On right side click on action
 
+
# Select on right side new fields and user can see he can write the info using javascript
8-Select Topic from where you are getting the observation
+
#: Example:
 
+
#: <syntaxhighlight lang="javascript">
9-Select Action Create,  
+
 
+
10-Dialog Box for create will be open Select by recurso
+
 
+
11-Select type of entity you want to create
+
 
+
12-Enter a label to identify the action
+
 
+
13-On right side click on action
+
 
+
14-Select on right side new fields and user can see he can write the info using javascript
+
 
+
example  :
+
 
+
<syntaxhighlight lang="javascript">
+
 
function(newthing,observation,thing,summary){   
 
function(newthing,observation,thing,summary){   
 
     newthing._name ="Entity77"+ new Date().getTime().toString();
 
     newthing._name ="Entity77"+ new Date().getTime().toString();
Line 559: Line 431:
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
Note: there are required fields if user does not enter them the reasoner wont run
+
#: '''Note:''' there are required fields if user does not enter them the reasoner wont run
 
+
# Run reasoner
15-Run reasoner
+
  
 
Expected
 
Expected
Line 629: Line 500:
 
====Create ====
 
====Create ====
  
<ol>
+
# MainMenu/Activities/Reasoner
<li> MainMenu/Activities/Reasoner
+
# Click create
<li> Click create
+
# Select At least one Entity
<li> Select At least one Entity
+
# Enter a Name
<li> Enter a Name
+
# Once The Reasoner editor is open
<li> Once The Reasoner editor is open
+
# Enter Description
<li> Enter Description
+
# Select the observer
<li> Select the observer
+
# Select Topic from where you are getting the observation
<li> Select Topic from where you are getting the observation
+
# Select Action Create,  
<li> Select Action Create,  
+
# Dialog Box for create will be open Select by recurso
<li> Dialog Box for create will be open Select by recurso
+
# Select type of entity you want to create
<li> Select type of entity you want to create
+
# Enter a label to identify the action
<li> Enter a label to identify the action
+
# On right side click on action
<li> On right side click on action
+
# Select on right side new fields and user can see he can write the info using javascript
<li> Select on right side new fields and user can see he can write the info using javascript
+
#: Example:
Example:
+
#: <syntaxhighlight lang="javascript">
<syntaxhighlight lang="javascript">
+
 
function(newthing,observation,thing){   
 
function(newthing,observation,thing){   
 
     newthing._name ="Entity55";
 
     newthing._name ="Entity55";
Line 652: Line 522:
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
'''Note: there are required fields if user does not enter them the reasoner wont run'''
+
#: '''Note: there are required fields if user does not enter them the reasoner wont run'''
<li> Run reasoner
+
# Run reasoner
</ol>
+
 
  
 
Expected
 
Expected

Revision as of 10:37, 22 April 2016

Reasoner by property

ReasonerByProperty.png

Reasoner For Each

ReasonerForEachCreate.png

Create

Reasoner For each create by property :

For each entity that was returned by observer the system will create a new entity with the settings assigned

  1. MainMenu/Activities/Reasoner
  2. Click create
  3. Select For each
  4. Enter a Name
  5. Once The Reasoner editor is open
  6. Enter Description
  7. Select the observer
  8. Select Topics from where you are getting the observation
  9. Select Action Create
  10. Dialog Box for create will be open
  11. Select type of entity you want to create
  12. Enter a label to identify the action
  13. On action on the right side select The Action label for Create inside will be a list of fields :
    Continue on failure is a boolean true or false. User can said if he wants to continue even if there is failure.
    Update if exist is a boolean or or false. If true user can update any fields
    New Entity fieldsUser will fill all the required fields to Create the new Entity
    ReasonerForEachCreateContfailureUpdateIfExist.png
    ReasonerForeachCreateFillingFields.png
  14. Run the reasoner
  15. Select observation from where user wants to get the info for the binding etc

Update

Reasoner for Each Update by property:

For each entity that was returned by observer the system will update the entities with the new values

Same steps as created but Action will be Update

Entity fields User will fill all the required fields to Update the Entity
  • Run the reasoner
  • Select observation from where user wants to get the info

Delete

Reasoner For each Delete by property

The system will delete all the entities returned by observer on the specified Tenant

Same steps as create just

  • Select Action Delete
  • Enter a name for the action Delete
  • Click Run to run reasoner
  • Select observation

Send Notifications

Reasoner for each Send Notifications by properties

The system will send the notification to the specified tenant according to the setting on media

Same steps as Create

  • On Action, Select Send Notification. The dialog box to configure the action Send Notification will be open.
  • Enter a name for the action Send Notification, Select the Notification template, Select by property
  • On action on the right side select the Send Notification action inside user will see

Action Send Notification Fields

Destinatario where user can specify the email address of the person to receive the notification

Media

”dap” to display the notification on the screen of tenant only

”mail” notification by mail only

”dap,mail”by mail and screen both

Continue on failure is a boolean true or false. User can said if he wants to continue even if there is failure
Notification Fields User will assign values to the place holders of the notification templates

note: If the notification template does not have placeholder there will not be notification fields

  • Click Run to run reasoner
  • Select observation

Send Observations

Reasoner For each Send Observations by properties

For each entity that was returned the system will send a new observation with the information entered on new observation fields

Same steps as Create

  • On on Action and Select Send Observation action
  • Dialog box for the settings for the action will be open, select the type of observation, select by property and Enter a name for the Observation to be send
  • On action on the right side select the Send Observation inside will be a list of fields :

Action Send Observation Fields

  Tenant Binding where user will specify in which Tenant he wants to send the Observation
  Continue on failure is a boolean true or false. User can said if he wants to continue even if there is failure
   New Observation fields User will fill all the required fields to send that observation
  • Run the reasoner
  • Select observation from where user wants to get the info

Schedule Observations

Reasoner For each Send Schedule Observations by properties

For each entity that was returned the system will schedule to send a new observation with the information entered on the settings


ReasonerForEachScheduleObs.png


  • Select Action Schedule Observation
  • Enter a name for the Schedule
  • Select the type of Observation to be send
  • On action on the right side select the Schedule Observation inside will be a list of fields :

ReasonerForEachScheduleSEndObs.png

 Identifier To ID this task inside the system
StartDate it is the time and date to start sending the scheduled observation
 seconds definition to the level of seconds to send the observation
 Minutes  definition to the level of minutes to send the observation
 hours   definition to the level of Hours to send the observation
 days
  months

Occurrence 0 must enter frequency like; sec, mins, hours etc If user for example enters frequency days that means observation will be send every day forever Starting on the Start date and Time

          Occurrence 1 frequency will be ignore. The system will send that schedule observation on the Start Date and Time only once
          Occurrence 2 or more must enter frequency. The system will send the observation according to frequency and Start Date and Time. An example if observer return two entities or things and start time is 10:22 am occurrence is 2 and frequency is 2 mins. the system will send 2 observations at 10:22 am and will send another 2 observations at 10:24 am
 Years
 Continue on failure is a boolean true or false. User can said if he wants to continue even if there is failure
 New Observation fields User will fill all the required fields to send that observation
  • Run the reasoner
  • Select observation from where user wants to get the info

Reasoner At Least One

Create

ReasonerAtLeastOneCreate.png

Reasoner At least One Create by property:

If observer return at least one entity the system will create a new entity with the settings assigned

  1. MainMenu/Activities/Reasoner
  2. Click create
  3. Select At least one entity
  4. Enter a Name
  5. Once The Reasoner editor is open
  6. Enter Description
  7. Select the observer
  8. Select Topic from where you are getting the observation
  9. Select Action Create
  10. Dialog Box for create will be open
  11. Select type of entity you want to create
  12. Enter a label to identify the action
  13. On action on the right side select The Action label for Create inside will be a list of fields :
    Tenant Binding, where user will specify in which Tenant he wants to Create the Entity
    Continue on failure is a boolean true or false. User can said if he wants to continue even if there is failure
    New Entity fields User will fill all the required fields to Create the new Entity
  14. Run the reasoner
  15. Select observation from where user wants to get the info for the binding etc

Send Notifications

Reasoner At Least One Send Notifications

If observer return at least one entity The system will send the notification to the specified tenant according to the setting on media

Same steps as create just Select action Send Notification and select the template for the notification

On action on the right side select the Send Notification action inside user will see:

  Tenant Binding, where user will specify in which Tenant he wants to send the notification
   Destinatario, where user can specify the email address of the person to receive the notification
   Media has three options
     -”dap” to display the notification on the screen of tenant only
     -”mail” notification by mail only
     -”dap,mail” by mail and screen both
  Continue on failure is a boolean true or false. User can said if he wants to continue even if there is failure
Notification Fields User will assign values to the place holders of the notification templates

notes:If the notification template does not have placeholder there will not be notification fields


Click Run to run reasoner

Select observation

Send Observations

Reasoner At Least One SEnd Observations

If observer return at least one entity The system will send a new observation with the information entered on new observation fields

Same as create just select Action send Observation, Then select the type of observation you want to send Assign values on the right side to the observation fields

  • Run the reasoner
  • Select observation from where user wants to get the info

Schedule Observations

The same as send observation on Action select schedule observations user just need to specify Initiation Date and time, occurrence and frequency

Note:

Occurrence 0 must enter frequency like; sec, mins, hours etc If user for example enters frequency days that means observation will be send every day forever Starting on the Start date and Time

Occurrence 1 frequency will be ignore. The system will send that schedule observation on the Start Date and Time only once

Occurrence 2 or more must enter frequency. The system will send the observation according to frequency and Start Date and Time

Expected

If Observer return at least one entity the system will Schedule to send a new Observation

Reasoner Observation Only

Create

  1. MainMenu/Activities/Reasoner
  2. Click create
  3. Select Only Observation
  4. Enter a Name
  5. Once The Reasoner editor is open
  6. Enter Description
  7. Select the observer
  8. Select Topic from where you are getting the observation
  9. Select Action Create
  10. Dialog Box for create will be open
  11. Select type of entity you want to create
  12. Enter a label to identify the action
  13. On action on the right side select Enter Info for required fileds to Create the new Entity
  14. Run the reasoner
  15. Select observation from where user wants to get the info for the binding etc

Expected results

If Observer results is positive The system will Create a new Entity with the information entered on the settings

Send Notifications

  • Enter a name for the action Send Notification
  • Select the notification template
  • On action on the right side select the Send Notification .Enter info
  • Click Run to run reasoner
  • Select observation

Expected results

If the run of observer is positive The system will send the notification to the specified tenant according to the setting on media

Send Observations

  • Select Action Send Observation
  • Enter a name for the Observation
  • Select the type of Observation to be send
  • On action on the right side select the Send Observation inside will be a list of fields :
  • Filelds are the same for all sendObservation
  • Run the reasoner
  • Select observation from where user wants to get the info

Expected results

If the run of observer is positive The system will send a new observation with the information entered on new observation fields

Schedule Observations

function(newobservation,observation){ 
       newobservation._name = "ScheduleSendObserRecursoObsOnly";
       newobservation.topic = observation.topic;  
       newobservation.producer = observation.producer; 
}

Expected If the run of Observer is positive the system will Send the observation

according to the schedule

Reasoner Absence of Things

Create

  1. MainMenu/Activities/Reasoner
  2. Click create
  3. Select Observer does not return Entity
  4. Enter a Name
  5. Once The Reasoner editor is open
  6. Enter Description
  7. Select the observer
  8. Select Topic from where you are getting the observation
  9. Select Action Create
  10. Dialog Box for create will be open
  11. Select type of entity you want to create
  12. Enter a label to identify the action
  13. On action on the right side select The Action label for Create inside will be a list of fields :
    Fields are the same for all create actions
  14. Run the reasoner
  15. Select observation from where user wants to get the info for the binding etc

Expected results

If observer run is positive and does not return Entity the system will create a new entity with the settings assigned

Send Notifications

Same steps as create just Select action Send Notification and select the template for the notification

On action on the right side select the Send Notification action inside user will see:

  Tenant Binding, where user will specify in which Tenant he wants to send the notification
   Destinatario, where user can specify the email address of the person to receive the notification
   Media has three options
  • ”dap” to display the notification on the screen of tenant only
  • ”mail” notification by mail only
  • ”dap,mail” by mail and screen both
  Continue on failure is a boolean true or false. User can said if he wants to continue even if there is failure
Notification Fields User will assign values to the place holders of the notification templates

notes:If the notification template does not have placeholder there will not be notification fields


Click Run to run reasoner

Select observation

expected results

In absence of entities .The system will send the notification to the specified tenant according to the setting on media

Send Observations

Select Action Send Observation

  • Enter a name for the Observation
  • Select the type of Observation to be send
  • On action on the right side select the Send Observation inside will be a list of fields :
  • Enter values for those fields
  • Run the reasoner
  • Select observation from where user wants to get the info

expected results

If observer run is positive and does not return Entity The system will send a new observation with the information entered on new observation fields

Schedule Observations

  • Select Action Schedule Observation
  • Enter a name for the Schedule
  • Select the type of Observation to be send
  • On action on the right side select the Schedule Observation inside will be a list of fields :
    user needs to specify Initiation Date and time, occurrence and frequency
    Note:
    Occurrence 0 must enter frequency like; sec, mins, hours etc If user for example enters frequency days that means observation will be send every day forever Starting on the Start date and Time
    Occurrence 1 frequency will be ignore. The system will send that schedule observation on the Start Date and Time only once
    Occurrence 2 or more must enter frequency. The system will send the observation according to frequency and Start Date and Time
  • Run the reasoner
  • Select observation from where user wants to get the info

Expected results

If observer run is positive and does not return Entity . The system will schedule to send a new observation with the information entered on the settings

Reasoner by Resource

ReasonerByResource.png

Reasoner For each

ReasonerForEachByResourceCreate.png

Create

  1. MainMenu/Activities/Reasoner
  2. Click create
  3. Select For Each entity
  4. Enter a Name
  5. Once The Reasoner editor is open
  6. Enter Description
  7. Select the observer
  8. Select Topic from where you are getting the observation
  9. Select Action Create,
  10. Dialog Box for create will be open Select by recurso
  11. Select type of entity you want to create
  12. Enter a label to identify the action
  13. On right side click on action
  14. Select on right side new fields and user can see he can write the info using javascript
    Example:
    function(newthing,observation,thing,summary){   
        newthing._name ="Entity77"+ new Date().getTime().toString();
        newthing.DoubleData = observation.ObsDoubleData; 
        newthing.description ="Testing Create by recurso";        
    }
    
    Note: there are required fields if user does not enter them the reasoner wont run
  15. Run reasoner

Expected

For each entity returned by observer system will create a new entity

Update

Same steps as Create

function(updatething,observation,thing){   
    updatedthing.description ="Bless be the ones who serve others. They are the ones who find heaven on earth.";
    updatedthing.CityPopulation = 123000123;
}

Expected The system will update each entity returned by the observer

Send Notification

same as for each send notification by properties

Delete

same as for each Delete by properties

Send Observations

function(newobservation,observation,thing){   
    newobservation._name = "SendObserRecurso"+ new Date().getTime().toString();
    newobservation.topic = observation.topic;   (Required field)
    newobservation.producer = observation.producer;  (Required field)
}

Note: there are required fields if user does not enter them the reasoner wont run

Schedule Send Observation

The same as send observation user just need to specify Initiation Date and time, occurrence and frequency Note:

Occurrence 0 must enter frequency like; sec, mins, hours etc If user for example enters frequency days that means observation will be send every day forever Starting on the Start date and Time

Occurrence 1 frequency will be ignore. The system will send that schedule observation on the Start Date and Time only once

Occurrence 2 or more must enter frequency. The system will send the observation according to frequency and Start Date and Time

function(newobservation,observation,thing){   
    newobservation._name = "SendObserRecurso"+ new Date().getTime().toString();
    newobservation.topic = observation.topic;   (Required field)
    newobservation.producer = observation.producer;  (Required field)
}

Note: there are required fields if user does not enter them the reasoner wont run

Expected

For each Entity returned by the observer the system will schedule to send a new observation

Reasoner At Least One

Create

  1. MainMenu/Activities/Reasoner
  2. Click create
  3. Select At least one Entity
  4. Enter a Name
  5. Once The Reasoner editor is open
  6. Enter Description
  7. Select the observer
  8. Select Topic from where you are getting the observation
  9. Select Action Create,
  10. Dialog Box for create will be open Select by recurso
  11. Select type of entity you want to create
  12. Enter a label to identify the action
  13. On right side click on action
  14. Select on right side new fields and user can see he can write the info using javascript
    Example:
    function(newthing,observation,thing){   
        newthing._name ="Entity55";
        newthing.DoubleData = observation.ObsDoubleData; 
        newthing.description ="Testing Reasoner At least One Create by recurso";
    }
    
    Note: there are required fields if user does not enter them the reasoner wont run
  15. Run reasoner


Expected If Observer return at least one Entity the system will create a new entity if observer does not return entity system won't create the new Entity

Send Notifications

same as send Notification by properties

Send Observations

function(newobservation,observation,thing){ 
    newobservation._name = "SendObserRecurso333"; (Mandatory Field)
    newobservation.topic = observation.topic;  (Mandatory Field)
    newobservation.producer = observation.producer;  (Mandatory Field)
}

Schedule Send Observations

The same as send observation user just need to specify Initiation Date and time, occurrence and frequency Note:

Occurrence 0 must enter frequency like; sec, mins, hours etc If user for example enters frequency days that means observation will be send every day forever Starting on the Start date and Time

Occurrence 1 frequency will be ignore. The system will send that schedule observation on the Start Date and Time only once

Occurrence 2 or more must enter frequency. The system will send the observation according to frequency and Start Date and Time

function(newobservation,observation){ 
    newobservation.producer = "Copertino";	
}

Expected

If Observer return at least one entity the system will Schedule to send a new Observation

Reasoner Only Observations

Create

function(newthing,observation){ 
    newthing._name ="EntityObsOnlyRecurso";
    newthing.DoubleData = observation.ObsDoubleData; 
    newthing.description ="Testing Reasoner Obs Only Create by recurso";
}

Expected

If the run of Observer is positive the system will Create a New Entity

Send Notifications

same as send notification by properties

Send Observations

function(newobservation,observation){ 
    newobservation._name = "SendObserRecursoObsOnly";
    newobservation.topic = observation.topic;  (Mandatory field)
    newobservation.producer = observation.producer;  (Mandatory field)
}

Expected

If the run of Observer is positive the system will Send the observation

Schedule Send Observations

The same as send observation on Action select schedule observations user just need to specify Initiation Date and time, occurrence and frequency

Note:

Occurrence 0 must enter frequency like; sec, mins, hours etc If user for example enters frequency days that means observation will be send every day forever Starting on the Start date and Time

Occurrence 1 frequency will be ignore. The system will send that schedule observation on the Start Date and Time only once

Occurrence 2 or more must enter frequency. The system will send the observation according to frequency and Start Date and Time

function(newobservation,observation){ 
    newobservation._name = "ScheduleSendObserRecursoObsOnly";
    newobservation.topic = observation.topic;  
    newobservation.producer = observation.producer; 
}

Expected

If the run of Observer is positive the system will Send the observation

according to the schedule

Reasoner Absence of things

Create

function(newthing,observation){ 
    newthing._name ="EntityDoNotReturnRecurso111";
    newthing.DoubleData = observation.ObsDoubleData; 
    newthing.description ="Testing Reasoner Do not return entity Create by recurso";
}

Expected

If Observer do not return an entity the system will create a new entity

Send Notifications

Send Observations

function(newobservation,observation){ 
    newobservation._name = "SendObserRecursoNoEntity";
    newobservation.topic = observation.topic;  
    newobservation.producer = observation.producer; 
}

Expected

If Observer do not return an entity the system will Send Observation

Schedule Send Observations

function(newobservation,observation){ 
    newobservation._name = "ScheduleSendObserRecursoNoEntity";
    newobservation.topic = observation.topic;  
    newobservation.producer = observation.producer;       
}

Expected

If Observer do not return an entity the system will Schedule and send observation according to schedule

Reasoner Increment, Decrement, Set

First this only works for numeric fields like integer or double when user set a supported property that is double or integer of a type of entity he has to check the check box for atomic updates Then this only works for reasoner for each by property action updates

on the right side user will be able to select from set, increment or decrement then there is an entry box to enter a numeric value on how much you want decrement or increment or set is just to set a fix value

for example Field to update is Temp max that initially was 2 then user select increment then enter 2 then user runs reasoner on temp max the result will be 4

ScreenShotDecIncSet2016-03-11.png

Reasoner proximity Area

Proximity area option will allow the user to set an entity to the proximity area field to a new entity created by the reasoner

User can do this several ways

  • User just selects the entity from the list
  • User does a binding where user selects the proximity area that was selected on the observer
  • Using Javascript he can do the two previous options

example :

proximityarea = observation.proximityarea;

proximityarea = "/amtech/things/entities/TempEntity/TempNewPort";


ReasonerProximityArea.png

Note:In case Entity does not exist results windows wont alert user