Structure

Work events within Senseye are composed of the following required attributes:

• Timestamp: the date, time and time zone that the work took place
• Message: A free text description of the work undertaken
• Asset ID: Either the Senseye or External ID of the asset the work was performed on
• Is Routine: Whether the event was routine or non-routine
• Work Activity: The type of work undertaken

In addition to these required attributes, the following optional attribute can be provided:

• Failure Mode: Identifies the failure encountered on the asset

Each will be described in more detail in the following sections.

Timestamp¶

The eventTime attribute should identify when the work was completed. This allows Senseye to learn how the failure evolved to the point of intervention and implies that any changes in data may be related to the recent work on the asset.

Ideally the date and time provided should be as close to the work being completed as possible. If an accurate timestamp is not available, the application prefers timestamps which are known to be after the work being completed, rather than before.

The timestamp should include date, time and time zone, see the timestamp documentation for more information on the required format.

Message¶

The message is a free text description which explains the work. It is shown within the application and often used as contextual information when exploring cases and root causes.

Asset ID¶

The asset which the work was performed on can be identified by either its Senseye ID or an External ID. Typically the External ID used in this case would be the ID of the asset within your maintenance system - you can read more about configuring and using External IDs here.

Is Routine¶

This boolean attribute identifies whether the work was planned or not. It is used in reporting to allow insight to be gained from your maintenance records.

Work Activity¶

Work activity explains what work was undertaken. The values are codified within Senseye, they rarely change and are common across all assets. The current list is:

When interacting with the API, the ID of the work activity should be used.

{
    assetByExternalID(id: "external-id-for-asset") {
        workActivities {
            id
            name
        }
    }
}

If you wish to use the Senseye asset ID, rather than an External ID, replace assetByExternalID with asset.

Failure Mode¶

Failure mode explains what went wrong. It is not required, but by providing this Senseye can learn more about your assets and their failures, resulting in better diagnostics and prognostics. The values are codified within Senseye, they change infrequently and are common across all assets. The current list is:

{
    assetByExternalID(id: "external-id-for-asset") {
        failureModes {
            id
            name
        }
    }
}