Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
  • 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.


Image Modified


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.


Image Modified


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:

                                 

      • 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
  • 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.


Image Modified



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.


Image Modified

When setting a parameter to be a VM Picker, the user must also specify whether if it takes its values from VMWareHyperV or XenServer.

...

If checked, the  file upload will begin after the workflow start .



If the user have multiple fileuploads with the same name, a timestamp as suffix will be added to the filename.

Logged in user


This type of parameter does not require additional settings and it will be set as Hidden by default. In Portal, this kind of parameter will automatically return the username that is currently logged in. If the Hidden checkbox is not checked, the parameter will be visible:

...