VMware vRealize Orchestrator Plug-In for vRealize Automation 7.0.1 Release Notes

VMware vRealize Orchestrator Plug-In for vRealize Automation 7.0.1 | 15 March 2016 | Build 3515679

VMware vRealize Orchestrator 7.0.1 | 15 March 2016 | Build 3571217

VMware vRealize Automation 7.0.1 | 15 March 2016 | Build 3622989

Check frequently for additions and updates to these release notes.

Last Document Update: 17 March 2016

What's in the Release Notes

The release notes cover the following topics:

Introduction to VMware vRealize Orchestrator Plug-In for vRealize Automation

The VMware vRealize Orchestrator vRealize Automation plug-in provides access and control over any vRealize Automation system.

The vRealize Orchestrator vRealize Automation plug-in provides the following capabilities:

  • Interact with and manage catalog services, catalog items, advanced services custom resources, service blueprints and resource actions, tenants, approvals and entitlements, work items, and blueprints.
  • Allow organizations to automate operations on the vRealize Automation IaaS model entities.
  • Integrate your existing business logic and models with an arbitrary vRealize Automation server.
  • Add a vRealize Automation as a policy-based, declarative multi-hypervisor, provisioning functionality to an existing top level service catalog portal.
  • Use the vRealize Automation plug-in policies to place a workload when a scale out update is needed based on performance triggered by vRealize Operations.
  • Enable workflow designers to include create, read, update, and delete operations for an arbitrary vRealize Automation model entity in any entity set.
  • Connect dynamically to a vRealize Automation system and provision a virtual machine from a vRealize Automation blueprint.

The VMware vRealize Orchestrator Plug-In for vRealize Automation 7.0.1 release runs on VMware vRealize Orchestrator 7.0.1. For instructions about installing and configuring the plug-in, see Using the vRealize Orchestrator Plug-In for vRealize Automation 7.0.

For information about vRealize Orchestrator, vRealize Orchestrator plug-ins, or vRealize Automation see the following pages:

What's New in vRealize Orchestrator Plug-In for vRealize Automation 7.0.1

This release of the vRealize Orchestrator Plug-In for vRealize Automation introduces the following new functionality:

  • vRealize Orchestrator Plug-In for vRealize Automation 7.0.1 works with vRealize Automation 7.0.1 and vRealize Orchestrator 7.0.1.

Known Issues

Some issues have been discovered and the following information is intended to help you understand behavior that you might encounter in this release:

  • Retrieving approval information by using a script results in missing property '@type' error
    The missing property type error is returned when you use the following script to retrieve approval information:
    var service = vcacHost.createApprovalClient().getApprovalApprovalInfoService();
    var approvalInfo = service.getApprovalInfo( approvalId );


    Workaround: Use the following script to retrieve approval information:
    var approvalClient = vcacHost.createApprovalClient();
    var vars = [ approvalId ]; var approvalInfo = approvalClient.getWithVariables("/info/approvals/{0}", vars);
    var approvalPolicy = new vCACCAFEApprovalDescriptiveReference() ;
    approvalPolicy.setId(approvalInfo.getProperty("policy").getProperty("id"));
    approvalPolicy.setName(approvalInfo.getProperty("policy").getProperty("name"));
    approvalPolicy.setDescription(approvalInfo.getProperty("policy").getProperty("description"));

  • On the Items tab of the vRealize Automation console, the name and description of some vCAC Infrastructure Administration resources do not display correctly
    If you publish a catalog item by using the Advanced Service Designer based on an infrastructure administration workflow that has an output parameter of vCAC:Entity type, when consumers request the catalog item successfully, the name and description of the provisioned items do not display correctly.

  • The requests workflows for waiting do not work correctly when a vCloud Automation Center host is added with Per User Session connection and the vRealize Orchestrator server is restarted during running of the workflows
    The Wait for work item, Wait for resource action request, and Wait for catalog item request workflows result in "Unable to retrieve authentication for this task" instead of "Approved" or "Rejected" if a vRealize Automation host is added with Per User Session connection and the vRealize Orchestrator server is restarted during running of these workflows.

  • vRealize Automation Plug-in API documentation is still in development
    vCAC and VCACCAFE modules of the vRealize Orchestrator API Explorer do not provide complete API documentation.

    Workaround: You can download the latest versions of the API documentation from vRealize Automation Information or access the vRealize Automation API documentation on https://vRealize_automation_appliance_host/component-registry/services/docs.

  • Searching for business groups returns results for all hosts
    When you run workflows for updating or deleting business groups, or adding, updating, or deleting custom properties for a business group from the Workflows view, there is no option to restrict the search function to a particular vRealize Automation host.

    Workaround: Run these workflows from the Inventory view.

    1. Click the Inventory view in the Orchestrator client.
    2. Right-click the business group you want to update.
    3. Select the workflow to run.

  • The workflows provided in the plug-in do not perform the same validation as vRealize Automation UI
    The vRealize Automation user interface performs validation checks, but not all of this logic is accounted for in the workflows provided with the plug-in. For example, vRealize Automation prevents you from creating a tenant with a non-unique URL, but the plug-in workflow does not validate this. Make sure that your custom workflows take care of any validation required by vRealize Automation.

  • The vCACCAFEAuthenticationGroupService.updateCustomGroup method removes all members of the updated group

    Workaround: Before using the vCACCAFEAuthenticationGroupService.updateCustomGroup method, retrieve the group members and reassign them to the group after the update, for example:

    // Create a vCACCAFEAuthenticationGroupService instance to perform operations, where host is the vcac host configured by the vcaccafe plug-in.

    var groupService = host.createAuthenticationClient().getAuthenticationGroupService();

    // Retrieve current members, where groupToBeUpdated is the target custom group

    var membersUsers = groupService.getUsersInGroup(tenant, groupToBeUpdated, criteria, pageable);

    var membersGroups = groupService.getGroupsByCriteriaAndDomainAndParentGroup(tenant, criteria, domain, groupToBeUpdated);

    // Update the group, retrieve the updated group, and reassign the members:

    groupService.updateCustomGroup(tenant, groupToBeUpdated);

    var updatedGroup= groupService.getGroup(tenant, groupToBeUpdated.getPrincipalId().asString());

    groupService.assignGroupsAndUsersToCustomGroup(tenant, updatedGroup, membersGroups, membersUsers);

Top of Page