Editing Application Parameters

Some Applications require or support configuration parameters at startup that must be configured. For example, a browser application supports a page or startup page parameter so that when the browser is launched it opens to the configured page.

With an Application window selected, the App Parameters (General) Property is available. Use this property to enter/edit parameters for specific application types, via the Edit Parameter List dialog.

FIG. 333 Edit Parameter List dialog

Adding Stock Parameters

Stock parameters are application parameters that are pre-defined for a given application window. Available stock parameters vary depending on the type of application window selected.

NOTE: Many application windows do not have any stock parameters, in which case the Available Parameters window is empty.

Unused stock parameters for the selected application window are listed in the Available Parameters window of the Edit Parameter List dialog (FIG. 334):

FIG. 334 Edit Parameter List dialog (for a Browser Application Window)

For example, the Browser application window uses two available stock parameters: URI and RestartApp.

    • The URI parameter is indicated in the Parameters list, as shown in FIG. 334. Since this is not a required parameter, it can be removed from the Parameter list (via the Delete Parameter button), in which case it is moved to the Available Parameters list as an unused available parameter. It can be added to the Parameters list via the Add Stock Parameter button.
    • The Restart App parameter cannot be removed, because it is a required parameter (see Yes in the Req column).

NOTE: Stock parameters are pre-defined and cannot be deleted, renamed, or type-changed - only the value is editable. User defined parameters will appear under any default definitions, and are displayed in the order in which they are defined.

Adding User-Def ined Parameters

User-Def ined application parameters can be added and configured via the Add User-Def ined Parameter option in the Edit Parameter List dialog:

  1. Click the Browse (...) button in the App Parameters property (General tab of the Properties window) to open the Edit Parameter List dialog.
  2. Click Add User-Def ined Parameter to add a new parameter to the parameter list.
  3. Use the fields in the parameter list to edit the parameters as desired. For example, the Restart App parameter supports an editable boolean value - select either true or false from the Value drop-down (FIG. 335):

FIG. 335 Edit Parameter List dialog - user-defined parameter

    • Name: Indicates the name of each parameter
    • Type: Indicates the parameter type (Boolean, Integer, or String)
    • Value: Enter or select the desired value based on the parameter type/function.
    • Req: Indicated whether each parameter is required by the application. Note that user-defined parameters are not required.

  • Click OK to save changes and close this dialog. Notes:

    • User definitions must fully match the name, value type and value expected by the application - otherwise they will be ignored.
    • User-defined parameter names must be unique within the parameter list.
    • To delete a user-defined parameter, select the parameter and then click Delete.
    • Drag-and-Drop as well as Copy/Paste functionality is supported for the entire parameter list, but only functions between Applications of the same type (i.e. Browser apps).

NOTE: See the

Working with Browser Application Windows section on page 230

for details on working the Browser application window type to set a Default URL, and switching between desktop and mobile content.

Deleting Parameters

In the Edit Parameter List dialog, select any optional parameter from the parameter list, and click Delete Parameter.

    • Parameters that are required (as indicted in the Req column of the parameter list) cannot be deleted.
    • When stock parameters are deleted, they are re-added to the Available Parameters list.

results matching ""

    No results matching ""