Report: Basics
The Create report function is a manual or automated process. Create event log must be active for Eplan License Manager to make data available for a report. The Create event log function creates the log file
Prerequisite - License version:
| Function | Eplan License Manager (up to version 2024) | Eplan License Manager (as of version 2025) | Eplan License Manager Professional |
|---|---|---|---|
| Reports | - | - | x |
User interface
- Tab Properties
- Create report dialog
- Output format file: The "Output format file" is used to specify how the report is to be output.
- Period: Here you specify the period for which the license events are to be listed.
Output format file
An "output format file" is used to specify how the report is to be output. The output format file is a configurable XML file. You must create it yourself.
Enter the following information in this file:
- Contents of the list
- Selected output type (list or short version)
- File into which the result is written
- Separator used (tabulator or semicolon)
Period
In this group box you specify the period for which the license events are to be listed.
Note the specified time zone. The Eplan License Manager always uses the UTC time zone irrespective of its installation site and its set computer time. You have to select the Computer time option in order to set the time zone in which you work. In as far as the "UTC" time zone is not set on your computer, the UTC time is converted and the report created with your computer time.
The specified time zone also influences the time data in the result file. If you have selected the For the last days / hours option, the start time of the functionality is also used as the finish time specification.
The specifications for the periood are evaluated down to the minute from the start to the finish time. The correct specification for one day is therefore "from 00:00:00 up to and including 23:59:59".
Example
On your German computer system the time zone for Western Europe including Daylight Saving Time will be set as (UTC+2). The Create report functionality is started at 21.05.2015 02:00:00. The last three days are set as the period and the Computer time option as the time zone. As a result the license events from 18.05.2015 00:00:00 up to and including 20.05.2015 23:59:59 are listed. All time specifications in the result file are listed in Western European Time.
Example
Listings for the day of 21.06.2015:
- From: 21.06.2015 00:00:00
- Up to and including: 21.06.2015 23:59:59
Incorrect listing for the day of 21.06.2015:
- From: 21.06.2015 00:00:00
- Up to and including: 22.06.2015 00:00:00
With these specifications, the data of 22.06.2015 are also listed for the period from 00:00:00 up to and including 00:00:59 in addition to the license events of 21.06.2015.
Output types
The Create report functionality outputs the logged license events either as a list or as a summary. In the process the result is always output line-by-line and unsorted. Whether the data are output per time, per license bundle or per license extension in a line depends on the configuration of the output format file.
Example: Result of Create report
As list:
In the example a license user called SKE used the license "Eplan Electric P8-Professional" and the license "Release Eplan Electric P8 2.5" on 21.06.2015 from 10:00:01 to 11:13:20.
| Date | User | Action | License |
|---|---|---|---|
| 21.06.2015 10:00:01 | SKE | IN | Eplan Electric P8-Professional |
| 21.06.2015 10:00:01 | SKE | IN | Release: Eplan Electric P8 2.5 |
| 21.06.2015 11:13:20 | SKE | OUT | Eplan Electric P8-Professional |
| 21.06.2015 11:13:20 | SKE | OUT | Release: Eplan Electric P8 2.5 |
| 21.06.2015 10:02:23 | NTB | IN | Eplan Fluid |
| 21.06.2015 10:02:23 | NTB | IN | Release: Eplan Fluid 2.5 |
In summary:
In the example the license "Eplan Electric P8-Professional" was used once on 21.06.2015 at 10:00:01 ("in use"). At this moment a further three licenses for Eplan Electric P8-Professional were still available.
| Date | License | Total used | Total free |
|---|---|---|---|
| 21.06.2015 10:00:01 | Eplan Electric P8-Professional | 1 | 3 |
| 21.06.2015 10:02:23 | Eplan Fluid | 2 | 1 |
| 21.06.2015 10:00:01 | Release: Eplan Electric P8 2.5 | 1 | 3 |
| 21.06.2015 10:02:23 | Release: Eplan Fluid 2.5 | 2 | 1 |
The summary is structured as follows on the basis of the bundle properties:
- Summary of available license bundles (Bundle ID greater than 0)
- Summary of the standard bundle (Bundle ID=0, actually: licenses that are not combined into bundles).
Basics (up to Version 2025)
User interface (up to Version 2025)
- Tab Properties
- Create report dialog
- Output format file: The "Output format file" is used to specify how the report is to be output.
- Period: Here you specify the period for which the license events are to be listed.
- Read directly from the event log files
Output format file (up to Version 2025)
An "output format file" is used to specify how the report is to be output. The output format file is a configurable XML file. You must create it yourself.
Enter the following information in this file:
- Contents of the list
- Selected output type (list or short version)
- File into which the result is written
- Separator used (tabulator or semicolon)
Period (up to Version 2025)
In this group box you specify the period for which the license events are to be listed.
Note the specified time zone. The Eplan License Manager always uses the UTC time zone irrespective of its installation site and its set computer time. You have to select the Computer time option in order to set the time zone in which you work. In as far as the "UTC" time zone is not set on your computer, the UTC time is converted and the report created with your computer time.
The specified time zone also influences the time data in the result file. If you have selected the For the last days / hours option, the start time of the functionality is also used as the finish time specification.
The specifications for the periood are evaluated down to the minute from the start to the finish time. The correct specification for one day is therefore "from 00:00:00 up to and including 23:59:59".
Example
On your German computer system the time zone for Western Europe including Daylight Saving Time will be set as (UTC+2). The Create report functionality is started at 21.05.2015 02:00:00. The last three days are set as the period and the Computer time option as the time zone. As a result the license events from 18.05.2015 00:00:00 up to and including 20.05.2015 23:59:59 are listed. All time specifications in the result file are listed in Western European Time.
Example
Listings for the day of 21.06.2015:
- From: 21.06.2015 00:00:00
- Up to and including: 21.06.2015 23:59:59
Incorrect listing for the day of 21.06.2015:
- From: 21.06.2015 00:00:00
- Up to and including: 22.06.2015 00:00:00
With these specifications, the data of 22.06.2015 are also listed for the period from 00:00:00 up to and including 00:00:59 in addition to the license events of 21.06.2015.
Reading directly from the event log files (up to Version 2025)
The Create report functionality can also interpret the contents of the "
If the check box is not activated, the Create report functionality receives the required data from the License Manager.
The setting Read directly from the event log files helps to ease the burden on the Eplan License Manager. In such a case the reports are created from the log files that do not have the current date.
Note
Even when the Read directly from the event log files setting is activated, the functionality establishes a connection to the Eplan License Manager in order to obtain some system-specific data from the current Eplan License Manager.
Output types (up to Version 2025)
The Create report functionality outputs the logged license events either as a list or as a summary. In the process the result is always output line-by-line and unsorted. Whether the data are output per time, per license bundle or per license extension in a line depends on the configuration of the output format file.
Example: Result of Create report
As list:
In the example a license user called SKE used the license "Eplan Electric P8-Professional" and the license "Release Eplan Electric P8 2.5" on 21.06.2015 from 10:00:01 to 11:13:20.
| Date | User | Action | License |
|---|---|---|---|
| 21.06.2015 10:00:01 | SKE | IN | Eplan Electric P8-Professional |
| 21.06.2015 10:00:01 | SKE | IN | Release: Eplan Electric P8 2.5 |
| 21.06.2015 11:13:20 | SKE | OUT | Eplan Electric P8-Professional |
| 21.06.2015 11:13:20 | SKE | OUT | Release: Eplan Electric P8 2.5 |
| 21.06.2015 10:02:23 | NTB | IN | Eplan Fluid |
| 21.06.2015 10:02:23 | NTB | IN | Release: Eplan Fluid 2.5 |
In summary:
In the example the license "Eplan Electric P8-Professional" was used once on 21.06.2015 at 10:00:01 ("in use"). At this moment a further three licenses for Eplan Electric P8-Professional were still available.
| Date | License | Total used | Total free |
|---|---|---|---|
| 21.06.2015 10:00:01 | Eplan Electric P8-Professional | 1 | 3 |
| 21.06.2015 10:02:23 | Eplan Fluid | 2 | 1 |
| 21.06.2015 10:00:01 | Release: Eplan Electric P8 2.5 | 1 | 3 |
| 21.06.2015 10:02:23 | Release: Eplan Fluid 2.5 | 2 | 1 |
The summary is structured as follows on the basis of the bundle properties:
- Summary of available license bundles (Bundle ID greater than 0)
- Summary of the standard bundle (Bundle ID=0, actually: licenses that are not combined into bundles).
Read more
- Configurator: Basics
- Creating a report
- Command line parameters
- Attributes in the output format file
- Attribute: <logfile />
- Attribute: <header />, <value />, <format />
- Element: <head /> (header data)
- Element: <summary /> (summary of the license bundles)
- Element: <defaultbundle_summary /> (summary of the standard bundle)
- Element: <list /> (list of license events)
- Macros
- Important error numbers