Skip to main content

Action: UpdateOnlineDeviceParameter

Function: The action resets an online device parameter.

Call: Devices test driver

Tab: Configuration

Table 47. Parameter source (device or explicit connector)

Path

Device or explicit connector to be written

tm_storefullobjectname.png: Copies the settings of an object, which is selected in the POUs tree or device tree, to the input field

_cds_icon_arrow_down.png: Opens a list box with suitable objects which are configured in the open project

Hint: You can also drag the settings of a selected object to the input field (Drag&Drop).

Select parameter

Requirement: In Path, a valid device is selected in the current project, and the Parameter type is Host parameter.

The button opens a selection dialog that displays all available device and host parameters in a tree, as in the generic device editor. Here a parameter can be selected and applied to the form.

Parameter type

Device parameter or Host parameter



Table 48. Host parameter connector

Requirement: The Parameter type is Host parameter.

Defines the connector

Name

Requirement: A valid device is selected in Path.

List with the names of all connectors of the device

The selection synchronizes with the ID field in both directions. If the user manually selects an invalid ID, then the selection in the list box is set to zero.

ID

The ID is coupled with the name.



Table 49. Parameters

Requirement: A valid device is configured, and a valid connector is specified in Host parameter.

Name

List with the names of all parameters of the device

The selection synchronizes with the ID field in both directions. If the user manually selects an invalid ID, then the selection in the list box is set to zero.

ID

The ID is coupled with the name.



Table 50. Parameter subcomponent

Requirement: A valid parameter is selected that actually has subcomponents; or Path, Name, or ID are set to an unknown value.

Name

List with the names of all subcomponents of the device

The selection synchronizes with the ID field in both directions. If the user manually selects an invalid ID, then the selection in the list box is set to zero.

ID

The ID is coupled with the name.



Table 51. Update Parameter

Value

The parameter value to be set



Tab: Parameters

The parameters defined on the Parameters tab are used to exchange values between test script variables and parameters of test actions. Parameters can be used as placeholders on the Configuration tab. For this, the name of the parameter is set in braces in the configuration dialog. Example: {name}.

Tip

Variables defined globally in the script (with the prefix $GLOBALS.) can be used directly in the test action. It is not necessary to use input parameters for passing. Using output parameters is necessary for writing global variables.

Input parameters: When executing the test action, the values of the test script variables are passed to the input parameters of the test action and can be used in the configuration of the test action.

Output parameters: When executing the test action, the values of the output parameters of the test action are passed to the test script variables and can be used (for example, in other test actions).

Name

Name of the input/output parameter

This name is defined in addition to the variable name to identify the origin of the parameter when it is passed to another script. During the test run, this name is displayed as the Outer name on the Variables (scope #<n>) tab in the Test progress window.

Background: When a script A calls another script B, and its variable x passes y as a parameter to the script B, then the parameter y is the variable y from the point of view of script B.

To see that this variable is recognized as variable x "outside" of script B, there is the Name column ("Outer name"). The variable y has the name x in the scope pf script B because it has been passed as variable x to the parameter y in the scope of the calling script A.

Variable

Name of the test script variable

Example: TS_CaseA_Result

Move Up

Moves the selected variable one line up

Move Down

Moves the selected variable one line down

Remove

Removes the selected variable from the list