{"id":58866,"date":"2023-02-17T14:57:22","date_gmt":"2023-02-17T06:57:22","guid":{"rendered":"https:\/\/oihelp.corporate.ifs.com\/help\/sentinel\/sentinel-processes\/digital-state-process\/"},"modified":"2024-07-09T10:01:10","modified_gmt":"2024-07-09T02:01:10","slug":"digital-state-process","status":"publish","type":"page","link":"https:\/\/oihelp.corporate.ifs.com\/help\/sentinel\/sentinel-processes\/digital-state-process\/","title":{"rendered":"Digital State Process"},"content":{"rendered":"\n

The Digital State process is for evaluating different state pairs of the monitor item. The monitor item that is being tested will be in either one of two states. If it is in a Default Entity state, a default state is maintained. If it is in a Primary Limit Entity state, a primary state is reached.<\/p>\n

There are several state pairs to choose from. By default these are:<\/p>\n\n\n\n\n\n\n\n\n
Primary Limit Entity State<\/strong><\/td>\nDefault Entity State<\/strong><\/td>\n<\/tr>\n
Off<\/td>\nOn<\/td>\n<\/tr>\n
Shutdown<\/td>\nRunning<\/td>\n<\/tr>\n
One<\/td>\nZero<\/td>\n<\/tr>\n
0<\/td>\n1<\/td>\n<\/tr>\n
1<\/td>\n0<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

These pairs are defined in the system configuration. You can define additional state pairs in the configuration<\/a> file.\u00a0<\/p>\n

If the monitor item cannot be evaluated against the selected state pair, then an Unknown event is raised.<\/p>\n

\n

State Transition Rules<\/h2>\n

The Digital State process has clearly defined state transition logic paths. Transition from one state to another is equally dependent on the current evaluation of data, and on the current state.<\/p>\n

State transitions cause events to be raised, allowing for the escalation of actions via the Sentinel framework. Different actions can be assigned to different state outcomes.<\/p>\n

Default to Primary: <\/strong>A default state can only transition to the primary state or the unknown state.<\/p>\n

Primary to Secondary: <\/strong>If the primary state endures for the specified secondary duration, a secondary state is reached.<\/p>\n

Secondary to Tertiary: <\/strong>If the secondary state endures for the specified tertiary duration, a tertiary state is reached.<\/p>\n

Unknown: <\/strong>Any state can transition to the unknown State. This state occurs as soon as the state pair cannot be evaluated.<\/p>\n

\n

Test Outcomes<\/h2>\n

A number of outcomes are possible when the Digital State Process is executed:<\/p>\n\n\n\n\n\n\n\n\n
Default State<\/strong><\/td>\nData is in the default entity state, as defined in the state pair.<\/td>\n<\/tr>\n
Primary State<\/strong><\/td>\nData is in the primary entity state, as defined in the state pair.<\/td>\n<\/tr>\n
Secondary State<\/strong><\/td>\nData remains in the primary entity state for a specified duration (secondary duration).<\/td>\n<\/tr>\n
Tertiary State<\/strong><\/td>\nData remains in the secondary state for a specified duration (tertiary duration).<\/td>\n<\/tr>\n
Unknown State<\/strong><\/td>\nIf the monitor item cannot be evaluated against the selected state pair, then an Unknown event is raised.<\/td>\n<\/tr>\n
Suppressed State<\/strong><\/td>\nThe monitor has been suppressed. For example, if a precondition has not been met.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n

Conditional Logic<\/h2>\n

The Digital State 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

Primary Limit<\/h3>\n

During the test, the entity state is evaluated against the state pair.<\/p>\n

If the monitor item is in the default entity state of the selected state pair, then a default event is raised, and a default state is reached. If the monitor item is in the primary entity state as defined by the selected state pair, then a primary event occurs and a primary state is reached.<\/p>\n\n\n\n
<\/td>\n Data Item\u00a0
\n Primary Limit Entity State
\n\u00a0Default Entity State
\n\u00a0Sample Interval
\n\u00a0Trigger Interval<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

The following events are depicted in the graph:<\/p>\n\n\n\n\n\n
<\/td>\nThe monitor item is in the default entity state of the state pair. A default state is reached, and a default<\/strong> event is raised.<\/td>\n<\/tr>\n
<\/td>\nThe monitor item is in the primary limit entity state of the state pair. A primary state is reached, and a primary <\/strong>event is raised.<\/td>\n<\/tr>\n
<\/td>\nThe monitor item has returned to the default entity state of the state pair. A default state is reached, and a default<\/strong> event is raised.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Secondary Duration<\/h3>\n

The duration of the primary state is measured against the secondary duration time period, defined in days, hours, minutes, and seconds. If a primary event lasts for the secondary duration, then a secondary event occurs and a secondary state is reached.<\/p>\n\n\n\n
<\/td>\n\u00a0Data Item
\n\u00a0Primary Limit Entity State
\n\u00a0Default Entity State
\n Secondary Duration Point
\n\u00a0Sample Interval
\n\u00a0Trigger Interval<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

The following events are depicted in the graph:<\/p>\n\n\n\n\n\n\n
<\/td>\nThe monitor item is in the default entity state of the state pair. A default state is reached, and a default<\/strong> event is raised.<\/td>\n<\/tr>\n
<\/td>\nThe monitor item is in the primary limit entity state of the state pair. A primary state is reached, and a primary <\/strong>event is raised.<\/td>\n<\/tr>\n
<\/td>\nAt the next sample interval the data is still in the primary limit entity state. The primary state has endured for the secondary duration. A secondary state is reached, and a secondary <\/strong>event is raised.<\/td>\n<\/tr>\n
<\/td>\nThe monitor item has returned to the default entity state of the state pair. A default state is reached, and a default<\/strong> event is raised.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Tertiary Duration<\/h3>\n

The duration of the secondary state is measured against the tertiary duration period, defined in days, hours, minutes, and seconds. If a secondary state lasts for the tertiary duration, then a tertiary event occurs and a tertiary state is reached.<\/p>\n\n\n\n
<\/td>\n\u00a0Data Item
\n\u00a0Primary Limit Entity State
\n\u00a0Default Entity State
\n Secondary Duration Point
\n\u00a0Sample Interval
\n\u00a0Trigger Interval<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

The following events are depicted in the graph:<\/p>\n\n\n\n\n\n\n
<\/td>\nThe monitor item is in the default entity state of the state pair. A default state is reached, and a default<\/strong> event is raised.<\/td>\n<\/tr>\n
<\/td>\nThe monitor item is in the primary limit entity state of the state pair. A primary state is reached, and a primary <\/strong>event is raised.<\/td>\n<\/tr>\n
<\/td>\nAt the next sample interval the data is still in the primary limit entity state. The primary state has endured for the secondary duration. A secondary state is reached, and a secondary <\/strong>event is raised.<\/td>\n<\/tr>\n
<\/td>\nThe monitor item has returned to the default entity state of the state pair. A default state is reached, and a default<\/strong> event is raised.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n

Adding a Digital State Process<\/h2>\n

Every test uses a specific type of process, and each process has different limits to define; some of these limits are optional.<\/p>\n

The Digital State Process is used for evaluating state pairs (such as On|Off) of the monitor item.<\/p>\n

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

1. In the Process <\/strong>drop-down list, select Digital State<\/strong>.<\/p>\n

2. From the Input<\/strong> drop-down list, select an input from the following:<\/p>\n

Attribute<\/strong>: This option is only available if the Source Type<\/strong> is Entity <\/strong>or Hierarchy<\/strong>.
\nClick the ellipsis button to select an attribute. You are limited to selecting an attribute of the test source monitor items. This attribute of each of the monitor items is a separate process input.<\/p>\n

Source Tag<\/strong>: This option is only available if the Source Type<\/strong> is Tag<\/strong>. If you select this option, then each of the tag monitor items is used as separate process input.<\/p>\n

Calculation<\/strong>: Click the ellipsis button to open the Edit Calculation window.\u00a0<\/p>\n