Spreadsheet Applications

Transcription

1 Metasys Network Technical Manual 3 App. Notes: Network Communications Technical Bulletin Issue Date 9 Spreadsheet Applications lntroduction Page 3 Metasys and Spreadsheet Applications 5 Locating and Opening.DBF Files 5.DBF File Formats.DBF File Examples Conclusion 5 99 Johnson Controls, Inc. Order No

2 App. Notes: Network Communications Spreadsheet Applications

3 lntroduction The Metasys Operator Workstation and N LAN are designed to function in harmony with standard, off-the-shelf PC software. Through the use of Windows drivers and third-party applications, Metasys Network-wide data can be used in reports, charts, and graphs. This document contains the following section: Metasys and Spreadsheets Using any spreadsheet program that can read files formatted in dbase III (.DBF extension), data collected from the Trend, Totalization, and Point History features can be opened as a spreadsheet. The spreadsheet is a snapshot of Metasys data at that moment. You can then use your spreadsheet program to prepare reports, charts, and graphs. Note: The spreadsheet applications described in this document do not require Metalink, a Metasys software package which uses Microsoft Windows Dynamic Data Exchange (DDE). For details on how your application uses.dbf files, refer to the manufacturer s literature. App. Notes: Network Communications Spreadsheet Applications 3

4 4 App. Notes: Network Communications Spreadsheet Applications

