You are on page 1of 6

8/10/2016 60765 

­ FactoryTalk Alarm and Event (CPR9 and later) Log Database Schema (Format)

(/app/answers/detail/a_id/60765#)

FactoryTalk Alarm and Event (CPR9 and later) Log Database Schema (Format)
Support Center (/app/home) Menu 
60765 | Date Created: 04/22/2009 | Last Updated: 03/30/2015
 Email this page   Unknown message slot SUBSCRIBE_TO_UPDATES3
Access Level: TechConnect

Question
What is the database schema for the FactoryTalk Alarm and Events (CPR9 and later) historical log?

Answer
The Information below can be found by using any of the following 4 methods:

1) Click  Start ­> Programs ­> Rockwell Software ­> FactoryTalk Tools ­> FactoryTalk Help. Then in the HELP file, click FactoryTalk Alarm and Events ­> setup alarm history
logging ­> setup alarm history logging (again) ­> About the database views ­> Database schema.

2) In FactoryTalk View Studio in the application explorer tree,  click System ­ > Connections. Then right­click Databases and select New Database... Then click Help.
Search for 'database schema'.

3) Open the file  C:\Program Files\Common Files\Rockwell\Help\FactoryTalk ActivationseEN.chm.  Search for 'database schema'.

4) Open the file  C:\Program Files\Common Files\Rockwell\Help\FactoryTalk ActivationsEHistorianEN.chm.  Search for 'database schema'.

NOTE: There have been no changes in the database schema since CPR9. The information below applies to the CPR9 release and later.

===================================================================

Database schema
The database schema defines the tables and views for the database. Based on the FactoryTalk alarm and event type (simple, condition, or tracking), new rows are added
to the appropriate database tables. From those database tables, the associated default views of the alarm and event data are updated. See the following table for more
information on each event type and database view.

With this event type The following database view is updated

Simple SimpleEvent
(mk:@MSITStore:D:/Program%20Files/Common%20Files/Rockwell/Help/FactoryTalk
ActivationsEHistorianEN.chm::/SimpleEvent_database_table.htm)

Condition­related ConditionEvent
(mk:@MSITStore:D:/Program%20Files/Common%20Files/Rockwell/Help/FactoryTalk
ActivationsEHistorianEN.chm::/ConditionEvent_database_table.htm)

Tracking­related TrackingEvent
(mk:@MSITStore:D:/Program%20Files/Common%20Files/Rockwell/Help/FactoryTalk
ActivationsEHistorianEN.chm::/TrackingEvent_database_table.htm)

Below is the format of the database view(s) created :

SimpleEvent database view
Tip: This view is not used in FactoryTalk Alarms and Events v2.10.00 (CPR9) and is included now for future use. This view will not be populated with alarm and event data.

This view displays all of the fields and properties common to a simple event.

Name Data type Description Example


https://rockwellautomation.custhelp.com/app/answers/detail/a_id/60765 1/6
8/10/2016 60765 ­ FactoryTalk Alarm and Event (CPR9 and later) Log Database Schema (Format)
Name Data type Description Example

EventID feetID Unique identifier associated with the record. B281E097­5B7E­4167­A24B­C33BBE412C35

SourceName NVARCHAR The name of the object (up to 200 characters) that generated MixingTank1 System


the event . For a simple event such as a system error, the
Source value might be "System".

SourcePath NVARCHAR The FactoryTalk Directory path (ADS path ­ up to 512 RNA://$Global/ApplicationName/Area1/Line1


characters) to the Alarm and Event server where the alarm
occurred.

SourceID1 feetID Link to object such as equipment or location entry. B281E097­5B7E­4167­A24B­C33BBE412C35

ServerName Nvarchar The name of the alarm server (up to 50 characters). RSLinx Enterprise

TicksTimestamp Bigint Time the event occurred, represented in FileTime format (a 632623763288730000


64­bit value consisting of the number of 100­nanosecond
intervals since January 1, 1601 UTC).

EventTimestamp Datetime Time the event occurred in Greenwich Mean Time (GMT). 10/10/2004 12:00:01 PM

EventCategory NVARCHAR The category to which the event belongs (up to 50 characters). Device Failure, Batch Status, System Message


Categories are server­defined and can vary depending on the
event type.

Severity Integer The urgency of the event. This may be a value in the range of 700


