Event Mapping

About Event Mapping

Event Mapping enables you to configure the information that is displayed in the Events section in Asset Health Manager, as well as whether event records can be consolidated. For more information about events, see the end user documentation for Asset Health Manager.

Access the Event Mapping Workspace

About This Task

Super Users and members of the MI AHM Administrator Security Group can use the Event Mapping workspace to customize the information that is displayed in the Events section in Asset Health Manager, as well as whether event records can be consolidated. For more information about events, see the end user documentation for Asset Health Manager.

Procedure

In the Applications menu, navigate to ADMIN > Application Settings > Asset Health Manager.
The AHM Admin page appears, displaying the Event Mapping workspace.

The family selected in the Mapped Family box indicates the family that is being mapped as a source event family.

The Allow event consolidation? selection specifies whether or not you want to allow events for this family to be consolidated.

Note: In order for events to be consolidated, the Has Consolidated Events relationship must also be configured for this family.

The Event Fields section contains the following boxes:

  • Event Relationship: Specifies the relationship that links the asset to the source event record.
  • Start Time Field, End Time Field, Name Field, Description Field, and Severity Field: Specifies fields in the source event record whose values are displayed in the Events section of Asset Health Manager.
  • Has Duration Field: Specifies the field in the source event record that indicates whether the event has a duration.
  • Default Severity: Specifies the severity that is associated with the source event record if the value in the specified Severity Field does not contain a specifically defined Mapped Severity Code.
The Event Severities section specifies the severity that is associated with specific values in the specified Severity Field of the source event family. The severity is shown as an icon representing Information, Warning, or Alert in the Events section in Asset Health Manager.

Event Severity

For example, based on the event severity mappings shown in the preceding image, when the Severity field in a Policy Event record contains the value WRN, the Warning icon is displayed in the Events section of Asset Health Manager. If the Severity field in a Policy Event record contains a value other than INF, WRN, or ALT, the default severity will be used (i.e., Information).

Modify Event Mappings

Procedure

  1. Access the Event Mapping workspace.
  2. In the Mapped Family box, select the family whose event mappings you want to modify.
  3. Modify the values as necessary.
  4. If you want to add or delete an event severity, use or respectively.
  5. Select Save.

Results

Events are displayed in the Events section of Asset Health Manager according to the values you specified.

Create a New Event Mapping

About This Task

Super Users and members of the MI AHM Administrator Security Group can use the Event Mapping workspace to customize the information that is displayed in the Events section in Asset Health Manager. For more information about events, see the end user documentation for Asset Health Manager.

Procedure

  1. Access the Event Mapping workspace.
  2. Select Add Mapping.

    Boxes that you can use to specify a new event mapping appear.

  3. In the Mapped Family box, select the family whose event information you want to appear in Asset Health Manager.
    Note: The family that you select must:
    • Have a relationship to a family in the asset hierarchy.
    • Contain a date/time field that can be mapped to the Start Time Field.
  4. In the Allow event consolidation? section, specify whether or not you want to allow events for this family to be consolidated.
    Note: In order for events to be consolidated, the Has Consolidated Events relationship must also be configured for this family. Also, Asset Health Manager users who will perform event consolidation must belong to a Security Group that includes Insert and Update privileges on the family.
  5. In the Event Relationship box, select the relationship family that links the asset to the source event record.
  6. In the following boxes, select the field in the source event record whose values you want to display in the Events section of Asset Health Manager:
    • Start Time Field
    • End Time Field
    • Name Field
    • Description Field
    • Severity Field
    Note: For performance reasons, you cannot map long text fields to these fields.
  7. In the Default Severity box, select the severity that should be associated with the source event record if the value in the specified Severity Field does not contain a specifically defined Mapped Severity Code.
  8. Define event severities for specific values as necessary. To do so:
    1. In Event Severities heading, select .

      Boxes that you can use to specify a severity appear.

    2. In the Select Severity code... box, select the type of severity you want to define.
    3. In the Mapped Severity Code box, enter the value that corresponds to the selected severity.
  9. Select Save.

About the Baseline Event Mappings

The baseline APM database contains Event Mapping records to define event mappings for the following event source families:

  • AMS Asset Alert
  • AMS Asset Event
  • Calibration subfamilies
  • GE Tag Event

  • Inspection family and the following Inspection subfamilies

    • Bundle Inspection
    • Full Inspection
    • General Inspection
    • Pressure Test Inspection

  • Checklists subfamilies

    • API 510 External Checklist
    • API 510 Internal Exchanger
    • API 510 Internal Exchanger Checklist
    • API 570 External Checklist
    • API 653 External Checklist
    • API 653 Internal Checklist
    • External PRD Checklist
  • Policy Event
  • Production Event
  • Work History

The tables in this topic list the baseline event mappings for each of these families.

Note:
  • The tables list the field captions of the mapped fields, some of which may differ from the datasheet captions for these fields.
  • The Default Severity is Information for all baseline event mappings.

AMS Asset Alert

Allow Event Consolidation? section

Yes is selected.

Event Fields section

Box in Event Fields sectionMapped Calibration subfamily field

Event Relationship

Has Tag Alert

Start Time Field

Date/Time

End Time Field

None

Name Field

ID

Description Field

Description

Has Duration FieldNone

Severity Field

Severity

Note:

The following specific severity codes are also defined:

  • Advisory = Warning
  • Abnormal = Warning
  • Failed = Alert
  • Communication Failure = Alert

AMS Asset Event

Allow Event Consolidation? section

Yes is selected.

Event Fields section

Box in Event Fields section

Mapped Calibration subfamily field

Event Relationship

Has Tag Event

Start Time Field

Date/Time

End Time Field

None

Name Field

ID

Description Field

Description

Has Duration FieldNone

Severity Field

Severity

Note:

The following specific severity codes are also defined:

  • Advisory = Warning
  • Abnormal = Warning
  • Failed = Alert
  • Communication Failure = Alert

Calibration Subfamilies

Allow Event Consolidation? section

No is selected.

Event Fields section

Box in Event Fields section

Mapped Calibration subfamily field

Event Relationship

Has Calibration

Start Time Field

Event Start Date

End Time Field

Event End Date

Name Field

None

Description Field

Calibration Type

Has Duration FieldNone

Severity Field

None

GE Tag Event

Allow Event Consolidation? section

Yes is selected.

Event Fields section

Box in Event Fields section

Mapped GE Tag Event field

Event Relationship

Has Tag Event

Start Time Field

Start Time

End Time Field

End Time

Name Field

ID

Description Field

Type
Has Duration FieldNone

Severity Field

Severity Level

Note:

The following specific severity codes are also defined:

  • 1 = Warning
  • 2 = Warning
  • 3 = Alert
  • 4 = Alert

Inspection Family and subfamilies

Allow Event Consolidation? section

No is selected.

Event Fields section

Box in Event Fields section

Mapped Inspection family and subfamilies field

Event Relationship

Has Inspections

Start Time Field

Commencement Date

End Time Field

Completion Date

Name Field

Inspection Reference

Description Field

Inspection Headline

Has Duration FieldNone

Severity Field

None

Checklists Subfamilies

Allow Event Consolidation? section

No is selected.

Event Fields section

Box in Event Fields section

Mapped Checklists subfamilies field

Event Relationship

Has Inspections

Start Time Field

Completion Date

End Time Field

None

Name Field

Inspection Reference

Description Field

Inspection Reference

Has Duration FieldNone

Severity Field

None

Policy Event

Allow Event Consolidation? section

Yes is selected.

Event Fields section

Box in Event Fields section

Mapped Policy Event field

Event Relationship

Has Event

Start Time Field

Start Time

End Time Field

End Time

Name Field

Name

Description Field

Short Description

Has Duration FieldHas Duration

Severity Field

Severity

Note:

The following specific severity codes are also defined:

  • ALT= Alert
  • WRN = Warning
  • INF = Information

Production Event

Allow Event Consolidation? section

No is selected.

Event Fields section

Box in Event Fields section

Mapped Production Event field

Event Relationship

Has Production Event

Start Time Field

Start Date

End Time Field

End Date

Name Field

Event ID

Description Field

Headline

Had Duration FieldNone

Severity Field

None

Work History

Allow Event Consolidation? section

No is selected.

Event Fields section

Box in Event Fields section

Mapped Work History field

Event Relationship

Has Work History

Start Time Field

Event Start Date

End Time Field

Maintenance Completion Date

Name Field

Request Type Description

Description Field

Event Short Description

Has Duration FieldNone

Severity Field

Event Type

Note: The following specific severity code is also defined:

Repair = Alert