Skip to content

Condition Management

Early Access Functionality

Asset Condition Lifecycle Management functionality is currently in an Early Access BETA state. Please contact Exosite's support for more information about getting early access to this new feature set.

Overview

The Condition Management functionality allows users to open and manage a condition for an asset. Conditions can be automatically opened by a Rule or manually be created by a user. All conditions are tied to a Condition Policy which can provide context to the situation and offer recommended actions. Condition Policies can be standardized and used across many assets. A condition is associated to an Asset. When created by a Rule, the rule, signal are also associated.

Notes about Conditions

  • Each condition is uniquely numbered for an Asset.
  • Condition Policies support translations
  • Condition Policy description can be written in Markdown text format

Conditions support 'comments' by users, which can be used to provide updates and information such as actions taken, any troubleshooting details, etc.

Condition States

The following lifecycle states are supported for a condition.

State Description
Unacknowledged The state when created. Can be created by a Rule or Manually by a User
Acknowledged A user has Acknowledged the condition.
Assigned A user has been assigned.
Closed The condition has been closed.

Note that while a condition is open, no new condition of the same policy will be created for that asset. If a Rule that created the condition continues to change it's state (example: warning -> normal -> critical -> normal -> warning), it will have no affect on the open condition.

The condition does not automatically close. A user must close the condition.

Condition Priorities

Condition Policies specify the priority, this is a decision by users who define the policies.

  • Minor
  • Major
  • Critical
  • Blocker

These priorities have no further definition and is up to the user to determine how to apply the levels to their processes

Condition Lifecycle Flow

sequenceDiagram
  autonumber
  participant Signal Data
  participant Rule
  participant Condition Policy
  participant Condition 
  actor User
  Signal Data -->>Rule: New Values
  activate Rule
  rect rgba(255, 0, 0,.1)
  Rule->>Rule: Detect Condition
  deactivate Rule
  Note right of Rule: Rule Critical or Warning State Change!
  end
  Rule-->>Condition Policy: Condition Detected
  Condition Policy-->>Condition Policy: Is there an open Condition?
  Condition Policy->>Condition: No, Create New
  activate Condition
  Note right of Condition: New Condition<br>Unacknowledged
  User->>Condition: Acknowledge
  Note right of Condition:  Acknowledged

  Signal Data -->>Rule: New Values
  activate Rule
  rect rgba(0, 255, 0,.1)
  Rule->>Rule: Detect Condition
  deactivate Rule
  Note right of Rule: Rule Back to Ok State.
  end

  User->>Condition: Assign
  Note right of Condition:  Assigned

  Signal Data -->>Rule: New Values
  activate Rule
  rect rgba(255, 0, 0,.1)
  Rule->>Rule: Detect Condition
  deactivate Rule
  Note right of Rule: Rule Critical or Warning State Change!
  end
  Rule-->>Condition Policy: Condition Detected
  Condition Policy-->>Condition Policy: Is there an open Condition?
  Note right of Condition Policy: Yes, No action<br>(Condition Exists)

  User->>User: Take recommended actions.
  User->>Condition: Close
  Note right of Condition:  Closed
  deactivate Condition

Need to schedule Maintenance?

You can create a new Work Order in ExoSense directly from a condition by using the more vertical menu in the condition list.

If you use a separate application for managing maintenance, a link to this tool and interface can be added to your Condition Policy.

Condition Management

The Conditions page can be found using the left navigation menu. This page will show a list of conditions for user roles with Condition Read-Only or Condition User permissions, filtered by default to not show closed conditions. User Roles with the Condition Policy Management permission will also see the Condition Policy tab to manage policies.

Conditions Badge Settings

The side menu badge for Conditions by default will show the number of active Conditions. This can be configured as a user preference in the User account Profile Preferences.

Conditions and Signal Rules

To associate a Signal Rule in your asset to a Condition Policy, use the Asset Configuration page to Add/Edit Actions for the specific Rule.

Here, the Condition Policy Action is available to choose from the available Condition Policies.

Don't see the Condition Policy Action?

Check with an administrator, they may not have the Condition Policy Action set up yet.

Once this is setup for the rule, when the Rule state changes to warning and/or critical (this is specified by the Administrator) a new condition will be created if there is currently not an open condition. If there is already an open condition, it will stay open.

Manually Create a Condition