5 Metasys and Spreadsheet Applications The Trend, Totalization, and Point History features of Metasys store collected data in.dbf files. Many spreadsheet applications, such as Microsoft Excel, and data base managers, such as Borland International Inc. s dbase III/IV can read these types of files. By using one of these applications, you can import and manipulate the.dbf files for the purpose of creating professional reports, pie charts, bar graphs, and any other data representation that the application provides. This section describes how to find, import, and manipulate these files. Examples are also given. Locating and Opening.DBF Files Metasys stores the.dbf files in a specific location on the Operator Workstation s hard disk. Figure shows the directory path under which the.dbf files are stored. Other directories [FMS]* [DATA]** Other directories Other directories PTHISTRY [SYSTEM NAME] [OBJ.DBF] [OBJ.DBF] [OBJ3.DBF] [NETWORKn] * For BEA, [PROJECT #] ** For BEA, [CONTRACT #] [PC File Destination Name] TOTAL [SYSTEM NAME] [OBJECT NAME] [ATTR#.DBF] [ATTR#.DBF] [ATTR#.DBF] TREND [SYSTEM NAME] [OBJECT NAME] [ATTR#.DBF] [ATTR#.DBF] [ATTR#.DBF] NETMAP Figure : Location of.dbf Files App. Notes: Network Communications Spreadsheet Applications 5

6 Follow these steps to open a.dbf file:. Start your spreadsheet application.. Change the default extension specified in the file name field to *.DBF (if necessary). 3. Use the mouse to penetrate the directories until you reach the desired.dbf file. (Refer to Figure for the directory structure.) An example is 8.DBF. ( 8 is the attribute number.) 4. Load the file..dbf File Formats Since the type of data collected by the Totalization, Trend, and Point History features differs, the format of their.dbf files also differs. The following sections explain these formats. (The examples used are from Pioneer Software System s Q+E for Microsoft Excel.) Totalization.DBF File Example Totalization Type Long Value (Integer) Floating Value Totalization Duration Date: Year Date: Month Date: Day Scheduling Day Time: Hour Time: Minute Date Index Time Index TOTTYPE VALFLOAT VALLONG DURATION DATE_Y DATE_M DATE_D DATEDAY TIME_H TIME_M DATE_NDX TIME_NDX FIELD DESCRIPTIONS TOTTYPE = : Analog, :Event, 3:Pulse, 4:Runtime VALFLOAT = VALLONG = DURATION = Length of actual totalization (minutes) DATE_Y = Year data was sampled (e.g., 9 is 99) DATE_M = Month data was sampled (:January, :December) DATE_D = Day data was sampled (-3) DATEDAY = Scheduling day data was sampled (-7:Regular Sun.to Sat., 8-: Alternate Sun. to Sat.,5=Holiday) TIME_H = Hour data was sampled (-3 where is Midnight) TIME_M = Minute data was sampled (-) DATE_NDX = Date index used by OWS software TIME_NDX = Time index used by OWS software TOTAL Figure : Example of a Totalization.DBF File App. Notes: Network Communications Spreadsheet Applications

7 Trend.DBF File Example Attribute Type Date: Month Scheduling Day Time: Minute Date: Year Date: Day Time: Hour Valid Reliable Integer Value Real Value Boolean Value ATT_TYPE DATE_Y DATE_M DATE_D DATEDAY TIME_H TIME_M VALID RELIABLE VALINT VALREAL VALBOOL Time Index Date Index DATE_NDX TIME_NDX FIELD DESCRIPTIONS ATT_TYPE = :Integer, :Real, 3:Boolean (binary) DATE_Y = Year data was sampled (e.g., 9 is 99) DATE_M = Month data was sampled (:January, :December) DATE_D = Day data was sampled (-3) DATEDAY = Scheduling day data was sampled (-7:Regular Sun. to Sat., 8-:Alternate Sun. to Sat.,5:Holiday) TIME_H = Hour data was sampled (-3 where is Midnight) TIME_M = Minute data was sampled (-) VALID = :Data valid, :Data invalid RELIABLE = :Object reliable, :Object unreliable VALINT = VALREAL = VALBOOL = :True/On, :False/Off DATE_NDX = Date index used by OWS software TIME_NDX = Time index used by OWS software TREND Figure 3: Example of a Trend.DBF File App. Notes: Network Communications Spreadsheet Applications 7

8 Point History.DBF File Example Sample Type Floating Point Sample Word AOS Sample Word BI Sample Word BO Sample Word Floating Point Value AOD/AOS Command Date: Year Date: Day Feature ID Date: Month SMPLTYPE FPSMPLWD AOSMPLWD BISMPLWD BOSMPLWD FPVALUE AOUTCMMD FTR_ID DATE_Y DATE_M DATE_D Scheduling Day Time: Minute Time Index Time: Hour Date Index DATEDAY TIME_H TIME_M DATE_NDX TIME_NDX FIELD DESCRIPTIONS SMPLTYPE = :Analog In, :Analog Out, 3:Binary In, 4:Binary Out FPSMPLWD = Refer to Table AOSMPLWD = Refer to Table BISMPLWD = Refer to Table 3 BOSMPLWD = Refer to Table (continued below) FPVALUE = to AOUTCMMD = Analog Output command value FTR_ID = :Invalid,:Operator,:Scheduling,3:JC-BASIC,4:Demand Limit, 5:Duty Cycle,:Initial,7:Local Control,8:H/W Object Mgr, 9:Point History,:Summary,:S/W Object Mgr,:Trend, 3:Totalization,:Assoc. Object,5:Gateway,:Gateway Manual 7:Locally Controlled,8:None DATE_Y = Year data was sampled (e.g., 9 is 99) DATE_M = Month data was sampled (:January, :December) DATE_D = Day data was sampled (-3) DATEDAY = Scheduling day data was sampled (-7:Regular Sun. to Sat., 8-: Alternate Sun. to Sat.,5=Holiday) TIME_H = Hour data was sampled (-3 where is Midnight) TIME_M = Minute data was sampled (-) DATE_NDX = Date index used by OWS software TIME_NDX = Time index used by OWS software PTHIST Figure 4: Example of a Point History. DBF File 8 App. Notes: Network Communications Spreadsheet Applications

9 Tables Table : Values for FPSMPLWD (Floating Point Sample Word) FPSMPLWD (AI, ACM, and AD) Bits -3 Current Status = Normal 3 = Low Warning 4 = Low Alarm 5 = High Warning = High Alarm Bit 4 Offline = True = False Bit 5 Reliable = True = False Bit Software Override = True = False Bit 7 Object Disable = True Bits 8- Unused N/A = False Table : Values for AOSMPLWD (Analog Output Sample Word) AOSMPLWD (AOD and AOS) Bit Offline = True = False Bit Hardware Override (HOA) = True = False Bit 3 Software Override = True = False Bit 4 Object Disable = True Bits 5- Unused N/A = False App. Notes: Network Communications Spreadsheet Applications 9

10 Table 3: Values for BISMPLWD (Binary Input Sample Word) BISMPLWD (BD and BI) Bits -3 Current Status = Normal = Trouble = Alarm Bits 4-5 Current State = Off = On/State = State 3 = State 3 Bit Offline = True = False Bit 7 Reliable = True = False Bit 8 Override = True = False Bit 9 Disable = True Bits - Unused N/A = False App. Notes: Network Communications Spreadsheet Applications

11 Table 4: Values for BOSMPLWD (Binary Output Sample Word) BOSMPLWD (BO) Bits -3 Current Status = Normal = Trouble = Alarm Bits 4-8 Current Command = Off = On/State = State 3 = State 3 Bit 9 Offline = Offline = Online Bit Hardware Override = True = False Bit Software Override = True = False Bit Object Disable = True = False Bits 3- Commanded Priority = Not used (highest) = Fire start/stop 3 = Manual override 4 = Process start/stop 5 = Demand Limiting shed/restore = Load Rolling shed/restore 7 = Scheduling start/stop 8 = Operator start/stop 9 = Local control Closing a.dbf File When you are done editing and printing the.dbf file, remember to save it to a different file (refer to the caution on next page) and close it. App. Notes: Network Communications Spreadsheet Applications

12 .DBF File Examples You may manipulate the data in the fields of a.dbf file in any manner that the application allows. For example, you can delete those columns that contain irrelevant data and widen those columns that have important data. In that manner, you can create a well-formatted report for presentation or filing purposes. If your application allows it, you may also create a line or bar graph from data in the chart.! CAUTION: Do not edit an original.dbf file created by Metasys, because the network may try to write to this file while you have it opened. Instead, make a copy of the.dbf file, retaining the.dbf extension. Then, edit the copied file. The following are examples that show you how the original.dbf files can be manipulated. Line and bar graph examples are given. Totalization The example in Figure 5 shows the total daily runtime in minutes for a supply fan. The recording begins on February, 99 and ends on February, 99. VALUE DURATION Spreadsheet YEAR MONTH DAY HOUR MINUTE Line Graph DURATION DAY E-TOTAL Figure 5: Totalization Spreadsheet Example App. Notes: Network Communications Spreadsheet Applications

13 Trend In Figure, the example trends outdoor air temperature as it changes during the late hours of the day. The sampling begins at 3 p.m. and ends at midnight. One sample is taken each hour. Spreadsheet YEAR MONTH DAY HOUR MINUTE VALUE (DEGF) VALUE (DEGF) 7. Line Graph HOUR E-TREND Figure : Trend Spreadsheet Example Point History The Point History example shown in Figure 7 is for an analog data point that fluctuates from hour to hour. The sampling ends at midnight. Spreadsheet FPVALUE Bar Graph FPVALUE YEAR MONTH DAY HOUR MINUTE HOUR E-PTHIST Figure 7: Point History Spreadsheet Example App. Notes: Network Communications Spreadsheet Applications 3

14 App. Notes: Network Communications Spreadsheet Applications

15 Conclusion This document explained how the.dbf files that Metasys creates can be used to prepare reports, charts, and graphs. The value of any object that can use the Trend, Totalization, or Point History features can be used with spreadsheet applications. If you require more information on these Metasys features, refer to their respective technical documentation under the Feature Software section of this manual. App. Notes: Network Communications Spreadsheet Applications 5

16 Notes Controls Group FAN 3 57 E. Michigan Street Metasys Network Technical Manual P.O. Box 43 Revision 4 Milwaukee, WI 53 Printed in U.S.A. App. Notes: Network Communications Spreadsheet Applications