Creating custom dialog windows

Customizing Viewpoint > Creating custom dialog windows

3.6 Creating custom dialog windows

To create a custom dialog window

Open the XML file corresponding with the management page in which you want to create the dialog window. These files are located in the Viewpoint home directory. For example, to add the dialog window to Nodes Management, open the nodes.xml file.
Set the required frame-url attribute to the URL of the page to be shown in the popup window.
Insert any desired field references of the current object, preceded by $, that will be replaced by the field's value. See the option's Management Table fields for a complete list of options (Modifying columns in the Node Management table, etc.).

<controls>
    <open-dialog frame-url="customizations/vms/reprovision.gsp;vmId=$id"></open-dialog>
</controls>

The $id variable in the URL will be replaced by the actual VM name.

Insert the required <header> element to define the text displayed in the dialog window's header.
1. Insert any desired field references to the current object, preceded by $, that will be replaced by the field's value. See the option's management table fields for a complete list of options.
2. Set the image attribute within <open-dialog> to place a custom image to the left of the header's text. Set the value to the image's location from the $CATALINA_HOME directory.
For example:
```
<header image="images/reprovisions.png">Reprovision VM $id</header>
```
Set the <requirement> child element and specify a condition to disable the dialog window for certain records.

The condition can be any Boolean decider value (for details, see Setting a Boolean decider) and all keywords corresponding to applicable fields for the record.

In this example, a VM must run Linux to access the dialog window:

<open-dialog frame-url="customizations/vms/reprovision.gsp;vmId=$id">
   …     
    <requirement comparison="equals">
        <first>
            <component id="variable[vm_os]" />
        </first>
        <second>linux</second>
    </requirement>
</open-dialog>

Customize dialog window’s button using the tooltip, image-url, and label optional attributes in the <open-dialog> element.
1. Set the tooltip attribute to the explanatory text that will be displayed by the button on mouse-over.
2. Set the image-url attribute to the path of the icon that will be used to display the button.
3. Set the label to the display text of the button.

For example:

<open-dialog frame-url="customizations/vms/reprovision.gsp;vmId=$id" tooltip="Reprovision this VM" image-url="images/button.png" label="Reprovision">