Using the (+) button on the Conditions list page you can manually add a new Condition. When creating a condition, an Asset and Condition Policy are required. You may also add a description of why the Condition is being created and choose a priority. The condition can be assigned or left unassigned.

Condition Policies

A condition policy specifies a type of condition with descriptive information and details for corrective action. These are fully defined by an operator or manager role with the permission. At least one Policy must be set up to use Conditions.

It's recommended to create a default 'general' policy for use when a condition needs to be manually tracked that may not have a specific policy in place.

The policy description format is in Markdown syntax

There are many sites with guides to Markdown syntax as it is widely used for documentation (including this Exosite documentation).

Here are a few to check out:

The Condition Policy ID is used only once, when setting up the default policy as a Rule Action.

Condition Action Setup

The Condition feature can be though of as a type of Rule Action. To use Conditions with Rules, an Administrator must first set up an Action type. This is a one time setup. The default policy ID is used here.

Exporting Condition Records

The Conditions list and individual Conditions can be exported using the 'Export Menu' icon in the upper header. The export options for the list include image, print, pdf, and two file output options CSV and JSON. The options for exporting an individual Condition are PDF, JSON, and Image.

This feature and specific export options may not be available on all solutions. Contact administrator for more information.

Export Method Description
PDF The PDF export options allow exporting the condition list or specific condition as a PDF file, which will be downloaded to your computer via your browser. You can choose in PDF mode to use page breaks and adjust the resolution.
Image The Image export options exports condition list or specific condition as a single continuous image (.jpg). Image quality is adjustable as an option.
Print This will bring up the print dialog for your browser and computer. (Condition List only)
CSV The CSV export will generate a CSV file that contains the current list of Conditions. (Condition List only)
JSON The JSON export will generate a file that contains the specific Condition or all Conditions from the current list in JSON format.
Condition List - CSV Export Format Example
Asset Name,Condition ID,Condition Name,Group Name,Signal Name,Rule Name,Assignee,Created At,Updated At,Priority,Status
Pump 2755,11,Pump Electrical Issue,Anderson Co.,,,,2023-07-27T20:26:54.663Z,2023-07-27T20:26:54.663Z,Minor,Unacknowledged
Pump 2755,10,Pump Electrical Issue,Anderson Co.,,,Tony Oliva,2023-05-26T15:07:39.473Z,2023-05-26T15:07:39.836Z,Critical,Assigned
Pump 2755,9,Pump Overheating,Anderson Co.,Pump Temperature,Pump Temperature - Threshold,,2023-03-15T20:51:58.270Z,2023-03-15T20:51:58.270Z,Minor,Unacknowledged
Pump 2755,8,Pump Electrical Issue,Anderson Co.,,,,2023-03-15T20:04:30.658Z,2023-03-15T20:04:30.658Z,Critical,Unacknowledged
Asset Name Condition ID Condition Name Group Name Signal Name Rule Name Assignee Created At Updated At Priority Status
Pump 2755 11 Pump Electrical Issue Anderson Co. 2023-07-27T20:26:54.663Z 2023-07-27T20:26:54.663Z Minor Unacknowledged
Pump 2755 10 Pump Electrical Issue Anderson Co. Tony Oliva 2023-05-26T15:07:39.473Z 2023-05-26T15:07:39.836Z Critical Assigned
Pump 2755 9 Pump Overheating Anderson Co. Pump Temperature Pump Temperature - Threshold 2023-03-15T20:51:58.270Z 2023-03-15T20:51:58.270Z Minor Unacknowledged
Pump 2755 8 Pump Electrical Issue Anderson Co. 2023-03-15T20:04:30.658Z 2023-03-15T20:04:30.658Z Critical Unacknowledged
Condition - JSON Export Format
    {
    "condition": {
        "assetName": "Pump 2755",
        "assignee": "Tony Oliva",
        "conditionId": 12,
        "conditionName": "Pump Overheating",
        "groupName": "Anderson Co.",
        "priority": "Major",
        "ruleName": "Pump Temperature - Threshold",
        "signalName": "Pump Temperature",
        "status": "Assigned",
        "createdAt": "2023-08-07T20:07:27.058Z",
        "updatedAt": "2023-08-07T20:12:23.478Z"
    },
    "comments": [],
    "history": [
        {
        "status": "Unacknowledged",
        "title": "Condition Opened"
        },
        {
        "status": "Assigned",
        "title": "Condition Updated"
        }
    ]
    }