You can insert an event object in an iFIX picture. The event object performs an operation when its event type is triggered. You must enter VB code into the object's event for anything to actually to occur. If you select the Edit Script button, VBE automatically launches and the cursor appears at the event type that you select for the event object. You can then enter code for that event. If you select OK, the event object is created but you will have to go in at a later date and enter the VB code for the event.
Event Source
Allows you to enter the data source to connect the event object to. Click the browse button (...) to view all of data sources available in your system. Click the down button to view the last data sources you used. Click the modify database block button to modify the selected data source. You can add a database block by entering a new database block tag name and tabbing off this field. The Quick Add dialog box appears and allows you to enter the appropriate values for the added block.
Event Properties Tab
The Event Properties tab contains the following items:
|
Item |
Description |
|
Name |
Allows you to specify the name of the event object. |
|
Description |
Allows you to specify an optional description of the event. |
|
Event Type |
Allows you to specify the type for the event object. The valid entry types are:
|
|
Interval |
Specifies the time interval in milliseconds. Only enabled when the Event Type is While True or While False. |
Historical Properties Tab
The Historical Properties tab allows you to set the parameters for a query that fetches historical data from Proficy Historian. The tab contains the following items:
NOTE: The following fields, with the exception of the Update Rate fields, are only available if you select a Historical Mode other than Current Value.
Start Date
|
Item |
Description |
|
Fixed Date |
Specifies whether to enter a specific start date for the query of the data source. |
|
Days Before Now |
Specifies whether to enter the number of days prior to today to fetch data from Proficy Historian. For example, if you want to display data collected for the data source two days ago, enter 2. |
Start Time
|
Item |
Description |
|
Fixed Time |
Specifies whether to designate a specific time to start. If selected, allows you to enter an explicit start time. |
|
Lock Time |
Locks the Fixed Time, even if you change the time zone in the Date and Time Properties dialog box in the Control Panel. This field is available only when you designate a specific time to start using the Fixed Time field. |
|
Duration Before Now |
Specifies whether to enter the duration prior to the current time to start. The minimum duration is 0 seconds; the maximum is 23 hours, 59 minutes, and 59 seconds. |
Time Zone
|
Item |
Description |
|
Time Zone |
Allows you to select the time zone to associate with the start time. You can select the client time (time zone for your computer), the server time (time zone used by the Historian server), or the tag time (uses the time zone bias of the tag, which is set in Historian). The default time zone is that of the client machine. This field is available only when Historian is used. |
|
Adjust for Daylight Savings Time |
Adjusts the time if the zone you selected is experiencing daylight saving. This field works only if you selected the Automatically adjust clock for daylight saving changes check box located on the Time Zone tab of the Date/Time Properties dialog box in the Control Panel. |
Historical Mode
Allows you to determine how iFIX selects and fetches data from a historical data source and, determines what each displayed value represents. The options are:
- Sample – The last valid value found, up to and including the start of the specified interval.
- Avg – The average of all valid data found during the specified interval.
- High – The highest valid data point value found during the specified interval.
- Low – The lowest valid data point value found during the specified interval.
- Interpolated – The data is interpreted by assuming that the line between two values is a straight line. All points along that line are estimated except the starting point and the ending point.
- Current Value – The
current value of the data point.
IMPORTANT: The Current Value may update at a rate different from the rate set in the Update Rate field. The update rate is not set solely by the rate entered in the Update Rate field. It also depends on the collection rate, the rate for querying Historian, and the time required to request an update from the Historian server and send it back to the client. As a result, the time it takes to display the updates may be longer than anticipated. Additionally, please be aware that the timestamp for this mode represents the timestamp from the Historian server, not the client.
- Std Deviation – The standard deviation of all valid data found during the specified interval.
- Total – The total of all valid data found during the specified interval.
Duration
The duration determines the time range for the historical data source. The minimum duration for a fetch is one second; the maximum is 999 days, 23 hours, 59 minutes, and 59 seconds.
|
Item |
Description |
|
Days |
Allows you to enter the number of days. This field can be used in conjunction with the other fields in this area. |
|
Hours |
Allows you to enter the number of hours for the duration for the data fetch query. This field can be used in conjunction with the other fields in this area. |
|
Mins |
Allows you to enter the number of minutes for the duration for the data fetch query. This field can be used in conjunction with the other fields in this area. |
|
Secs |
Allows you to enter the number of seconds for the duration for the data fetch query. This field can be used in conjunction with the other fields in this area. |
Update Rate
Allows you to specify the rate at which the data is updated. The default rate is five seconds. Zero is permitted for a one-time fetch. The fastest update rate is five seconds, the slowest, 1:59:59.
|
Item |
Description |
|
Hours |
Allows you to enter the number of hours for the rate of data update. This field can be used in conjunction with the other fields in this area. |
|
Mins |
Allows you to enter the number of minutes for the rate of data update. This field can be used in conjunction with the other fields in this area. |
|
Secs |
Allows you to enter the number of seconds for the rate of data update. This field can be used in conjunction with the other fields in this area. |
Edit Script
Applies and saves changes you have made, launches VBE to the event type you selected for the event object, and closes the expert.
