Skip to main content

Action: AddLibrary

Function: The action adds a library reference to a specific Library Manager. If the function cannot be inserted into the Library Manager, then the action fails.

Call: Library test driver

Tab: Configuration

The first three input fields Library or placeholder, Version, and Company determine the library that is entered in the Library Manager.

Library or placeholder

Name of the library or placeholder

  • Library name (for absolute or asterisk referencing)

    Example: Default

  • Placeholder name (with prepended #)

    As a result, the Version and Company settings are blank.

    Requirement: The libraries are also referenced by means of placeholders in the Library Manager.

    Example: #Default

_cds_icon_three_dots.png: Opens the Find Library dialog

Version

Version of the library

  • Absolute version information

    Requirement: The library is also referenced absolutely in the Library Manager.

    Example: 4.0.0.0

  • *

    Asterisk referencing to always reference the newest version

    Requirement: The library is also referenced in the Library Manager by means of an asterisk.

  • Blank (already determined by placeholders)

_tm_icon_choose_library.png: Opens the dialog for selecting the library

Company

Company (vendor) of the library

Default Resolution

Resolution for a placeholder library

_cds_icon_three_dots.png: Opens the library repository and selects the default resolution

Library Manager path

Path of the Library Manager to be modified in the project

Example: Device.Plc Logic.Application.LibraryManager

tm_storefullobjectname.png: Copies the settings of an object, which is selected in the 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).

Repository

If specified, then only this library repository is used when searching for the library. If not specified, then the default search order applies to all repositories.

Publish all IEC symbols

standard icon: The flag is set in the Library Manager for the respective library.

Hide reference in dependency tree

Namespace

Namespace for the library

If a value is not specified, then the default namespace of the library is used.

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