1 ­ 1000.

Priority Enum The priority of the event (Enumeration: 1=Low, 2=Medium, 4


4=High, 8=Urgent).

Message NVARCHAR Message text that describes the event (up to 512 characters). Batch 1396 complete

Tip: Messages will be logged in the language specified on the
Alarm Server Properties dialog box.

1 This field is not used in FactoryTalk Alarms and Events v2.10.00 (CPR9) and is included now for future use. The value will be null.

TrackingEvent database view
This view displays all of the fields specific to a tracking event.

Name Data type Description Example

EventID feetID Unique identifier associated with the record. B281E097­5B7E­4167­A24B­C33BBE412C35

SourceName NVARCHAR The name of the object (up to 200 characters) that generated MixingTank1 System


the event. For condition events, the Source value is generally
the alarm name.

SourcePath NVARCHAR The FactoryTalk Directory path (ADS path ­ up to 512 RNA://$Global/ApplicationName/Area1/Line1


characters) to the Alarm and Event server where the alarm
occurred.

SourceID1 feetID Link to object such as equipment or location entry. B281E097­5B7E­4167­A24B­C33BBE412C35

ServerName NVARCHAR The name of the alarm server (up to 50 characters). RSLinx Enterprise

TicksTimestamp Bigint Time the event occurred, represented in FileTime format (a 632623763288730000


64­bit value consisting of the number of 100­nanosecond
https://rockwellautomation.custhelp.com/app/answers/detail/a_id/60765 2/6
8/10/2016 60765 ­ FactoryTalk Alarm and Event (CPR9 and later) Log Database Schema (Format)
64­bit value consisting of the number of 100­nanosecond
intervals since January 1, 1601 UTC).

EventTimestamp Datetime Time the event occurred in Greenwich Mean Time (GMT). 10/10/2004 12:00:01 PM

EventCategory NVARCHAR The category to which the event belongs (up to 50 characters). Operator Action: Operator Process Change,


Categories are server defined and can vary depending on the System Configuration
event type.

Severity Integer The urgency of the event. This may be a value in the range of 700


1 ­ 1000.

Priority Enum The priority of the event (Enumeration: 1=Low, 2=Medium, 4


4=High, 8=Urgent).

Message NVARCHAR Message text that describes the event (up to 512 characters). Acknowledged alarm [System_Second] in alarm


server [RNA://$Global/FactoryTalk
ActivationsCb78/Line1:TagAE]

PersonID NVARCHAR An identifier (up to 50 characters) of the component or user Dave Butler


that initiated the action resulting in the tracking event.

UserComment NVARCHAR Comment text (up to 512 characters). Inspection OK

ComputerID NVARCHAR Computer identifier where the action resulting in the tracking MIXERSTATION


event was initiated (up to 64 characters).

1 This field is not used in FactoryTalk Alarms and Events v2.10.00 (CPR9) and is included now for future use. The value will be null.

ConditionEvent database view
This view displays all of the fields and properties common to a condition­related (alarm) event.

Name Data type Description Example

EventID feetID Unique identifier associated with the record. B281E097­5B7E­4167­A24B­


C33BBE412C35

SourceName NVARCHAR The name of the object (up to 200 characters) that generated the event. For MixingTank1 System


condition events, the Source value is generally the alarm name.

SourcePath NVARCHAR The FactoryTalk Directory path (ADS path ­ up to 512 characters) to the Alarm and RNA://$Global/ApplicationName/Area1/Line1


Event server where the alarm occurred.

SourceID1 feetID Link to object such as equipment or location entry. B281E097­5B7E­4167­A24B­


C33BBE412C35

ServerName Nvarchar The name of the alarm server (up to 50 characters). RSLinx Enterprise

TicksTimestamp Bigint Time the event occurred, represented in FileTime format (a 64­bit value consisting of 632623763288730000


the number of 100­nanosecond intervals since January 1, 1601 UTC).

EventTimestamp Datetime Time the event occurred in Greenwich Mean Time (GMT). 10/10/2004 12:00:01 PM

EventCategory NVARCHAR The category to which the event belongs (up to 50 characters). Categories are Condition: Level, Deviation, Rate of Change,


server defined and can vary depending on the event type. Discrete

Severity Integer The urgency of the event. This may be a value in the range of 1 ­ 1000. 700

