Tasks and reasons for visualization

In visual energy 4, you can display instantaneous values and statuses live in your browser. When it comes to energy capture, this is particularly useful for plausibility checks. With this feature, the user can always check if the captured amounts are plausible without any laborious on-site interventions.

For this purpose, displaying the values in the energy distribution is crucial. Together with information on the position of the measurement in the distribution, its exact labeling and additional information given, these values provide the responsible technician with a good overview. If, for example, the instantaneous power of a distribution measurement shows greater values than it is possible from the infrastructure (input switch, fuse, cable, etc.), the configuration is likely to be incorrect.

Supply structure

The supply structure of a medium is automatically created from the distributions that were set up, the connections and contained measurements. Use the supply structure to get a better overview and navigate to individual distributions.

If you select a medium in the project view, the distribution structure is displayed:

If you then move the mouse cursor over an element in the supply structure, its color changes. Click on the distribution to open and display it.

Energy distribution

To open the energy distribution view, either select it in the supply structure or directly select it from the project tree.


No. Description Note


Drawing object / meter point selection Only one meter point can be assigned per drawing object. For this purpose, the drawing object has to have the 'Meter point' property.


Selected drawing object  


Toolbar of the selected meter point  


Drawing object description

If it is a connection, the text is formatted as a hyperlink.  Click on the link to display the connected distribution. If the respective distribution plan contains several pages, the page that contains the connection will be shown.


Instantaneous measured value

Instantaneous values are always formatted as hyperlinks to the device view. Live values (data points) are subjected to automatic periodic updates. Any problems occurring are indicated by different colors:

  • Blue  - vaöie OK
  • Orange - timeout, last known value
  • Red - inadequate value, error


Notes / error texts  


Device designation and component texts Can be edited by the user.


Symbol in field I This area can contain symbols, for example for consumers/devices.





No. Area Description Note


Energy distribution Refresh Refreshes the distribution view based on the information from the database.


Energy distribution Print Opens a new window to print the distribution.


Energy distribution Properties Opens the properties area of the distribution.


Energy distribution Meter points list Shows the list of the meter points and sets the filter to the selected distribution.


Energy distribution Show documents Displays the documents.


Drawing object Add Opens the master data area to select an additional drawing object and add it to the distribution. 


Drawing object Delete Deletes the selected drawing object.


Drawing object Properties Opens the properties area of the selected drawing object.


Meter point Data

Opens a drop-down menu:

Charts: Level-time chart, total analysis

Reports: Annual report, status report

Miscellaneous: Documents


Meter point Edit Opens the properties area of the selected meter point.


Meter point Edit OBIS code Edits the OBIS code of the selected meter point.


Meter point Edit date / substitute values Displays the data editor for the selected meter point.


Meter point Request data Opens a window containing the data of the selected meter point.


Data source Meter point data source properties Shows the properties of the selected meter point's data source.


View Show structure Shows the current structure.


View Balancing group Shows the balancing group information of the selected distribution.


Page go to first page  


Page go to previous page  


Page select page  


Page go to next page  


Page go to last page  


Scale Scale  


Error codes in online display

Communication between the display client browser via the operating system, the network, visual energy 4 web server, eBus master all the way to the eBus device and back is a complex process during which highly diverse events that prevent the data display might occur. To identify different causes of errors, the system generates an error code. The error codes are displayed in a defined color (orange or red) and in the format "ERR:nn" or "ERR:nn.mm".

Error-No. Source Description
ERR:01 System.Exception General error while trying to generate the WCF client.
ERR:02 System.Exception Exception when establishing the connection to the WCF client. Error while accessing the function for defining the data points. This error occurs e.g. if the WCF service is not accessible (not installed, no http connection?). Solution: Check the connection, check IIS, check the installation (outdated eBus master?)
ERR:03 System.TimeoutException Exception on timeout. Timeout during connection attempt. Occurs e.g. if the WCF service is accessible but causes a timeout when attempting to connect with the "eBus master communication service". Solution: Check the eBus master service and start it if necessary.
ERR:04 System.Exception Exception when selecting the function for defining the data points.
ERR:04.1 Kbr.VisualEnergy4.EbusMaster.Common.SessionElapsedException Is displayed if the requested session has expired. This error should disappear after a short time as a new session is created automatically.
ERR:04.2 Kbr.VisualEnergy4.EbusMaster.Common.SessionNotFoundException Is displayed if the requested session does not exist. This error should disappear after a short time as a new session is created automatically.
ERR:04.3 System.Net.Sockets.SocketException Is displayed in case of a network error (socket error).
ERR:05 System.ServiceModel.EndpointNotFoundException Is displayed if a remote endpoint cannot be found or reached. The cause for this might be that the remote endpoint was shut down, is not accessible or the remote network is not accessible.
ERR:06 System.ServiceModel.Security.MessageSecurityException Is displayed if there are any problems concerning the safety functions used on a message. This exception may be caused by errors during signature verification, for example. This exception usually occurs when sending application messages (if the security context has been established completely). It might also occur if a security session is established over the original security context.
ERR:06.1 System.ServiceModel.Security.ExpiredSecurityTokenException Is displayed if a CardSpace security token expires.
ERR:06.2 System.ServiceModel.Security.SecurityAccessDeniedException Is displayed if a safety authorization request fails.
ERR:06.3 System.ServiceModel.Security.SecurityNegotiationException Is displayed if an error occurred while the security context for a message was being defined.
ERR:10 no exception The requested data point was not returned after selection. Possible causes: Does the device no longer exist? Does the data point not exist in the device? The namespace of the eBus master WCF service is not compatible with the web.
ERR:11   Communication with the corresponding eBus master failed repeatedly. As these timeouts affect the overall system performance, the eBus master was removed from the communication list.