Skip to main content

Dialog: Options: Libraries

Symbol: _cds_icon_option_lib.png

Function: The dialog helps you to manage the mappings of library references which CODESYS uses during the conversion of an old project. If you have not yet stored any mapping for a specific library, you have to redefine the mapping each time when you open an old project where this library is integrated.

Call: Tools → Options command, Libraries category

A mapping defines what a library reference looks like after the conversion of the project into the current format. There are three possibilities:

  • You retain the reference. This means that CODESYS also converts the library into the current format (*.library) and installs it in the local library repository.

  • You replace one reference with another reference. This means that one of the installed libraries replaces the integrated library.

  • You delete the reference. This means that the converted project no longer integrates the library.

CODESYS applies all of the listed mappings to the library references of an old project the next time it is converted. Therefore, you have to repeat the mapping definition if the same library is integrated again in a project which is to be converted.

You can enter a new mapping in the last line.

Source library

Path of the library which is integrated in the project before the conversion

Double-clicking an entry makes the field editable and the button for the input assistance is displayed.

Target library

Name and location of the library which is to be integrated in the project after the conversion

Double-clicking an entry opens the Set Target Library dialog.

Table 155. Dialog: Set Target Library

Scan

The Add Library dialog opens. There you can select a library from the library repository. The dialog corresponds to the dialog in the library repository.

Ignore. This library reference will not be imported.

When CODESYS converts the project, CODESYS always removes the existing source library from the project.