Populating Arguments


In the previous step, we created a variable called Url that will be a placeholder for the address of the Google search home page. Now that this variable is defined, we need to update our Navigate to URL activity call to use this variable instead of the hard-coded data.

Select Activity Call Steps

  1. Select the Navigate to URL activity in the Activities List.
  2. Make sure the Arguments tab is selected since this is where the Url input argument is defined.

We will now discuss different techniques for using your variable instead of the hard-coded value.

Selecting from Value Menu

The easiest way to use a variable for an argument is to select it from the drop-down menu.

Select Variable from List

  1. Click the drop-down arrow corresponding to the Url input argument. This will present a list of options for how to populate the argument.
  2. Under the Suggested Process Variables list, click the entry for the {Url} process variable we created.
  3. (Alternative to #2) If the variable is not listed as a suggested value, you simply expand the Process Variables menu and select it there. This menu option will always be available and is how you could select a System or Session variable.

Suggested Values

In the screen shot above, the Suggested Values part of the menu is displaying process variables, but this will not always be the case. For arguments that have a defined list of expected values (like true and false entries), the Suggested Values part of the menu will display those pre-defined values instead. The alternative method outlined by #3 above will always be available for selecting Session, System, and Process variables.

After select the variable from the menu, the value of the Url input argument should now be replaced by {Url}.

Expression Syntax

The { and } characters must be used with your variable name. This is a special Expression Syntax which is used to indicate that the value you entered is a placeholder for a variable and should not be literally intepretted as text. In other words, the value {Url} will be interpretted as https://www.google.com when the Navigate to URL activity call is processed. Had the { and } characters been omitted and you typed just Url instead, the Navigate to URL activity would attempt to navigate to the literal text Url, which is not a valid address. To reinforce this syntax, you will always see variables displayed with the { and } characters throughout the application.

Typing with Auto-Complete

Some users prefer to type, so we also support an auto-complete list if you prefer not to select your entries from a menu. We will now clear the {Url} value you previously entered and illustrate how you could have used the auto-complete list instead.

Select Variable from Auto-Complete

  1. Clear the current value of the Url input argument. Since you know the name of the variable you need, typed the three letters u r l. As you type each character, an auto-complete list is displayed below for every value that matches what you have typed so far.
  2. When all three characters are typed, you will see the entry for {Url} along with any other values that contain the typed text url. Press the Down cursor key to select the entry for {Url}, then press the Enter key to commit your selection.

Auto-Complete Entries

The auto-complete list will contain every available System, Session, and Process variable as well as any suggested values for the current argument (e.g. true and false where appropriate). Typing in the auto-complete list can often be faster than selecting a value from a menu. Typing a partial match (e.g. name) can even help you quickly drill down to the desired selection.

Save your Process before continuing since you have modified arguments.