{"id":58869,"date":"2023-02-17T14:58:47","date_gmt":"2023-02-17T06:58:47","guid":{"rendered":"https:\/\/oihelp.corporate.ifs.com\/help\/sentinel\/sentinel-processes\/logic-process\/"},"modified":"2024-07-09T10:01:57","modified_gmt":"2024-07-09T02:01:57","slug":"logic-process","status":"publish","type":"page","link":"https:\/\/oihelp.corporate.ifs.com\/help\/sentinel\/sentinel-processes\/logic-process\/","title":{"rendered":"Logic Process"},"content":{"rendered":"\n

The Logic process independently evaluates up to four different inputs, each with its own limits and offsets. The different states (state 1 up to state 8), are determined based on the application of various logic rules that use one or more of the input evaluation outcomes as their operands. For example, a State 1 event is raised if the State 1 logic state was defined as:<\/p>\n

Input 1 data is below the Input 1 minimum offset
\nAND Input 2 data is above the Input 2 maximum offset
\nand if both of these conditions occur simultaneously (at the same sample interval)<\/strong><\/p>\n

Also, when used as part of a Logic state expression, the inputs for the Logic process can each have a duration specified, whereby an outcome has to be above the maximum offset for the full specified duration to be considered \u201cabove the maximum offset\u201d, or, likewise, it should be below the minimum offset for the full specified duration to be considered \u201cbelow the minimum offset\u201d.<\/p>\n

Logic Process allows multiple logical combinations and inputs to be used, to determine the different states. This process is particularly useful when you need to measure several inputs simultaneously, and when combinations of conditions should raise various states.<\/p>\n

\n

State Transition Rules<\/h2>\n

Unlike many of the other Sentinel processes, the Logic process does not have a state transition logic path. Transition from one state to another depends entirely on the current evaluation of data, and is unaffected by the current state.<\/p>\n

However, the different states follow a rule of precedence, thus allowing for the escalation of actions based on severity, via the Sentinel framework. Different actions can be assigned to different state outcomes.<\/p>\n

Logic states are given priority in the order they are defined. So, State 1 is evaluated first. If the logic fails, then State 2 is evaluated, and so on. Thus it makes sense to put the highest severity items in the highest positions (State 1 and State 2), and reserve the lower severities for the lowest positions.<\/p>\n

The following table lists the order of precedence for the Logic process logic states.<\/p>\n\n\n\n\n\n\n\n\n\n
Logic State<\/strong><\/td>\nUnder these conditions<\/strong><\/td>\n<\/tr>\n
State 1<\/td>\nThis has the highest priority.<\/td>\n<\/tr>\n
State 2<\/td>\nThis has the second highest priority.<\/td>\n<\/tr>\n
State 3<\/td>\nThis has the third highest priority.<\/td>\n<\/tr>\n
\u2026<\/td>\n\u2026<\/td>\n<\/tr>\n
State N -1<\/td>\nThis has the second lowest priority.<\/td>\n<\/tr>\n
State N<\/td>\nThis has the lowest priority.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n

Test Outcomes<\/h2>\n

A number of outcomes are possible when the Logic process is executed:<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n
Default State<\/strong><\/td>\nThe default state is reached when none of the logic states evaluate to True, and when the monitor is not in a suppressed state.<\/td>\n<\/tr>\n
State 1<\/strong><\/td>\nBoolean logic is applied to the operators and operands defined for State 1. If the logic evaluates to True, and if the monitor is not already in State 1, State 1 is reached and a State 1 event is raised.<\/td>\n<\/tr>\n
State 2<\/strong><\/td>\nBoolean logic is applied to the operators and operands defined for State 2. If the logic evaluates to True, and if the monitor is not already in State 2, State 2 is reached and a State 2 event is raised.<\/td>\n<\/tr>\n
State 3<\/strong><\/td>\nBoolean logic is applied to the operators and operands defined for State 3. If the logic evaluates to True, and if the monitor is not already in State 3, State 3 is reached and a State 3 event is raised.<\/td>\n<\/tr>\n
State 4<\/strong><\/td>\nBoolean logic is applied to the operators and operands defined for State 4. If the logic evaluates to True, and if the monitor is not already in State 4, State 4 is reached and a State 4 event is raised.<\/td>\n<\/tr>\n
State 5<\/strong><\/td>\nBoolean logic is applied to the operators and operands defined for State 5. If the logic evaluates to True, and if the monitor is not already in State 5, State 5 is reached and a State 5 event is raised.<\/td>\n<\/tr>\n
State 6<\/strong><\/td>\nBoolean logic is applied to the operators and operands defined for State 6. If the logic evaluates to True, and if the monitor is not already in State 6, State 6 is reached and a State 6 event is raised.<\/td>\n<\/tr>\n
State 7<\/strong><\/td>\nBoolean logic is applied to the operators and operands defined for State 7. If the logic evaluates to True, and if the monitor is not already in State 7, State 7 is reached and a State 7 event is raised.<\/td>\n<\/tr>\n
State 8<\/strong><\/td>\nBoolean logic is applied to the operators and operands defined for State 8. If the logic evaluates to True, and if the monitor is not already in State 8, State 8 is reached and a State 8 event is raised.<\/td>\n<\/tr>\n
Suppressed State<\/strong><\/td>\nThe monitor has been suppressed. For example, if the precondition has not been met.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n

Conditional Logic<\/h2>\n

The Logic process provides the following conditional logic.<\/p>\n

Note: All of the example graphs in the following sections show tests that have used the Last Known Value sample method.<\/p>\n

Evaluating the Different States<\/h3>\n

Up to eight different states (State 1 through to State 8) can be set up for evaluation. Any state can only be raised if evaluations for preceding states have evaluated to False. For example, State 6 can only be raised if it evaluates to True and State 1, State 2, State 3, State 4 and State 5 all evaluate to False. Likewise, State 3 can only be raised if it evaluates to True and State 1 and State 2 both evaluate to False.<\/p>\n

Mode Settings<\/h3>\n

The mode settings apply to all of the defined Inputs.<\/p>\n

Offset Mode<\/h4>\n

The offset mode is set to be fixed or percentage, and applies to all of the defined limits. When offset mode is fixed value, it is added to (or subtracted from, in the case of a negative offset) the limit value. If an offset is a percentage, then it is multiplied against the limit value and the resulting product is added or subtracted to the limit value.<\/p>\n

Suppress Minimums<\/h4>\n

If the Suppress all minimums if any input is within limits of offsets<\/strong> check box is selected, all inputs are evaluated as a group, in the following way.<\/p>\n

If any of the inputs is within its limits, then none of the other inputs can be evaluated as \u201cbelow minimums\u201d, even if they have had a minimum offset defined. For example, if Input 2 data is within its offset limits, then Input 1, Input 3 and Input 4 cannot be evaluated as \u201cbelow minimum\u201d.<\/p>\n\n\n\n
Data item<\/td>\n Limit<\/td>\n Min Offset<\/td>\n Max Offset<\/td>\n Sample Interval<\/td>\n Input Time (11am)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n\n\n\n\n
Input 1<\/strong>
\n<\/td>\n		\n

At 11:00am, data for Input 1 is below the minimum offset<\/em>.<\/p>\n

However, because Input 2 is within<\/strong> the offset limits at this time, and the Suppress all minimums if any input is within limits of offsets<\/strong> check box is selected, Input 1 is not \u201cbelow minimum\u201d, but \u201cwithin limits\u201d<\/strong>.<\/p>\n<\/td>\n<\/tr>\n

Input 2<\/strong>
\n<\/td>\n		\n

At 11:00am, data for Input 2 is within the offset limits<\/em>.<\/p>\n

Because of this, there can be no \u201cbelow minimum\u201d evaluations for any of the other limits at 11:00am.<\/p>\n<\/td>\n<\/tr>\n

Input 3<\/strong>
\n<\/td>\n		\n

At 11:00am, data for Input 3 is below the minimum offset<\/em>.<\/p>\n

However, because Input 2 is within<\/strong> the offset limits at this time, and the Suppress all minimums if any input is within limits of offsets<\/strong> check box is selected, Input 3 is not \u201cbelow minimum\u201d, but \u201cwithin limits\u201d<\/em><\/strong>.<\/p>\n<\/td>\n<\/tr>\n

Input 4<\/strong>
\n<\/td>\n		\n

At 11:00am, data for Input 4 is above the maximum offset<\/em>.<\/p>\n

Input 4 evaluates as \u201cabove maximum\u201d<\/em><\/strong> at 11:00am.<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Defining Inputs<\/h3>\n

At least one, and up to four different inputs can be set up in the Logic process. Of those inputs that are set up, various evaluation outcomes can be used as operands in the logic applied to the different states. Each input (Input 1, Input 2, Input 3 and Input 4) has its own settings:<\/p>\n

    \n
  • Input<\/strong>: The data that is evaluated.<\/li>\n
  • Limit<\/strong>: The base value from which the offsets are calculated.<\/li>\n
  • Max Offset<\/strong>: If this is selected, then it is the value by which the maximum offset is calculated; this value is applied to the limit, either as a percentage or as an absolute value (depending on the selected offset mode).<\/li>\n
  • Min Offset<\/strong>: If this is selected, then it is the value by which the minimum offset is calculated; this value is applied to the limit, either as a percentage or as an absolute value (depending on the selected offset mode).<\/li>\n
  • Duration<\/strong>: If a duration is defined, this affects the evaluation of an input. An input will only be evaluated as \u201cbelow minimum\u201d when it remains below the minimum offset for longer than that input\u2019s defined duration. Likewise, an input will only be evaluated as \u201cabove maximum\u201d when it remains above the maximum offset for longer than that input\u2019s defined duration.<\/li>\n<\/ul>\n

    Example: Evaluating an Input with Min Offset Duration<\/h3>\n

    The following example demonstrates how an input is only evaluated as \u201cbelow minimum\u201d after a certain duration. In this example, duration is defined as 1 hour and 55 minutes.<\/p>\n\n\n\n
    \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 09:00am\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 10:00am\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a011:00am<\/strong>
    \n<\/td>\n    		 Data item
    \n Limit
    \n Min Offset
    \n Max Offset
    \n Sample Interval
    \n Input Time<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n\n
    \n

    At 09:00am, <\/strong>data is below the minimum offset. Duration is 0 hours. For Input 1, data is \u201cwithin limits\u201d<\/p>\n

    At 10:00am<\/strong> data has been below the minimum offset for 1 hour. For Input 1, data is still \u201cwithin limits\u201d<\/p>\n

    At 11:00am<\/strong> data has been below the minimum offset for 2 hours, which is longer than the defined duration (1 hour and 55 minutes) for Input 1. For Input 1, data is now \u201cbelow minimum.\u201d<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Determining States<\/h3>\n

    The Logic process requires that at least one state (State 1) is defined. Up to eight different states can be defined. Each state is made up of a combination of outcomes of the various inputs.<\/p>\n

    For example, State 1 can be defined as: 1 Max AND 3 Min OR 2 Max AND 4 Min<\/p>\n

    In order for State 1 to be raised, the following evaluations must occur simultaneously: Input 1 evaluates to \u201cabove maximum\u201d AND Input 3 evaluates to \u201cbelow minimum\u201d OR Input 2 evaluates to \u201cabove maximum\u201d AND Input 4 evaluates to \u201cbelow minimum\u201d.<\/p>\n

    How the Logic Process Evaluates Conditions<\/h4>\n

    Each state has up to four operands, with up to three logical operators. The Logic process uses Boolean logic to evaluate conditions.<\/p>\n

    In Boolean Logic, the rules to be aware of are:<\/p>\n

      \n
    • \u201cAnd\u201d takes precedence over \u201cor\u201d<\/li>\n
    • \u201cTrue and True\u201d evaluates to True<\/li>\n
    • \u201cTrue and False\u201d evaluates to False<\/li>\n
    • \u201cFalse and False\u201d evaluates to False<\/li>\n
    • \u201cTrue or False\u201d evaluates to True<\/li>\n
    • \u201cFalse or False\u201d evaluates to False<\/li>\n
    • \u201cTrue or True\u201d evaluates to True<\/li>\n<\/ul>\n

      For Sentinel, group pairs according to the precedence rules, and then from left to right, to better understand how the logical evaluation is performed:<\/p>\n

      1 Min and 2 Max or 3 Min and 4 Min groups to:<\/p>\n

      (1 Min and 2 Max) or (3 Min and 4 Min), and is evaluated as:<\/p>\n

      (True) or (False), which is further evaluated to the final outcome:<\/p>\n

      True<\/p>\n

      The following table demonstrates how various states have been set up, and are then evaluated. The highest state (closest to State 1) takes precedence over other states.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n
      Evaluate:<\/strong><\/td>\nExpression evaluates to:<\/strong><\/td>\nEvaluates to<\/strong><\/td>\nRaises a State<\/strong><\/td>\n<\/tr>\n
      Operand & (operator)<\/td>\n1<\/td>\n(1)<\/td>\n2<\/td>\n(2)<\/td>\n3<\/td>\n(3)<\/td>\n4<\/td>\n <\/td>\n <\/td>\n<\/tr>\n
      State 1<\/td>\nTrue<\/td>\nAND<\/td>\nTrue<\/td>\nAND<\/td>\nFalse<\/td>\nOR<\/td>\nFalse<\/td>\nFalse<\/td>\nNo state raised (False outcome)<\/td>\n<\/tr>\n
      State 2<\/td>\nTrue<\/td>\nAND<\/td>\nFalse<\/td>\nOR<\/td>\nTrue<\/td>\nAND<\/td>\nTrue<\/td>\nTrue<\/td>\nState 2 is raised<\/td>\n<\/tr>\n
      State 3<\/td>\nTrue<\/td>\nAND<\/td>\nTrue<\/td>\nAND<\/td>\nTrue<\/td>\nAND<\/td>\nTrue<\/td>\nTrue<\/td>\nState 2 takes precedence<\/td>\n<\/tr>\n
      State 4<\/td>\nTrue<\/td>\nOR<\/td>\nFalse<\/td>\nAND<\/td>\nTrue<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\nState 2 takes precedence<\/td>\n<\/tr>\n
      State 5<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\nNo State Defined<\/td>\n<\/tr>\n
      State 6<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\nNo State Defined<\/td>\n<\/tr>\n
      State 7<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\nNo State Defined<\/td>\n<\/tr>\n
      State 8<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\n-<\/td>\nNo State Defined<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

      In the example, State 1<\/strong> is evaluated as follows:<\/p>\n\n\n\n\n\n\n\n\n
      Operand 1<\/strong><\/td>\nOperator 1<\/strong><\/td>\nOperand 2<\/strong><\/td>\nOperator 2<\/strong><\/td>\nOperand 3<\/strong><\/td>\nOperator 3<\/strong><\/td>\nOperand 4<\/strong><\/td>\nFinal Outcome<\/strong><\/td>\n<\/tr>\n
      1 Max<\/td>\nAND<\/td>\n3 Min<\/td>\nAND<\/td>\n2 Max<\/td>\nOR<\/td>\n4 Min<\/td>\n <\/td>\n<\/tr>\n
      True<\/td>\nAND<\/td>\nTrue<\/td>\nAND<\/td>\nFalse<\/td>\nOR<\/td>\nFalse<\/td>\n <\/td>\n<\/tr>\n
       <\/td>\n <\/td>\nTrue<\/td>\nAND<\/td>\nFalse<\/td>\nOR<\/td>\nFalse<\/td>\n <\/td>\n<\/tr>\n
       <\/td>\n <\/td>\n <\/td>\n <\/td>\nFalse<\/td>\nOR<\/td>\nFalse<\/td>\n <\/td>\n<\/tr>\n
       <\/td>\n <\/td>\n <\/td>\n <\/td>\n <\/td>\n <\/td>\n <\/td>\nFalse<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

      State 2<\/strong> is evaluated as follows:<\/p>\n\n\n\n\n\n\n\n
      Operand 1<\/strong><\/td>\nOperator 1<\/strong><\/td>\nOperand 2<\/strong><\/td>\nOperator 2<\/strong><\/td>\nOperand 3<\/strong><\/td>\nOperator 3<\/strong><\/td>\nOperand 4<\/strong><\/td>\nFinal Outcome<\/strong><\/td>\n<\/tr>\n
      1 Max<\/td>\nAND<\/td>\n4 Min<\/td>\nOR<\/td>\n2 Min<\/td>\nAND<\/td>\n3 Min<\/td>\n <\/td>\n<\/tr>\n
      True<\/td>\nAND<\/td>\nFalse<\/td>\nOR<\/td>\nTrue<\/td>\nAND<\/td>\nTrue<\/td>\n <\/td>\n<\/tr>\n
       <\/td>\n <\/td>\nFalse<\/td>\nOR<\/td>\n <\/td>\n <\/td>\nTrue<\/td>\n <\/td>\n<\/tr>\n
       <\/td>\n <\/td>\n <\/td>\n <\/td>\n <\/td>\n <\/td>\n <\/td>\nTrue<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

      State 3<\/strong> is evaluated as follows:<\/p>\n\n\n\n\n\n\n\n
      Operand 1<\/strong><\/td>\nOperator 1<\/strong><\/td>\nOperand 2<\/strong><\/td>\nOperator 2<\/strong><\/td>\nOperand 3<\/strong><\/td>\nOperator 3<\/strong><\/td>\nOperand 4<\/strong><\/td>\nFinal Outcome<\/strong><\/td>\n<\/tr>\n
      1 Max<\/td>\nAND<\/td>\n3 Min<\/td>\nAND<\/td>\n2 Min<\/td>\nAND<\/td>\n4 Max<\/td>\n <\/td>\n<\/tr>\n
      True<\/td>\nAND<\/td>\nTrue<\/td>\nAND<\/td>\nTrue<\/td>\nAND<\/td>\nTrue<\/td>\n <\/td>\n<\/tr>\n
       <\/td>\n <\/td>\nTrue<\/td>\nAND<\/td>\n <\/td>\n <\/td>\nTrue<\/td>\n <\/td>\n<\/tr>\n
       <\/td>\n <\/td>\n <\/td>\n <\/td>\n <\/td>\n <\/td>\n <\/td>\nTrue<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

      and so on.<\/p>\n

      Definition of Operands in the Logic Process<\/h4>\n

      The following operands are available to the Logic Process. Note that for any of the limits, \u201cwithin limits\u201d means that a limit has not been exceeded. In these definitions, N could be 1, 2, 3 or 4 and is referring to the different inputs: Input 1, Input 2, Input 3, Input 4.<\/p>\n\n\n\n\n\n\n
      N Min<\/strong><\/td>\nIf the input value for N is currently lower than the minimum offset for N, and has been, continuously, for longer than the defined duration (if any duration has been defined for Limit N) , or if it is currently lower than the minimum offset for N (if no duration has been defined) then N Min evaluates to True. Otherwise, it evaluates to False.<\/p>\n

      Example: 1 Min, refers to the Minimum Offset for Input 1.<\/td>\n<\/tr>\n

      N Max<\/strong><\/td>\nIf the input value for N is currently higher than the maximum offset for N, and has been, continuously, for longer than the defined duration (if any duration has been defined for Limit N) , or if it is currently higher than the maximum offset for N (if no duration has been defined) then N Max evaluates to True. Otherwise, it evaluates to False.<\/p>\n

      Example: 2 Max, refers to the Maximum Offset for Input 2.<\/td>\n<\/tr>\n

      N Out<\/strong><\/td>\nIf the input value for N is currently lower than the minimum offset for N, and has been, continuously for longer than the defined duration (if any duration has been defined for Limit N) , or if it is currently lower than the minimum offset for N (if no duration has been defined) then N Min evaluates to True. Otherwise, it evaluates to False.
      \nExample: 1 Min, refers to the Minimum Offset for Input 1.<\/p>\n

      Or, if the input value for N is currently higher than the maximum offset for N, and has been, continuously, for longer than the defined duration (if any duration has been defined for Limit N) , or if it is currently higher than the maximum offset for N (if no duration has been defined) then N Max evaluates to True. Otherwise, it evaluates to False.<\/p>\n

      Example: 2 Out, refers to the Maximum Offset and the Minimum Offset for Input 2.<\/td>\n<\/tr>\n

      N In<\/strong><\/td>\nIf the input value for N is less than or equal to the maximum offset value, and also greater than or equal to the minimum offset value (regardless of duration), then N In evaluates to True. Otherwise, it evaluates to False.
      \nExample: 2 In, refers to the Maximum Offset and the Minimum Offset for Input 2.<\/p>\n

      N In, with Suppress all minimums\u2026<\/strong>
      \nIf the Suppress all minimums if any input is within limits of offsets<\/strong> check box is selected, and if any of the other inputs is within limits then the minimum offset is ignored. In these circumstances, if the input value is less than or equal to the Maximum Offset, then N In evaluates to True. Otherwise it evaluates to False.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

      Example: Determining States<\/h4>\n

      The following illustration demonstrates how at 11:00am State 1 is raised when Input 1 evaluates to \u201cabove maximum\u201d while Input 3 evaluates to \u201cbelow minimum\u201d.<\/p>\n\n\n\n
      Data item<\/td>\n Limit<\/td>\n Min Offset<\/td>\n Max Offset<\/td>\n Sample Interval<\/td>\n Input Time (11am)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n\n\n\n\n\n
      Input evaluation<\/strong><\/td>\nLogical evaluation<\/strong><\/td>\n<\/tr>\n
      Input 1<\/td>\n At 11:00am, data for Input 1 is above the maximum offset.
      \nFor Input 1, data is \u201cabove maximum\u201d.<\/td>\n      		Input 3 <\/td>\n At 11:00am, data for Input 3 is below the minimum offset.
      \nFor Input 3, data is \u201cbelow minimum\u201d.<\/td>\n      		1 Max and 3 Min<\/strong><\/span><\/td>\n<\/tr>\n
      \u00a0<\/td>\n1 Max<\/em>
      \ntrue<\/em><\/td>\n      		and<\/em>
      \nand<\/em><\/td>\n      		3 Min<\/em>
      \ntrue<\/em><\/td>\n
      \ntrue<\/em><\/strong><\/span><\/td>\n<\/tr>\n
      Input 2<\/td>\n At 11:00am, data for Input 2 is within the offset limits.
      \nFor Input 2, data is \u201cwithin limits\u201d, that is it\u2019s not \u201cabove maximum\u201d.<\/td>\n      		Input 4<\/td>\n At 11:00am, data for Input 4 is below the minimum offset.
      \nFor Input 4, data is \u201cbelow minimum\u201d.<\/td>\n      		2 Max and 4 Min<\/strong><\/span><\/td>\n<\/tr>\n
      \u00a0<\/td>\n2 Max<\/em>
      \nfalse<\/em><\/td>\n      		and<\/em>
      \nand<\/em><\/td>\n      		4 Min<\/em>
      \ntrue<\/em><\/td>\n
      \nfalse<\/em><\/strong><\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

      1 Max AND 3 Min OR 2 Max AND 4 Min evaluates to TRUE OR FALSE.<\/p>\n

      TRUE OR FALSE evaluates to TRUE. Thus a State 1 event is raised, and State 1 is reached.<\/p>\n

      \n

      Adding a Logic Process<\/h2>\n

      The Sentinel Logic Process uses Boolean logic to use the outcome of up to four different inputs to establish various states.<\/p>\n

      Setting Process Values and Limits<\/h3>\n

      Part of setting up the Logic process involves selecting values, such as the different inputs, the different limits, and the minimum and maximum offsets. Values can either be fixed, or they can be variable data taken from tags.<\/p>\n

      The following values are available. Select a value type from the drop-down list, then type in or select a value.<\/p>\n

        \n
      • Fixed Value<\/strong>: If you choose this, type in a fixed numerical value. Note: This is not an option for Input 1.<\/li>\n
      • Attribute<\/strong>: This option is only available if the test\u2019s Source Type<\/strong> is Entity <\/strong>or Hierarchy<\/strong>. Click the ellipsis button to select an attribute of the source entities.<\/li>\n
      • Source Tag<\/strong>: This option is only available if the Source Type<\/strong> is Tag<\/strong>.<\/li>\n
      • Calculation<\/strong>: Click the ellipsis button to open the Edit Calculation window.\u00a0\n
          \n
        • If the Source Type is Entity<\/strong> or Hierarchy<\/strong>: Type a calculation, prefixed by \u2018this\u2019 as the Source Entity<\/strong> token, for example: {this:THP} + 34<\/strong>.<\/li>\n
        • If the Source Type is Tag<\/strong>: Type a calculation, prefixed by \u2018this\u2019 as the Source<\/strong> Tag<\/strong> token, for example: {this} * 2<\/strong>.<\/li>\n<\/ul>\n<\/li>\n
        • Tag<\/strong>: Click the ellipsis button to select a tag.<\/li>\n
        • Entity Attribute<\/strong>: Click the ellipsis button to select an entity. From here, select an attribute, or attribute value, for the selected entity.<\/li>\n<\/ul>\n

          Adding the Process<\/h3>\n

          As with all Sentinel processes, the Logic Process is defined within a Sentinel Test page. In the Sentinel Test<\/strong> page:<\/p>\n

          1. Expand the Process<\/strong> panel.<\/p>\n

          2. Select Logic from the Process<\/strong> drop-down list.<\/p>\n

          The screen now shows the details for the Logic process.<\/p>\n

          \"C:\\Users\\gxl1129\\AppData\\Local\\Temp\\SNAGHTML3d5e1f52.PNG\"<\/p>\n

          Mode Settings<\/h4>\n

          The mode settings apply to all of the offsets defined in the process. The following options are available:<\/p>\n

            \n
          • Offset Mode<\/strong>: Percentage or Absolute Value. The offset mode determines how the max and min offsets for the various inputs are calculated from their defined limits.<\/li>\n
          • Suppress all minimums if any input is within the limit of offsets<\/strong>: Select the check box if you want to suppress all minimums, when any input is within the offset limits.<\/li>\n
          • End evaluating on false state<\/strong>: Select this check box to stop the process from continuing, after evaluating a state as false.<\/li>\n
          • Skip previous states<\/strong>: Select this check box to prevent the process from evaluating previous states and start from the current active state. If at State N, the process will skip evaluation of States 1 to N-1 on next run.<\/li>\n
          • Skip current state, when all states evaluated returns to default<\/strong>: This check box is only available if Skip previous states has been selected. Select this check box to stop the process from evaluating the current state and previous states. If at State N, the process skips evaluation of State 1 to N and starts at State N+1. Upon reaching the last State, the process will return to a default state.<\/li>\n<\/ul>\n

            Inputs<\/h4>\n

            At least one and up to four different Inputs need to be specified for the Logic process.<\/p>\n

            Note: During processing, the inputs are evaluated in order of precedence (Input 1 having the highest precedent).<\/p>\n

            Input 1 (Required)<\/h5>\n

            \"C:\\Users\\gxl1129\\AppData\\Local\\Temp\\SNAGHTML670ba2c4.PNG\"<\/p>\n

            3. From the Input<\/strong> drop-down list, select one of the following and then select a corresponding value:<\/p>\n

              \n
            • Attribute (only available if the Source<\/strong> Type<\/strong> is Entity or Hierarchy)<\/li>\n
            • Source Tag (only available if the Source<\/strong> Type<\/strong> is Tag)<\/li>\n
            • Calculation<\/li>\n
            • Tag<\/li>\n
            • Entity Attribute<\/li>\n<\/ul>\n

              4. From the Limit <\/strong>drop-down list, select one of the following and then type in or select a corresponding value:<\/p>\n

                \n
              • Fixed Value<\/li>\n
              • Attribute (only available if the Source<\/strong> Type<\/strong> is Entity or Hierarchy)<\/li>\n
              • Source Tag (only available if the Source<\/strong> Type<\/strong> is Tag)<\/li>\n
              • Calculation<\/li>\n
              • Tag<\/li>\n
              • Entity Attribute<\/li>\n<\/ul>\n

                5. Optionally define a Max Offset<\/strong>.<\/p>\n

                Note: You must select either a Max Offset or a Min Offset, or both.<\/p>\n

                  \n
                1. Select the Max Offset<\/strong> check box.<\/li>\n
                2. From the Max Offset <\/strong>drop-down list, select one of the following and then type in or select a corresponding value:<\/li>\n<\/ol>\n
                    \n
                  • Fixed Value<\/li>\n
                  • Attribute (only available if the Source<\/strong> Type is Entity or Hierarchy)<\/li>\n
                  • Source Tag (only available if the Source<\/strong> Type<\/strong> is Tag)<\/li>\n
                  • Calculation<\/li>\n
                  • Tag<\/li>\n
                  • Entity Attribute<\/li>\n<\/ul>\n

                    6. Optionally define a Min Offset<\/strong>.<\/p>\n

                      \n
                    1. Select the Min Offset<\/strong> check box.<\/li>\n
                    2. From the Min Offset <\/strong>drop-down list, select one of the following and then type in or select a corresponding value:<\/li>\n<\/ol>\n
                        \n
                      • Fixed Value<\/li>\n
                      • Attribute (only available if the Source<\/strong> Type is Entity or Hierarchy)<\/li>\n
                      • Source Tag (only available if the Source<\/strong> Type<\/strong> is Tag)<\/li>\n
                      • Calculation<\/li>\n
                      • Tag<\/li>\n
                      • Entity Attribute<\/li>\n<\/ul>\n

                        7. Optionally define a duration<\/strong>.<\/p>\n

                          \n
                        1. Select the Duration <\/strong>check box.<\/li>\n
                        2. Type integer values in the days<\/strong>, hours<\/strong>, mins <\/strong>(minutes), and secs <\/strong>(seconds) Duration Limit <\/strong>boxes to define a duration period. The default value is zero.<\/li>\n<\/ol>\n
                          Inputs 2, 3 and 4 (Optional)<\/h5>\n

                          8. Select the check box to the left of the relevant Input panel (e.g. Input 2).<\/p>\n

                          <\/p>\n

                          9. From the Input<\/strong> drop-down list, select one of the following and then select a corresponding value:<\/p>\n

                            \n
                          • Fixed Value<\/li>\n
                          • Attribute (only available if the Source<\/strong> Type is Entity or Hierarchy)<\/li>\n
                          • Source Tag (only available if the Source<\/strong> Type<\/strong> is Tag)<\/li>\n
                          • Calculation<\/li>\n
                          • Tag<\/li>\n
                          • Entity Attribute<\/li>\n<\/ul>\n

                            10. Capture the Limit, Max Offset, Min Offset and optional Duration for Inputs 2-4, following the instructions for defining Input 1.<\/p>\n

                            Logic State Settings<\/h4>\n

                            At least one logic state (State 1) and up to eight logic states must be selected for the Logic Process.<\/p>\n

                            For each logic state that you want to set up for the process, do the following:<\/p>\n

                            11. Select the check box to the right of the logic state name.<\/p>\n

                            Note: The State 1<\/strong> check box is already selected, as this is a required state for this process.<\/p>\n

                            12. Select the operands and operators to build up a logical expression for the state.<\/p>\n

                            <\/p>\n\n\n\n
                            \"\"\u00a0Operands 1, 2, 3 and 4<\/td>\n\"\"\u00a0Operators 1, 2 and 3<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

                            13. Select the first operand from the first drop-down list for State 1.<\/p>\n

                            The operands all relate to the Min Offsets and Max Offsets of the various Inputs. All possibilities are listed in the drop-down; however, you may only select valid options (that is, options that are defined in the Inputs section). So, for example, you should not select Min 4 if you have not defined Input 4 as one of your inputs, or if you have not defined a Min Offset for Input 4.<\/p>\n

                            The operand drop-down list comprises of the following:<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
                            -<\/strong><\/td>\nThis equates to no selection, and is the default.<\/td>\n<\/tr>\n
                            1 Min<\/td>\nIf the data for Input 1 is lower than the Min Offset for Input 1, for the defined duration (if applicable), 1 Min evaluates to True, otherwise False.<\/td>\n<\/tr>\n
                            1 Max<\/td>\nIf the data for Input 1 is higher than the Max Offset for Input 1, for the defined duration (if applicable), 1 Max evaluates to True, otherwise False.<\/td>\n<\/tr>\n
                            1 Out<\/td>\nIf the data for Input 1 is either higher than the Max Offset for Input 1, or lower than the Min Offset for Input 1, for the defined duration (if applicable), 1 Out evaluates to True, otherwise False.<\/td>\n<\/tr>\n
                            1 In (\u201cWithin Limits\u201d)<\/td>\nIf the data for Input 1 is between the Max Offset for Input 1, and the Min Offset for Input 1, for the defined duration (if applicable), 1 In evaluates to True, otherwise False.
                            \nIf the Suppress all minimums if any input is within limits of offsets<\/strong> check box is selected, and any of the other inputs is \u201cwithin limits\u201d, then if data for Input 1 is below the Max Offset for Input 1, 1 In evaluates to True, otherwise False.<\/td>\n<\/tr>\n
                            2 Min<\/td>\nIf the data for Input 2 is lower than the Min Offset for Input 2,for the defined duration (if applicable), 2 Min evaluates to True, otherwise False.<\/td>\n<\/tr>\n
                            2 Max<\/td>\nIf the data for Input 2 is higher than the Max Offset for Input 2, for the defined duration (if applicable), 2 Max evaluates to True, otherwise False.<\/td>\n<\/tr>\n
                            2 Out<\/td>\nIf the data for Input 2 is either higher than the Max Offset for Input 2, or lower than the Min Offset for Input 2, for the defined duration (if applicable), 2 Out evaluates to True, otherwise False.<\/td>\n<\/tr>\n
                            2 In (\u201cWithin Limits\u201d)<\/td>\nIf the data for Input 2 is between the Max Offset for Input 2, and the Min Offset for Input 2, for the defined duration (if applicable), 2 In evaluates to True, otherwise False.
                            \nIf the Suppress all minimums if any input is within limits of offsets<\/strong> check box is selected, and any of the other inputs is \u201cwithin limits\u201d, then if data for Input 2 is below the Max Offset for Input 2, 2 In evaluates to True, otherwise False.<\/td>\n<\/tr>\n
                            3 Min<\/td>\nIf the data for Input 3 is lower than the Min Offset for Input 3, for the defined duration (if applicable), 3 Min evaluates to True, otherwise False.<\/td>\n<\/tr>\n
                            3 Max<\/td>\nIf the data for Input 3 is higher than the Max Offset for Input 3, for the defined duration (if applicable), 3 Max evaluates to True, otherwise False.<\/td>\n<\/tr>\n
                            3 Out<\/td>\nIf the data for Input 3 is either higher than the Max Offset for Input 3, or lower than the Min Offset for Input 3, for the defined duration (if applicable), 3 Out evaluates to True, otherwise False.<\/td>\n<\/tr>\n
                            3 In (\u201cWithin Limits\u201d)<\/td>\nIf the data for Input 3 is between the Max Offset for Input 3, and the Min Offset for Input 3, for the defined duration (if applicable), 3 In evaluates to True, otherwise False.
                            \nIf the Suppress all minimums if any input is within limits of offsets<\/strong> check box is selected, and any of the other inputs is \u201cwithin limits\u201d, then if data for Input 3 is below the Max Offset for Input 3, 3 In evaluates to True, otherwise False<\/td>\n<\/tr>\n
                            4 Min<\/td>\nIf the data for Input 4 is lower than the Min Offset for Input 4 , for the defined duration (if applicable), 4 Min evaluates to True, otherwise False.<\/td>\n<\/tr>\n
                            4 Max<\/td>\nIf the data for Input 4 is higher than the Max Offset for Input 4, for the defined duration (if applicable), 4 Max evaluates to True, otherwise False.<\/td>\n<\/tr>\n
                            4 Out<\/td>\nIf the data for Input 4 is either higher than the Max Offset for Input 4, or lower than the Min Offset for Input 4, for the defined duration (if applicable), 4 Out evaluates to True, otherwise False.<\/td>\n<\/tr>\n
                            4 In (\u201cWithin Limits\u201d)<\/td>\nIf the data for Input 4 is between the Max Offset for Input 4, and the Min Offset for Input 4, for the defined duration (if applicable), 4 In evaluates to True, otherwise False.
                            \nIf the Suppress all minimums if any input is within limits of offsets<\/strong> check box is selected, and any of the other inputs is \u201cwithin limits\u201d, then if data for Input 4 is below the Max Offset for Input 4, 4 In evaluates to True, otherwise False<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

                            14. Select the first operator from the next drop-down list for State 1.<\/p>\n

                            This is used for the logical evaluation, and can be any of the following:<\/p>\n

                            -, And, Or.<\/p>\n

                            15. Select the remaining operands and operators that you want to use for the expression.<\/p>\n

                            The final expression will look similar to this:<\/p>\n

                            <\/p>\n

                            16. Continue adding logical expressions for up to 7 additional states, until you have all the states that you want for this process. For each additional state:<\/p>\n

                            <\/p>\n

                              \n
                            1. Select the check box next to the state.<\/li>\n
                            2. Specify the Expression<\/strong> to evaluate, as per step 2.<\/li>\n
                            3. If required, apply a Restriction<\/strong> by selecting the check box below the expression.<\/li>\n<\/ol>\n

                              Enabling a restriction allows you to restrict the time that the state can be evaluated as true. The options in the drop-down list are:<\/p>\n

                              Evaluates true only within: This option evaluates the state as true only within the specified time period (DD:HH:MM:SS) of the previous state. This requires the process to only evaluate the state as true within the time restriction. If at State N with time restriction X, then any time after X of State N-1 being evaluated as true will indefinitely return false until the next time State N-1 is raised after departing State N-1.<\/p>\n

                              Evaluates true after: This option evaluates the state as true only after the specified time period (DD:HH:MM:SS) of the previous states. This requires the process to only evaluate the state as true after the time restriction. If at State N with time restriction X, then any time before X of State N-1 being evaluating true will return false until the time restriction has been met.<\/p>\n

                              17. If you have applied the above restriction, you also have the option of selecting Return to default state after exceeding restriction<\/strong>.<\/p>\n

                              When selected, the process returns to the default state when restrictions have been exceeded, as follows:<\/p>\n