- TextBox
- ComboBox
- AD Picker
- VM Picker
- Date Picker
- File Browser
- Logged in user
- PasswordBox
- CheckBox
- VMware Host Picker
- Object Selector
- Slider
- Grid
- System Info
- TimePicker
- Terms Of Use
TextBox
When selecting a TextBox parameter type, a modal dialog is displayed asking the user to further configure the parameter.
Regardless of the datasource selected for configuration, these options are common:
...
- The script code can be tested by clicking the Preview Values button
ComboBox
When selecting a Combobox parameter type, a modal dialog is displayed asking the user to further configure the parameter.
A ComboBox type parameter allows single value selection in Start Workflow form. If the Is ListView option is checked (option available for all elements in the source drop down list), this will enable users to select multiple values in Start Workflow form and in this case the parameter should be defined in Designer as an Array[T] type. For example, if strings will be used, the the argument should be an String[] type.
When checking the Is ListView option, user may also add limitations for minimum/maximum selected items. Only positive numeric values are accepted. If other values are inserted, a validation message will prevent user from saving the configuration. If left empty, no limitation validation will be applied for the parameter.
NOTES:
- when minimum/maximum selected values are used in addition to preselected values, if the number of preselected values exceeds the number of maximum values, Portal validation for minimum/maximum selected items will be applied when Start Workflow windows is opened but no item will be automatically unchecked
- if the parameter is optional, Portal validation for minimum/maximum selected items will NOT be applied
...
To configure a parameter of type ComboBox From Powershell, follow the next steps:
- Select the Parameter type: ComboBox and select the PS option to open the From Powershell window:
- Type in a Powershell script inside the Editor field. Click on
for examples. Each item which contains the ';' separator will be treated like a display value / sent value item pair in Portal, this means that only the display value is visible in Portal, but the sent value pair is sent to the workflow In order to execute the powershell script on a remote machine, a username (domain\user format), a password and a machine name/IP should be inserted. If no credentials or no machine name/IP are provided, the code will be executed locally
- The script code can be tested by clicking the Preview Values button
To configure a parameter of type ComboBox from WMI,follow the next steps:
- Select the Parameter type: ComboBox and select the WMI option to open the From WMI window:
- In order to execute the script on a remote machine, a username (domain\user format), a password and a machine name/IP should be inserted. If no credentials or no machine name/IP are provided, the code will be executed locally
- Type in a WMI Query inside the WMI Query editor field. Click on for examples
- Test the query by pressing the Preview Values button
To configure a parameter of type ComboBox from SSH, follow the next steps:
- Select the Parameter type: ComboBox and select the SSH option to open the From SSH window:
- Insert the credentials for the SSH machine where the script will be executed. The SSH Script code will be executed on the selected Machine, with the given Username and Password. Click on Advanced Settings to set a different connection type:
- SSH connections can also be established by using certificates, with or without passwords:
- Click on Upload Certificate and select a valid certificate. If the certificate is without password, when Passphrase window opens, leave the field empty and click on Set button to return to Advanced Settings window:
- Certificate based connections can also be made by using binary configured Global Variables. Select a global variable/attribute into the Global Variable field. If the certificate is without password, when Passphrase window opens, leave the field empty and click on Set button to return to Advanced Settings window:
- Click on Upload Certificate and select a valid certificate. If the certificate is without password, when Passphrase window opens, leave the field empty and click on Set button to return to Advanced Settings window:
- SSH connections can also be established by using certificates, with or without passwords:
- A connection based on a certificate can be removed by clicking Clear Certificate or the
button if a certificate was selected from the Global Variable structure
- A connection based on a certificate can be removed by clicking Clear Certificate or the
- Separator: the main separator (default:';') is used for separating items from the execution resulted string
- Type an SSH Script code. Click on for examples. Each item which contains the ',' separator will be treated like a display value / sent value item pair in Portal, this means that only the display value is visible in Portal, but the sent value pair is sent to the workflow
- Test the script by pressing the Preview Values button
To configure a parameter of type ComboBox from Javascript, follow the next steps:
- Select the Parameter type: ComboBox and select the Javascript option to open the From Javascript window:
- Separator: the main separator (default:';') is used for separating items from the execution resulted string
- Type in a javascript script inside the Java Script editor field. Click on for examples. Each item which contains the ',' separator will be treated like a display value / sent value item pair in Portal, this means that only the display value is visible in Portal, but the sent value pair is sent to the workflow
- The script code can be tested by clicking the Preview Values button
To configure a parameter of type ComboBox from Python, follow the next steps:
- Select the Parameter type: ComboBox and select the Python option to open the From Python Script window:
- Separator: the main separator (default:';') is used for separating items from the execution resulted string
- Type in a python script inside the Python Script editor field. Click on for examples. Each item which contains the ',' separator will be treated like a display value / sent value item pair in Portal, this means that only the display value is visible in Portal, but the sent value pair is sent to the workflow
- The script code can be tested by clicking the Preview Values button
AD Picker
When selecting a AD Picker parameter type, a modal dialog is displayed asking the user to further configure the parameter.
To configure a parameter of type AD Picker Standard, follow the next steps:
...
- Select an object type. By default, User will be selected
- Type in a Display Value
- Type in a valid Domain Path (LDAP) or copy it from a Standard AD Picker's Location field
- Click Add
- Repeat the previous step for as many AD Locations as desired
- Set one value as Default by selecting the line and checking the Default value column
- Test the results by clicking the Preview Values button
- In order to edit a configured line, select it, then select the Actions drop-down list and click Edit. In order to remove a configured line select it and click Remove
VM Picker
When selecting a VM Picker parameter type, a modal dialog is displayed asking the user to further configure the parameter.
When setting a parameter to be a VM Picker, the user must also specify whether if it takes its values from VMWare, HyperV or XenServer.
...
This parameter type allows the configuration of parameters values in an object selector form, with possibility to single or multiple select the items in Start Workflow form. When configuring a parameter to be of type Object Selector, the user must also specify whether it has static values, or if it takes values from a datasource:
Configuration Options
The configuration options are available regardless of the datasource selected for the object selector:
- Min/Max: limits the user to a specified minimum/ maximum number of items selected. Only positive numeric values are accepted. If the number of items returned is lower than the Min value, the limitation validation will be ignored in Portal. If the parameter is optional, Portal validation for minimum/maximum selected items will not be applied. For this limitation to take effect, Multiple Selection option must be checked also.
- Auto Search: if checked, a search operation will be performed automatically when opening Start Workflow form in Portal without clicking the Search button.
- Allow Duplicates: if checked, it allows the addition of the same item multiple times in the Selected Items area in Start Workflow form in Portal.
- Cross Check: if checked, the preselected values will be populated automatically in the Selected List values (Autosearch flag will be checked automatically when Cross Check flag is checked).
- Multiple Selection: if selected, it forces the type of the parameter to be String[]
- Singe Single Selection: if selected, it forces the type of the parameter to be String and all configuration options will be hidden.
...
- Select the Parameter type: Object Selector and select the Static option to open the Static window:
- Add the desired users in a static text format by writing the value and clicking the Add button
...