Dollar-parameter

The dollar-parameter allows a simple variable to be replaced with a corresponding data point element, which is why it is necessary to work with dollar-parameters in order to use panels flexibly. Corresponding dollar-parameters can be created in a dedicated user interface in the ScriptWizard, and with the help of the ScriptWizard they can be named correctly.

It is possible to pass dollar-parameter to other panels. Therefore, after adding a dollar-parameter in the ScriptWizard it must be used in the panel. Dollar-parameter that are added in the ScriptWizard but are not used afterwards can't be passed to other panels. See also Open Childpanel.

Stucture

The dollar-parameter overview sheet shows the general information of all the defined dollar-parameters. In this sheet you can add a new dollar-parameter, redefine an existing dollar-parameter and delete a defined dollar-parameter.

Figure 1. Overview - Dollar-parameter

dollar-parameter

The name of a dollar-parameter consists of the following two parts:

  1. The prefix. The prefix indicates the data type of a parameter. It is automatically generated, so as to keep a correct syntax.

  2. The name of a parameter. It is given by the user.

Description

Description is an additional information of the existing dollar-parameters. Double click on the description field next to the dollar-parameter to enter a text. Currently ScriptWizard supports several different languages.

Add dollar-parameter

Click on the push button "add dollar-parameter" so you can create and define a new dollar-parameter in the "DefineDollorParameter" dialog box. The new dollar-parameter is then shown in the dollar-parameter sheet. For more information please refer to: Add dollar-parameter.

Delete dollar-parameter

Select the dollar-parameter you want to delete by clicking on it, then click on the push button "delete dollar-parameter".

Add dollar-parameter

To add a new dollar-parameter into the ScriptWizard, a dollar-parameter must be named and a corresponding data type must be selected. See the dialog box in the following figure "Add a new dollar-parameter".

Figure 2. Add a new dollar-parameter

Variable name

You can name a dollar-parameter as you wish, The given name must be unique for the same selected data type.

Data Type

The data type shows the type of a dollar-parameter. In the drop-down list you may find all the available data types, which can be selected for a data point element.

Description

A description can be added for the dollar parameter.

Generated Name

The generated name is generated automatically. It shows both the variable name the user has given and the data type the user has selected.

Help

Click on the push button "Help" to open the WinCC OA Online Help for additional informations of the ScriptWizard.

OK

Click on the push button "OK" and the typed-in informations are accepted and the new dollar-parameter can be found in the dollar-parameter list.

Cancel

Click on the push button "Cancel" and the new dollar-parameter is discarded and the dialog box is closed.