Extending an Existing
Object Workspace
To add HTML
extensions to the
Monitor
and
Configure
tabs in
the
vSphere Client
,
use the following generic extension points. These extension points generate a
subordinate view inside that tab.
- vsphere.core.${objectType}.monitorViews
- vsphere.core.${objectType}.manageViews
For example, if you define an
extension that extends the
vsphere.core.vm.manageViews
extension point, your extension appears as an entry in the table of contents
under the
Configure
tab in
the object workspace for virtual machine objects.
For a complete list of object
workspace extension points available for the
vSphere Client
,
see
Object Workspace Extension Points.
Types of Data
Views
A data view extension appears
differently depending on the vSphere object that you specified with the
extension point. Data views can appear in the object workspace having one of
the following structures.
- Table of contents entry - If you define an extension to a top-level tab, such asMonitor, orConfigure, a data view extension appears as an entry in the table of contents on the left in the object workspace.
- Portlet - If you define the portlet extension point, a data view extension appears as a portlet in the object workspace.
Configure and Monitor
Views Extensions
You can extend a vSphere
object view under the
Configure
and
Monitor
tabs by
using the generic extension points
vsphere.core.${objectType}.monitorViews
and
vsphere.core.${objectType}.manageViews
to specify the
generic HTML class that implements the new data view. You must also specify the
URL to the HTML source of the data view.
Adding a Host
Monitor
ViewFollowing is an example of how
you can add an HTML view to the
Monitor
tab of host
objects.
<extension id="com.vmware.samples.vspherewssdk.host.monitor"> <extendedPoint>vsphere.core.host.monitorViews</extendedPoint> <object> <name>#{monitorHtml.label}</name> <contentSpec> <url>/ui/plugin-name/monitor-view.html</url> </contentSpec> </object> </extension>
The value of the
<url>
property is a relative URL that starts
with the Web context path of the plug-in,
/ui/
. You must set the same URL without the first
slash as a value to the
Web-ContextPath
manifest header of the Web application
MANIFEST.MF
file.
To display content from
another domain in the view, you can use HTTPS URLs. Note that the content is
not loaded the first time that the user open the view, unless the domain
certificate is already verified. You must not use HTTP URLs because the
contemporary Web browsers are designed to block any insecure content that you
try to display inside the secure
vSphere Client
domain.
The
monitor-view.html
document view is opened with a REST request that contains the following
parameters:
- objectId- The context object ID of the view.
- objectType- The context object type.
- locale- The current locale of the Web browser.