Priority Enum The priority of the event (Enumeration: 1=Low, 2=Medium, 4=High, 8=Urgent). 4

https://rockwellautomation.custhelp.com/app/answers/detail/a_id/60765 3/6
8/10/2016 60765 ­ FactoryTalk Alarm and Event (CPR9 and later) Log Database Schema (Format)

Message NVARCHAR Message text that describes the event (up to 512 characters). MixingTank1 full

ConditionName NVARCHAR The name of the associated alarm condition (up to 50 characters). LOLO, LO, HI, HIHI, DEV_LO, DEV_HI,


TRIP, TRIP_L, ROC_NEG & ROC_POS

SubConditionName2 NVARCHAR The name of the sub­condition associated with the alarm condition (up to 50 LOLO, LO, HI, HIHI, DEV_LO, DEV_HI,


characters). TRIP, TRIP_L, ROC_NEG & ROC_POS

AlarmClass NVARCHAR The class name associated with the alarm (up to 40 characters). feet=Failed To Open, feet=Failed To Close

Active Bit A value indicating whether or not the alarm is active. True=1, False=0

Acked Bit A value indicating whether or not the alarm has been acknowledged. True=1, False=0

EffDisabled Bit A value indicating whether or not the alarm is effectively disabled. This is the True=1, False=0


combined effect of the alarm source disable state and the disable states of the areas
containing the alarm.

Tip: You cannot disable areas in FactoryTalk Alarms and Events v2.10.00 (CPR9).

Disabled Bit A value indicating whether or not the alarm source is disabled. True=1, False=0

EffSuppressed Bit A value indicating whether or not the alarm is effectively suppressed. This is the True=1, False=0


combined effect of the alarm source suppress state and the suppress states of the
areas containing the alarm.

Tip: You cannot suppress areas in FactoryTalk Alarms and Events v2.10.00 (CPR9)

Suppressed Bit A value indicating whether or not the alarm source is suppressed. True=1, False=0

PersonID1 VARCHAR An identifier (up to 50 characters) of the component or user that initiated the action Dave Butler


resulting in the condition changing state (e.g., acknowledge, disable, suppress).

ChangeMask Integer A value that indicates the properties that have changed in this event (e.g., an alarm 00000011


could change from normal acknowledged to active unacknowledged).

For more information on the specific bit values, see Change Mask Values
(mk:@MSITStore:D:/Program%20Files/Common%20Files/Rockwell/Help/FactoryTalk
ActivationsEHistorianEN.chm::/Change_Mask_Values.htm). ***

InputValue Real The value of the alarm source. 83

LimitValue Real The limit value that was compared with the alarm source value that triggered the 80


alarm.

Quality Integer Indicates the quality of a tag or device upon which the condition is based. Good, Uncertain, Bad

For additional supported values that are not addressed by the OPC DA specification,
see Extended Quality Values
(mk:@MSITStore:D:/Program%20Files/Common%20Files/Rockwell/Help/FactoryTalk
ActivationsEHistorianEN.chm::/Extended_Quality_Values.htm).

