Skip to main content

Converting a Project

  1. In CODESYS, open the binary project .project or the binary library .library which you want to convert.

  2. Select the Convert Project command.

  3. In the Browse input field, select or create the destination folder for the file-based project.

    1. If a folder or file with the same name already exists, then a conflict will be reported and the conversion will not continue.

      The conversion will be aborted.

    2. If the destination folder is not empty, then you will be prompted to delete the folder before continuing.

      Important

      The destination folder must be empty.

  4. If the project has contents which do not match the file-based format, then the Convert project to file-based storage dialog will open.

    1. Check the reported problems there line-by-line. For more information, see the following: Command: Convert Project

    2. In case of an error, run the available quick fix. To do this, click the line containing the respective problem in the Fix column. Conversion is only possible when all errors have been fixed.

    3. Click the OK button to start the project conversion and close the dialog.

      The project will be converted and the progress will be displayed. The conversion cannot be canceled after it has started.

    The project will now be opened as an FBSPROJ file in the programming tool and as a result saved in a file-based format. Select the Open Folder in File Explorer command to track this.

Common Problems

Common problems and their quick fixes:

Problem

Quick fix

An object or folder name exceeds the length limit.

Rename the object or folder.

A name contains invalid space characters.

Remove the space characters from the object name.

A name contains unsupported characters.

Remove the unsupported characters from the object.

A declaration ends with an unsupported semicolon.

Remove the trailing semicolon.

The project is encrypted.

Disable project encryption.

The project integrity check is enabled.

Disable the project integrity check.

A device description is not installed.

Download the missing device description.

Adapting a project for conversion

Some problems cannot be fixed automatically and are reported for informational purposes only. Examples include an unsupported method overload or two libraries with the same namespace. Fix these kinds of problems in the project and then run the conversion again.

In this section: