dl-breadcrumbs__homedl-breadcrumb-item__separatorConfiguration and programmingdl-breadcrumb-item__separatorProgramming with CODESYSdl-breadcrumb-item__separatorAutomation Builderdl-breadcrumb-item__separator...dl-breadcrumb-item__separatorReference: User Interface dl-breadcrumb-item__separatorObjects dl-breadcrumb-item__separatorObject: External File dl-breadcrumb-item__separatorDialog: Add External File
dl-pagination__prev-inactivedl-pagination__prev-activedl-pagination__next-inactivedl-pagination__next-active
Dialog: Add External File dl-permalink__symbolPermalink

“File path”

Path of the external file

The _cds_icon_three_dots.png button opens a dialog for selecting a file in the local file system.

“Name”

Object name for the file in CODESYS

If you leave it blank, then the file revert to its previous name.

“File Handling”

Determines how the external file is saved in the CODESYS project

“Remember the link”

_cds_icon_radiobutton_acitvated.png: The file link which points to the external file in the Windows file system is saved.

Note: Access via the file link will fail if the external location of the file changes. The file is available in the project only as long as it exists in the defined storage location.

“Remember the link and embed into project”

_cds_icon_radiobutton_acitvated.png: The file link which points to the external file in the Windows file system is saved. Additionally, to increase security, a copy of the file is stored in the project.

Note about behavior on access:

  • The copy in the project is accessed only if the access via the link fails.

  • If the external file changes, then the copy is handled according to the option selected under “Change Tracking”.

“Embed into project”

_cds_icon_radiobutton_acitvated.png: A copy of the external file is saved in the Windows file system.

Note: The copy is always accessed. If the external file changes, then the project-internal copy will not be updated.

“Change Tracking”

Type of update for the copy saved in the project for which a file link was saved at the same time

Requirement: The “Remember the link and embed into project” option is selected.

“Reload the file automatically”

_cds_icon_radiobutton_acitvated.png: If the external file changes, then the copy stored in the project is automatically updated.

“Prompt whether to reload the file”

_cds_icon_radiobutton_acitvated.png: If the external file changes, then a dialog prompt opens for you to decide whether or not the copy should be updated in the project.

“Do nothing”

_cds_icon_radiobutton_acitvated.png: Although the external file changes, the copy in the project remains unchanged.

Button: “Display File Properties”

Opens the default “Properties of <file name>” dialog of the external file in the Windows file system

This dialog is identical with the “Properties” dialog which can be opened in Windows from the context menu of the file.

“Online handling”

Handling of the file in online mode

“Transfer with Download/Online Change”

_cds_icon_option_activated.png: When a download and online change takes place, the external file is downloaded to the controller and stored in the “Target path”.

“Target path (relative to "$PlcLogic$" on the device)”

The target path can be specified in the following way:

  • For the ‎$PlcLogic$‎ root directory: Leave the input field blank

  • Individual folders (not available yet) in the root directory

    Example: ‎MySubDirectory‎

  • Folder of the application (below ‎$PlcLogic$‎)

    Example for the "App123" application: ‎App123‎

  • Nested folder structure below the application folder

    Example: ‎App123/Sub01/SubSub01‎

  • Use another available placeholder, for example the one for the visualization: ‎$visu$‎

NOTE:

When using available paths, pay attention to uppercase and lowercase.

Button “Add”

Inserts a new _cds_icon_external_file.png object (type “External File”).

For more information see: ⮫ “Dialog: Properties – External File ”