For more information on the meaning of the standard OPC quality values, see the
OPC DA specification on the OPC Foundation (https://www.opcfoundation.org/)
website.

EventAssociationId feetID The EventId associated with the current event. This field allows you to query for all of B281E097­5B7E­4167­A24B­


the events related to a given instance of an alarm and compute associated C33BBE412C35
information (for example, the length of time that an item was active or active and
https://rockwellautomation.custhelp.com/app/answers/detail/a_id/60765 4/6
8/10/2016 60765 ­ FactoryTalk Alarm and Event (CPR9 and later) Log Database Schema (Format)
information (for example, the length of time that an item was active or active and
unacknowledged).

As a given alarm instance changes state, this ID value will remain constant. For
example, when an alarm becomes active, it will be assigned an ID value; when the
alarm is acknowledged or returns to normal, that same ID value continues to be
logged. Additionally, the same ID will be used for multiple conditions of a level alarm
(for example, the HI and HIHI alarms will use the same ID value since the level alarm
does not return to normal when going from the HI to HIHI states).

UserComment NVARCHAR Comment text (up to 512 characters). Inspection OK

UserComputerID1 NVARCHAR Computer name (up to 64 characters). MIXERSTATION

Tag1Value NVARCHAR Value of associated tag 1 (up to 128 characters) 10

Tag2Value NVARCHAR Value of associated tag 2 (up to 128 characters) 10

Tag3Value NVARCHAR Value of associated tag 3 (up to 128 characters) 10

Tag4Value NVARCHAR Value of associated tag 4 (up to 128 characters) 10

1 This field is not used in FactoryTalk Alarms and Events v2.10.00 (CPR9) and is included now for future use. The value will be null. 
2 This field is not used in FactoryTalk Alarms and Events v2.10.00 (CPR9) and is included now for future use. The value will match ConditionName.

*** To get to what the  ChangeMask  column values in the  ConditionEvent  database represent, in the HELP file, click FactoryTalk Alarm and Events –> setup alarm history logging –


>setup alarm history logging (again) –> About the database views –> ConditionEvent database view. Then click Change Mask Values. This takes you to the screen where it explains what
the values for the ChangeMask Values represent.

AllEvents database view
Combines all of the fields from the following into a single view:

· SimpleEvent (mk:@MSITStore:D:/Program%20Files/Common%20Files/Rockwell/Help/FactoryTalk ActivationsEHistorianEN.chm::/SimpleEvent_database_table.htm)

· TrackingEvent (mk:@MSITStore:D:/Program%20Files/Common%20Files/Rockwell/Help/FactoryTalk
ActivationsEHistorianEN.chm::/TrackingEvent_database_table.htm)

· ConditionEvent (mk:@MSITStore:D:/Program%20Files/Common%20Files/Rockwell/Help/FactoryTalk
ActivationsEHistorianEN.chm::/ConditionEvent_database_table.htm)

Tip: The computer identification fields are different in the TrackingEvent (UserComputerID) and ConditionEvent (ComputerID) database views. When these database
views are combined with the SimpleEvent database view to form the AllEvents database view, the ComputerID field is used to represent both UserComputerID and
ComputerID.

DISCLAIMER
This knowledge base web site is intended to provide general technical information on a particular subject or subjects and is not an exhaustive treatment of such subjects.
Accordingly, the information in this web site is not intended to constitute application, design, software or other professional engineering advice or services. Before making
any decision or taking any action, which might affect your equipment, you should consult a qualified professional advisor.

ROCKWELL AUTOMATION DOES NOT WARRANT THE COMPLETENESS, TIMELINESS OR ACCURACY OF ANY OF THE DATA CONTAINED IN THIS WEB SITE AND
MAY MAKE CHANGES THERETO AT ANY TIME IN ITS SOLE DISCRETION WITHOUT NOTICE. FURTHER, ALL INFORMATION CONVEYED HEREBY IS PROVIDED TO
USERS "AS IS." IN NO EVENT SHALL ROCKWELL BE LIABLE FOR ANY DAMAGES OF ANY KIND INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL,
LOSS PROFIT OR DAMAGE, EVEN IF ROCKWELL AUTOMATION HAVE BEEN ADVISED ON THE POSSIBILITY OF SUCH DAMAGES.

ROCKWELL AUTOMATION DISCLAIMS ALL WARRANTIES WHETHER EXPRESSED OR IMPLIED IN RESPECT OF THE INFORMATION (INCLUDING SOFTWARE)
PROVIDED HEREBY, INCLUDING THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, AND NON­INFRINGEMENT. Note
that certain jurisdictions do not countenance the exclusion of implied warranties; thus, this disclaimer may not apply to you.

https://rockwellautomation.custhelp.com/app/answers/detail/a_id/60765 5/6
8/10/2016 60765 ­ FactoryTalk Alarm and Event (CPR9 and later) Log Database Schema (Format)

This page is best viewed in Internet Explorer 10, Firefox 31, Chrome 37, Safari 6 or newer.

New Site Feedback


Give Feedback

      
(http://www.rockwellautomation.com/global/blog/overview.page)
(https://www.facebook.com/ROKAutomation)
(https://plus.google.com/+RockwellautomationInc)
(https://www.linkedin.com/company/rockwell­
(http://www.slideshare.net/RockwellAutomation)
(http://twitter.com/ROKAutomation)
(http://www.youtube.com/rokautomation)
automation)


Top (/app/answers/detail/a_id/60765#top)

https://rockwellautomation.custhelp.com/app/answers/detail/a_id/60765 6/6

You might also like