Archive - What must be done?
Contents
This example shows how to call an archive with two columns (temperatures), create a graph in the menu and send the data as an e-mail.

The following steps are required:

1.Create communication objects

Create the two communication objects actual and setpoint temperature.
Set "Query during starting" in the HS/FS Expert so that the current value is known when the HS/FS is started.
Make sure that the read flag was set with the ETS if KNX objects are involved.

Check whether the temperature sensor automatically sends the two temperatures.
If the KNX device does not send the two temperatures automatically, the HS/FS must query the data.

For this purpose, a telegram generator must be created in the logic: Designation: "Query temp. cyclically".
Input 1: Cycle in seconds: Fixed value 600
Input 2: On/Off: Fixed value 1
Command Output 1: Switch/query
Communication object: Setpoint temp.
Type: Query

A second query command must be executed for the actual temperature:

Command Output 1: Switch/query
Communication object: Actual temp.
Type: Query

2.Create archive

The archive is now created. The archive has 2 columns: Setpoint and actual temperature.
The data should be saved cyclically every 10 minutes (= 600 seconds).
Select the menu item "Archives and Lists\Archives" and create a new archive with the following settings.

2.1.Data

Designation: "Temperature progression"
Ring memory: 4320, corresponds to a recording duration of 30 days, for 6 values per hour, 144 per day.
Cycle (in min.): 10 minutes, the temperatures are archived every 10 minutes.
Dead time (in sec.): 0

2.2.Columns

This is used to create the two columns of the archive. The date and time are automatically present. Select the "Insert" button on the right to create the first column.

Communication object: Setpoint temperature
Column header: Setpoint temperature
XML field: Accept suggestion
Decimal places: 1

Select the "Insert" button on the right again to create the second column.

Communication object: Actual temperature
Column header: Actual temperature
XML field: Accept suggestion
Decimal places: 1

2.3.E-mail

All settings for sending the archive by e-mail are made here.
In this mask you define how many data records of the archive are to be sent.
In this case, the selected set always refers to the last X data records.
This topic is dealt with in detail in the FAQs.
  • Select the "Insert" button on the right to create
Designation: Temperatures of the past 24 hours
Time period: 24 hours
Max. lines: 0
Format: HTML
Subject line: Temperatures of the past 24 hours of home

All other options can keep their default value.
The required data can be recorded by a universal timer (by means of a command), for example.
Note
Please note that the e-mail tab is only available if e-mail transmission was activated beforehand in the project settings.

2.4.HTTP call

In this mask you define how many data records are retrieved via the browser, which format, which sorting and which key is used for calling up the list.

Calling code, e.g. tempv

3.Displaying the data as a graph

To now display both temperatures as a line graph, change to the program item "Interface\Menu".
You now create a graph here.
Note
Please note that a graph has to be hierarchically created under a menu page. If you have not yet created a menu page, please do this first. Otherwise, the creation of a graph page is deactivated.

3.1.Graph tab

Graph
In the window which now opens, create a graph with the following settings:
Archive: Temperature progression
Archive type: Line
Number of segments: 40 This displays the last 40 values in the graph.
Segment size (in min.): 1
Segment format: %H %M
Tab1:
Column: Actual temperature
Type: Average
Key: Actual temperature
Axis: 1st Y axis
Line thickness: Normal

Tab2:
Column: Setpoint temperature
Type: Average
Key: Setpoint temperature
Axis: 1st Y axis
Line thickness: Normal