Set the Extension Product Information

You provide product information about an extension by setting properties when you instantiate the Extension object in the program that manages the extension. The product information that you set appears in the vSphere Client.

You can instantiate the Extension data object in the MyManager.java class. Your solution can set the Extension product information properties directly in MyManager.java, but you can set the property values in configuration files that the program that manages the extension accesses.

Prerequisites

Download the vSphere ESX Agent Manager SDK.

Procedure

  1. Provide a description for the extension by creating an instance of the Description data object and passing it to Extension.
      private Extension createExtensionObject() {
        Extension extension = new Extension();
        [...]
        Description description = new Description();
        description.setLabel("My Solution");
        description.setSummary("This extension represents my solution.");
        extension.setDescription(description);
        [...]
      }
  2. Provide a version number for the extension by calling the Extension.setVersion() method.
    private Extension createExtensionObject() {
        Extension extension = new Extension();
        [...]
        extension.setVersion("0.1");
        [...]
      }
  3. (Optional) Change the value of the version property in MyManager.java.
  4. Provide information about the vendor of the extension by calling the Extension.setCompany() method.
    You can set the vendor property by adding the following line of code to MyManager.java.
    private Extension createExtensionObject() {
        Extension extension = new Extension();
        [...]
        extension.setVersion("0.1");
        extension.setCompany("My Company");
        [...]
      }
  5. Provide URLs to Web pages for the product and for the vendor of the extension by creating an instance of the ExtExtendedProductInfo data object and passing it to Extension.
    You can set the companyUrl property for ExtExtendedProductInfo by calling the ExtExtendedProductInfo.setCompanyUrl() method in MyManager.java:
    private Extension createExtensionObject() {
        Extension extension = new Extension();
        [...]
        ExtExtendedProductInfo extExtendedProductInfo = new
        ExtExtendedProductInfo();
        extExtendedProductInfo.setCompanyUrl("www.mycompany.com");
        extExtendedProductInfo.setProductUrl("www.mycompany.com/myproduct");
        extension.setExtendedProductInfo(extExtendedProductInfo);
        [...]
      }
  6. Save, build and deploy your solution.
  7. (Optional) View your changes in the vSphere Client.
    If you edit the values of the version, company, companyUrl, and productUrl properties, your changes appear in the Summary tab of your solution.

Results

You provided product information about an extension by setting properties in the Extension and ExtExtendedProductInfo data objects.

What to do next

Set the extension name and localization information.