Power Monitoring Expert - Reordering, Hiding and Adding Application Buttons/Tabs in Web Applications

Issue
The user wants to reorder, hide or add custom tab in PME 8.x, PME 7.2.x and SPM 7 web applications.

Product line

Struxureware Power Monitoring 7.0(SPM)

Power Monitoring Expert 7.2.x

Power Monitoring Expert 8.x

Enviroment
Notepad++

Resolution

*Warning: Take backups of any files prior to modifying them. Ensure the backups are in a location that will not be overwritten (i.e. the Desktop).

For Power Monitoring Expert 9.0, reference attached document for making modifications to the Web Applications Tabs.

For Power Monitoring Expert 8.x and below, follow steps below:

NOTE:To customize the application buttons in the application framework, you must have read permissions to access the server, and write permissions to edit files.
To open the Framework.xml file:
1. Click Start > Control Panel > Administrative Tools > Internet Information Services (IIS) Manager. You must have administrator permissions to access IIS.
2. In the Internet Information Services (IIS) Manager window, expand [virtual directory where the application is hosted] > Sites > Default Web Site.
3. Right-click Web, and select Explore.
4. In the Explorer window, right-click Framework.xml, and open it with your preferred xml editor or Notepad++. It is recommended to take a backup of the framework.xml file before proceeding.

To reorder the application buttons:

1. The order of <Application /> elements in the Framework.xml file corresponds to the order of the application buttons shown in the framework. Select the <Application /> element you want to move, then cut and paste it where you want it to appear in the list of application buttons.
2. Save the Framework.xml file.

To hide an application button:

1. In the <Application /> element for the button you want to hide, if there are existing comments (text between <!-- and -->), select and delete the comments.
2. Type <!-- at the beginning of the <Application /> element:

<!--<Application id=…

3. Type --> at the end of the <Application /> element:

</Application>-->

4. Save the Framework.xml file.

To add an application button:

1. Copy the <Application /> element for Diagrams, and paste it where you want the new application to appear in the list of application buttons. The first <Application /> element in the Framework.xml file corresponds to the first application button shown in the framework.
2. Leave the web hosting application id attribute (3a0163ba-c26d-4b79-a846-9e62961ddced) as is.
3. Enter a descriptive name attribute for the new application. This name is only used for identifying the application in the Framework.xml file.
4. To allow the same users who have access to the Diagrams application to access the new application, leave the 'requiredPrivilege' attribute as is.
To use the privilege settings of another application (e.g. Dashboards), copy the 'requiredPrivilege' string of the existing application, and paste it as the 'requiredPrivilege' attribute.
5. To use a predefined custom button image, scroll to the bottom of Framework.xml, copy the xaml path for the Cloud, Cloud/App, World, or World/App button image, and paste it as the 'buttonContents' attribute (not applicable to PME 8.1).
To leave the new application button blank, delete the current 'buttonContents' path, and leave the attribute blank.
If you have graphics software that allows you to create an image represented as a xaml path, create a combined xaml path that is consistent with the style of the other application buttons, then copy the path, and paste it as the 'buttonContents' attribute.
6. Enter a label for the description attribute. This description is only for reference in the Framework.xml file, and is not displayed in the UI.
7. Enter a name for the new application button as the displayName attribute. This name displays below the image on the button. Space is limited, so keep the name short.
8. Enter a new URL for the URL Setting element. Only specify a web site that can be displayed within an iframe.
9. Save the Framework.xml file.
10. Log in to the application framework, and click the new application button to open the specified web site.

Example for SPM 7.0.1:

<Applicationid="3a0163ba-c26d-4b79-a846-9e62961ddced"
name="Weather"
requiredPrivilege="Dashboard.AccessApplication"
buttonContents="F1 M 556,750L 474.667,740.667C 474.667,... Z "
description="weather.com"
displayName="Weather"
resourcesClassName="UI.ApplicationFramework.Resx.ApplicationFrameworkResources,
ApplicationFramework, Version=1.0.0.0"
securityLevel="0">
<ApplicationSpecificPanelButtons>
</ApplicationSpecificPanelButtons>
<Libraries>
<LibraryclassName="LibraryPanelItem3" />
</Libraries>
<OptionsButtonControls>
</OptionsButtonControls>
<SetupControls>
<SetupItemSetupControlId="b29ceb39-4cd8-4077-9c7c-4c6287ac5b64" />
<SetupItemSetupControlId="2600efb2-955a-4fef-9895-c8e716325656" />
</SetupControls>
<Settings>
<Settingname="Url">http://www.weather.com</Setting>
</Settings>
</Application>



Example for PME 8.1:

<Application id="3a0163ba-c26d-4b79-a846-9e62961ddced"
name="System Overview"
requiredPrivilege="WebReach.AccessApplication"
buttonContents=""
description="System Overview"
displayName="Overview"
resourcesClassName="UI.ApplicationFramework.Resx.ApplicationFrameworkResources, ApplicationFramework, Version=1.0.0.0"
securityLevel="0">
<ApplicationSpecificPanelButtons>
</ApplicationSpecificPanelButtons>
<Libraries>
<Library className="LibraryPanelItem3" />
</Libraries>
<OptionsButtonControls>
</OptionsButtonControls>
<SetupControls>
<SetupItem SetupControlId="b29ceb39-4cd8-4077-9c7c-4c6287ac5b64" />
<SetupItem SetupControlId="2600efb2-955a-4fef-9895-c8e716325656" />
<SetupItem SetupControlId="63c71c83-3d88-4d2f-a6eb-db9a1b0f3989" />
</SetupControls>
<Settings>
<Setting name="Url">/ion/default.aspx?dgm=x-pml:/diagrams/ud/SystemOverview.dgm</Setting>
</Settings>
</Application>



To delete an application button:
1. Select and delete the <Application /> element from Framework.xml file.
2. Save the Framework.xml file and reload the page.