When you customize the request form, you can provide elements where the user can select from search results from a list or browse a tree to locate a matching value.

The value picker and the tree picker work with the Reference Type that is defined on the custom form Appearance tab. The Reference type is a vRealize Orchestrator resource. For example, AD:UserGroup or VC:Datastore. By defining the reference type, when the user enters a search string, the results or tree options are limited to or the resources that have the matching parameter.

For the value picker, you can then further limit the possible values by configuring an external source. For the tree picker, you can provide a default value by configuring an external source.

Working with the Value Picker

The value picker appears in the catalog form as a search option. The user enters a string and the picker provides options based on how you configured it. You can use the picker based on the following use cases. The most valuable use of the value picker is pairing it with an external source value.

  • Value picker with a constant value source. Use this method when you want to the requesting user to select from a predefined static list of values. Similar to the combobox, drop down, multiselect, and radio group elements, this method provides search results in a list based on the defined constant values and labels.
  • Value picker with no defined value source. Use this method when you want the requesting user to search the vRealize Orchestrator inventory for a specific object with the configured reference type. For example, the reference type is VC:Datastore and you want the users to select the datastore from the retrieved list.
  • Value picker with an external value source. Use this method when you want the requesting user to select from results that are based on a vRealize Orchestrator action. For a value picker external source the action must return an properties array, not a sting array. For example, you have an action that retrieves two or more values from an integrated database and you want the users to select a value from the retrieved list. The action must include the filter var filter = System.getContext().getParameter("__filter"); and must return a properties array, not a string array. If you want a string array, use the combo box field type.

Working with the Tree Picker

The tree picker appears in the catalog form as a search option. The user enters a string and the tree picker appears. The tree allows the users to select values that match the reference type. For example, if the reference type is VC:Datastore, the requesting user can select datastore objects. If the reference type is VC:VirtualMachine, the user can select virtual machines.

  • Tree picker with no defined value source. Use this method when you want the requesting user to browse the hierarchical tree for a specific object with the configured reference type. For example, the reference type is VC:Datastore and you want the users to select a datastore from the retrieved tree.
  • Tree picker with an external value source. Use this method when you want to provide a default selection in the tree. The requesting user can select the preset value or browse for a different value. For example, for reference type VC:Datastore, you want to preset the datastore in the tree to a particular datastore based on the results of the action input value that specifies a network.