Installing or saving a hierarchy template

The import template command option lets you install a hierarchy template as a replacement for the template used in Hierarchy Manager. The export template command option lets you save a copy of the hierarchy template used in Hierarchy Manager. Prior to using these commands, you should back up your existing hierarchy configuration (see Saving the entire hierarchy configuration in an XML file).

Installing a hierarchy template

Use the import template option to replace the template currently installed in your system with a different one.

Notice

Loss of Data

The new template overwrites the existing template, which permanently removes all information contained in the original. Export the existing hierarchy template from PME before importing a new template.

Failure to follow these instructions can result in a loss of data.

 

When you import the hierarchy template XML file, the Hierarchy Configuration Utility performs a validation test on the file. If the file validation is not successful, the utility does not import the file and provides information indicating where the validation process stopped. Check for any discrepancies in the file, save the changes and reimport the file.

To import a hierarchy template XML file:

  1. Open a Command Prompt window:

    1. Use Windows Explorer to navigate to:

      ...\Power Monitoring Expert\Applications.

    2. Click the bin folder and press Shift + Right-click and select Open command window here on the context menu.

  1. Type HierarchyConfig.exe import template <file_path>\<file_name>, where <file_path> is the location of the XML file, and <file_name> is the name of the XML file, including .xml as the file extension, to be imported. If you do not specify a file path, the current directory of the Hierarchy Configuration Utility is used.

    For example, HierarchyConfig.exe import template "C:\testfile.xml"

    NOTE: The file name and folder name cannot contain spaces.

    The utility provides feedback for each stage of the import. If the import operation is unsuccessful, the utility provides information about why the import is unsuccessful.

  2. Verify that the template has been successfully imported in Hierarchy Manager.

    Hierarchy Manager should now display the nodes defined in the newly imported template.

Saving a hierarchy template

Use the export template option to save the Hierarchy Manager template currently installed in the system as an XML file. The file defines the node names, attributes, relationships, and views for Hierarchy Manager.

To export a hierarchy template XML file:

  1. Open a Command Prompt window:

    1. Use Windows Explorer to navigate to:

      ...\Power Monitoring Expert\Applications.

    2. Click the bin folder and press Shift + Right-click and select Open command window here on the context menu.

  1. Type HierarchyConfig.exe export template <file path>\<file name>, where <file path> is the location where you want to save the XML file, and <file name> is the name of the XML file, including .xml as the file extension. If you do not specify a file path, the current directory is used.

    NOTE: The XML file name and file path cannot contains any spaces.

  2. Navigate to the location you specified to confirm that the XML file is successfully saved.