How do I version custom forms in Automation Service Broker

The Automation Service Broker custom forms maintain a version history record for custom forms that you create for VMware Aria Automation templates. You can create snapshots of your custom forms, compare different form versions, and revert to a previous version.

To view what versions are available for your custom forms, locate your imported template at Content and Policies > Content, and click the arrow button to the left of the template name to expand the details view.

Versioning a custom form

When editing a custom form for the first time, you notice that the Version button is dimmed at first. To version the custom form you are editing, you must create the form or save your changes first. Then, you click Version and provide a name. When you are done editing the form, save your changes again.

When you version custom forms, the system validates your changes and prevents you from creating a new version that is identical to the previous version.

Comparing form versions

When you have multiple versions for a custom form, you can inspect the differences between them.

From the custom form editor, click Version History.

On the versioning timeline on the left, select a version and click Diff. From the Compare to dropdown select another version. You can view the comparison between the two versions side-by-side or inline.

Use the View tab on the Version History page to preview the custom form versions.

Restoring an earlier version

When you develop a custom form, you might have to restore an earlier working version of your form.

From the versioning timeline on the Version History page, select your desired version and click Restore.

The snapshot you selected is applied to the current custom form.

Cloning a custom form

You can create a custom form that is based on another existing custom form or custom form version.

1. On the Content page, locate the template for which you want to create a new form version.
2. Click New Form From in the action menu to the left of the version name.
3. Select the catalog item whose form you want to copy.

   If the item has multiple custom form versions, you can select which version to copy.

4. Click Create.

Using legacy form versions

For some of your imported content, you might have legacy custom forms available. Legacy forms are used by all released versions.

When working with legacy form versions, you have the following options.

• If you want to modify the legacy version, customize the form and set it to Enabled.
• If you don't want to use the legacy version but you still want to keep it, customize the form and set it to Disabled.
• Delete the custom request form to remove all its versions. Then, you can create a new form for your catalog item.

What to do next

For more information about versioning custom forms, see this article.