Library Manager Editor

Overview

Double-click a Library Manager node in the Tools tree to open the Library Manager in an editor view.

The Library Manager editor view consists of four parts:

  • The upper part, displaying libraries included in the project.

  • The lower left part, displaying particular modules of the library selected in the upper part.

  • The lower right part, displaying further information on the module selected in the lower left part in different tabs.

  • A toolbar with buttons and commands.

Description of the Upper Part

The upper part of the view provides a list of the libraries included in the project. If a library depends on other libraries (referenced libraries), these referenced libraries are automatically integrated.

The following information is provided:

Parameter / Symbol

Description

Name

The library names in the list consist of the following elements:

<placeholder name> = <library name>, <version> (<company>)

<placeholder name>: If the entry of the list is a placeholder library for a linked library, then the placeholder name is inserted at the beginning of the line, separated by an = (equals sign) character.

<library name>: Name of the library that is used in the Library Repository.

<version>: The version of the library when it was referenced for the first time.

<company>: The vendor of the library (optional).

Namespace

The default setting for the namespace of a library is <library name>. An exception is made by libraries that have another namespace in their Project Information. Use the library namespace as a prefix of the identifier separated by a . (dot) character:

<namespace>.<library module identifier>

NOTE: If the library has the property LanguageModelAttribute > qualified-access-only , you must access the library module in the application code by using the namespace. Qualified (unique) access is required.

You can modify the standard namespace for local use (within the project) in the Properties dialog box.

Effective Version

Version of the library after the resolution. This version is used in the project.

The Effective Version is displayed for placeholder libraries if the Library Manager has been opened from the Devices tree.

Example: 3.5.10.0

NOTE: For placeholder libraries, the effective version is determined by the search order listed in Placeholder Mechanism.
NOTE: For FCL libraries, the effective version is determined by the version configured in the Version Mapping tab of the Library Manager .

This tooltip symbol informs you about the resolution of the selected placeholder library, which deviates from the default.

Example when the Library Manager is in the Devices tree: The placeholder is explicitly redirected to this version (see the Placeholders dialog box).

Example when the Library Manager is in the Global node of the Tools tree:

In the 'Device 1' device, the placeholder is resolved to VisuElemsAlarm 1.0.0.0 (System).

Library that is signed with a trusted certificate.

Library that is signed with a trusted certificate, but references at least one unsigned library.

Library that is signed with a private key and token.

Library that is not signed, or signed with an untrusted or expired certificate. In the case of an untrusted certificate, the Trust Certificate command is provided in the context menu.

Library is not resolved and will not be included in the compile.

Library that is defined as optional and not available.

Library whose status is being determined.

Licensed library for which no valid license is available.

Library symbol for a library that cannot be loaded because its signature (encryption) could not be verified.

Libraries that have been automatically added to a project by adding a certain device or object, are displayed in gray; those that have been added manually by using the Add library... command are displayed in black.

If a library has dependencies on other libraries (referenced library), those are automatically included - if available - and are displayed with icon for referenced libraries in a subtree of the entry. Expand or collapse a subtree by clicking the respective plus or minus sign.

Description of the Lower Part

In the lower left part of the editor, the particular modules of the library selected in the upper part (the libraries list) are displayed in a tree structure.

The lower right part of the editor can contain the following tabs:

Tab

Description

Documentation

The information provided in this tab is library-specific information that is provided in the library file.

For user documentation on Schneider Electric libraries, refer to the Library Guide documents provided in the EcoStruxure Machine Expert online help. For third-party libraries, refer to the corresponding documents from the third party.

When creating a library, consider the items listed in the chapter Create Your Own Library.

Inputs/Outputs

The components of the selected library module are listed in a table with variable Name, data Type, Inherited from, Address , Initial value, and Comment , as defined in the library.

Graphical

Graphical representation of the module.

Library Parameters

This tab is available when a Global Parameter List is selected. For modifying library parameters, execute the command Library Parameters... to open the Library Parameters dialog box.

NOTE: Library parameters can only be displayed and configured in the Library Manager of applications.

Buttons and Commands

The following commands, which are provided in the editor view when one or several libraries are selected, correspond to those of the libraries. This is, by default, available in the menu bar as long as the Library Manager editor is active:

Command

Description

Add library

To include a library into the project

The precondition is that the library is installed on the local system. A message appears in case of trying to insert a library which is already available in the project.

Delete library

To delete the library selected in the library list from the project.

Properties

To edit general settings about the selected library such as the namespace version handling, visibility and accessing. Refer to the Properties... chapter.

Details

To display a dialog box with details about the library (general information, contents, properties, license information).

Try to reload library

If a library has not been found, then select it and execute this command to attempt to reload it into the project.

Placeholders

To redirect any placeholder and library group to a different version. Refer to the Placeholders... chapter.

Library parameters

Opens the Library Parameters dialog box that allows you to display and configure the parameters of the libraries that are available in the Library Manager of the Application node for each controller.

NOTE: Library parameters can only be displayed and configured in the Library Manager of applications.

Library repository

To define library locations and to install or uninstall libraries. Refer to the Library Repository chapter.

Icon legend

Opens the Information dialog box with a legend of the icons that display the status of a library in the list of integrated libraries.

Summary

Opens the Library Summary dialog box that displays the libraries referenced in the project in a tree structure including the libraries that are referenced by these libraries.

Select a library and execute the command Display all occurrences in library hierarchy and close dialog or double-click a library to highlight in the Library Manager editor the libraries that reference or use the selected library.

Display of the libraries:

  • Managed Library: Name and version of the library

  • Number of Occurrences : Number of locations where this library is referenced by other libraries

When you click the plus sign of a library, the libraries that reference this library are displayed in the next sublevel.

Command

Description

Trust certificate

Available in the context menu of a library selected in the Library Manager editor, in which the library has been signed with an untrusted certificate. The command turns the untrusted certificate into a trusted certificate and the prepended icon changes from to .

Export library

Available in the context menu of a library selected in the Library Manager editor: Opens the default dialog box for saving the library file in the file system.