<< Click to Display Table of Contents >> Manual > Monitoring system construction guide > Construction of main functions > Logging/trend graph > Construction of trend graph > Tag logging settings (tag field master)

About Tag Field Master

The "Client Configuration Guide" provides a "Client Connection Sample" as an example of connection from FA-Client. This sample has a summary action named "Summary" registered in advance. This action is for logging and aggregation.

 

Summary actions read the settings from various master files when they are executed, and perform logging and aggregation processing according to the settings. One of the master files for summary actions is the "tag field master", which defines which tags are to be logged and aggregated.

 

The tag field master for the above "Summary" action is stored below.

 

(Project folder) \server\summary\fieldmaster_tag.csv

 

The tag field master is a text file in CSV format and can be freely edited using a text editor such as Notepad or Excel.

 

The following steps use the sample file above as an example.

 

 

Editing Tag Field Master

Below we will explain how to edit tag field masters using Excel.

 

 

■ Prerequisites

 

In the configuration example introduced here, the following tags are assumed to be registered in FA-Server instead of actual tags that communicate with PLC. When actually building a monitoring system, please read these tags as tags that communicate with PLC.

 

Units used:

 

Virtual Device (U01)

 

tag:

 

Numeric tags from U01.F01.D0000 to D0004 (5 points)

Bit tags U01.F01.M0000 ~ M0004 (5 points)

 

 

■Work Instructions

 

Please open the tag field master "fieldmaster_tag.csv" in Excel.

 

Then, the following is written:

 

 

The first line of the tag field master is the header. It defines what information is written in which column. From the second line onwards, define which tags are to be logged and aggregated, one line at a time. Each line defined here is called a "field", and the name defined in the Name column becomes the field name.

 

Currently, sample data is registered from the second line onwards. Since we will not be using sample data, please delete all data from the second line onwards.

Then, from the second line onwards, add 10 lines of field definitions for five analog points, U01.F01.D0000 to D0004, and five digital points, U01.F01.M0000 to M0004.

 

Please refer to the following for the settings of each field.

 

 

Once you've finished editing, save it as a CSV file.

 

 

(Reference: Excel editing image)

 

(Reference: Example edited with Notepad)

 

 

 

 

 

 

Operation check

Once you have configured the tag field master, check the operation of the trend graph.

 

1.Bring your application online

 

Run FA-Server online.

 

 

Next, start FA-Client.

 

 

2.Displaying the trend graph screen

 

Once FA-Client is launched, display the trend graph from the menu.

 

 

 

To display the trend graph, you must register the pen.

Currently, no pens have been registered, so nothing is displayed on the graph.

 

 

3.Add a pen

 

Now, let's add a pen to the trend graph. Here, please set up the pen by following the steps below.

 

First, click the settings icon (gear icon) in the upper right corner of the screen to display the menu.

 

 

Select "Pen Settings" from the menu displayed on the right side of the screen.

 

 

This will bring up the pen settings dialog, where you can set the trend pen settings.

 

 

First, add a pen group. To add a group, click the "Add" button to the right of the group name.

 

 

A new group called "Group01" will then be added and displayed in the combo box.

The group name can be edited directly from the combo box, but in this case we will use this name as is.

 

 

Next, click the "Add" button in the upper right corner of the pen list.

 

 

Then, a new line was added to the pen list.

 

You need to specify a data source for the added pen. To specify a data source, click the selection button in the "Data Source" field of the added line.

 

 

This will display the data source selection dialog.

 

When you select "Summary" from the destination action name, the selectable data sources will be displayed in the list.

As an example, select the "Summary.RAW::T000" line at the top of the list and click "OK."

 

 

The data source will then be selected as shown below. For the purposes of this example, leave the maximum, minimum, and other settings at their default values.

 

 

Continue clicking the "Add" button to add two more pens.

Assign "Summary.RAW::T001" and "Summary.RAW::T002" to the data sources of the two pens you added.

 

 

Next, change the pen title to something easier to understand.

 

To edit the title of a pen, double-click the corresponding cell in the pen list. As an example, change the pen titles to "Analog D0000", "Analog D0001", and "Analog D0002".

 

 

When you have finished setting up, click the "OK" button to close the pen settings dialog.

 

The graph is displayed on the trend graph screen.

 

 

 

Currently, the tag values have not changed, so all pens remain stable at zero.

 

 

4.Change the value of a tag

 

Now, let's try changing the tag value from FA-Server. Select the F01 folder in the U01 unit, and make sure that tags D0000 to D0002 are displayed in the multiview.

 

 

In the multiview, try changing the tag values of D0000, D0001, and D0002 to any value between 0 and 1000. To edit a tag value, select the tag and press the "F5" key to display the write dialog.

 

The trend graph is now "updated in real time" - notice that the graph display scrolls automatically from right to left and that the graph value changes automatically when the tag value changes.

 

 

 

5.Displaying historical data on a graph

 

Next, let's try displaying the history of the trend graph.

Click "Real-time updates" from the menu on the right side of the screen.

 

 

 

The check mark to the right of real-time update will disappear and the trend graph will stop scrolling. You can switch between these modes by clicking each time.

 

 

 

When scrolling of a trend graph is stopped, you can scroll the graph display by clicking the arrow buttons at the bottom of the graph.

 

Scroll through the graph to see historical data.

 

 

 

supplementary explanation

■ Log data storage period (Summary Master)

 

The retention period for summary action log data is defined in a configuration file called "Summary Master".

 

In the sample, the summary master is stored in the following location:

 

(Project folder) \server\summary\master.txt

 

The summary master is a text file and can be freely edited with a text editor such as Notepad.

 

 

Below is the Summary Master opened in Notepad.

 

 

 

The data retention period is defined in days as "DaysOfHoldingData" in the [COMMON] section. The default is written as shown below, which sets it to 3660 days. You can change the log data retention period by editing this section.

 

DaysOfHoldingData=3660

 

In addition, various settings other than the data retention period are defined in the Summary Master, and definitions related to the aggregation process (processing such as daily report aggregation based on log data) are also made in this file.

 

 

 

 

■ About Calculated Field Master

 

One of the summary action configuration files is a configuration file called "Calculated Field Master."

 

In the sample, the calculated field master is stored in the following location:

 

(Project folder) \server\summary\fieldmaster_calculation.csv

 

 

A calculated field is a function that allows you to perform calculations between tag fields at the time of aggregation processes such as daily reports using summary actions.

 

Please note that the sample configuration file may contain sample data such as the following:

When building a monitoring system based on a sample,If you do not use calculated fields, please delete the sample data from the second line onwards in the following definition file..

 

(Example of a calculated field master)