Logging changes to Eclipse HX matrix frames

Being able to see which changes Users have made and having the option to revert to a previous Project may be useful tools in certain environments. EHX will note the current user and log some information to the password protected EHXDataStore.sdf which resides in the installation directory.

In order to track user access to a system, we can use Windows to Audit File Accesses on the HXN Project file, but that will not allow for Project restore unless Windows Backup settings are also in place.

A simple way to keep track of changes made to Eclipse HX frames would be to save a log every time an Apply Changes to Matrix is attempted. One way to do this is to use a Logic Macro.

Setting up auto-save

It is good practice, and essential for the correct file to be saved, to Save the Project during every Apply.

In EHX’s top (not left) menu, go to Tools > Settings and check “Save Project on Apply Changes” and press OK.

Importing the Macro

Open the correct EHX Project and go to Configuration > Logic > then find “Import” at the bottom of the page:

Select Clear-Com EHX Access Logging.ccm (attached to this solution) and chose Open.

When the macro has imported, it will show with a checkbox:

Now, whenever a configuration in this Project is sent to the matrix, a backup will be saved with a time stamp, and a Log file will be added to.

Finding the logs

By default, the directory is the current user’s Roaming Profile in AppData, but this can be edited in the macro.

The text logged looks like this:

Attempt to apply changes to matrix 2 at IP 10.50.1.20:
User: Administrator, checked out as Unknown was working with Project 121021 AE Lab (description (if any) ).
The project was last saved at Friday, December 10, 2021 11:23:34 AM and it is now Tuesday, August 16, 2022 7:36:17 PM according to this PC, HME-DT-0283. The EHX Server (if used) is reached at localhost.
The process ID was 3040, which can be used to evaluate whether EHX has been restarted, and EHX was launched this time at Tuesday, August 16, 2022 7:23:59 AM.

In the case above, no active user information was found on the Project file but the logged in user (Administrator) was captured correctly.

Making changes

To edit the macro, go to Configuration > Logic and click Edit Logic on the imported file. A new window will appear, and the two lines shown below are available for editing:

 

In most cases, changing the 12.4 to 12.2 (or similar) is all that is required.

 

CAN'T FIND YOUR ANSWER? CLICK HERE TO CONTACT SUPPORT


This solution was provided to you by Clear-Com via a question submitted to us by customers like you. If your question wasn’t answered, you need help or you have a recommended solution for our database, please send us an email at support@clearcom.com

The information on this page is owned by Clear-Com and constitutes Clear-Com’s confidential and proprietary information, may be used solely for purposes related to the furtherance of Clear-Com’ business and shall not be disclosed, distributed, copied or disseminated without Clear-Com’s prior written consent. Click Here for Clear-Com's privacy statement.