Command: Include Externals to Project, Include Externals

Symbol:

Function: These commands open the Include externals dialog.

. Call:

Project → SVN menu
Context menu: SVN

Requirement: An object is selected in the object tree. The externals are integrated below that. If you have selected nothing or the project root directory, then the Include externals to project command is available. If you have selected an object, then the command Include externals is available.

Tip

The same externals cannot be integrated multiple times at different locations in the same project. This leads to problems in CODESYS because of conflicts with the internal identification of the object.

Dialog: Include Externals

Table 17. URL of the SVN repository

URL of the external that is integrated

The object to be integrated is versioned and can have sub-objects.

Externals are located at another location in the SVN repository than the project. It can even be in another SVN repository.

Example: file:///D:/SVN repo A/trunk/DSTest.project/GlobalTextList

Note: The objects that should be integrated below the selected object have to have a matching object type. For example, only one task can be integrated below the Task Configuration object.

Opens the Select Archive Categories dialog

There you can select a revision.

. The button is labeled with the currently selected revision:

HEAD: Newest revision (top revision)
Default
15: Revision number of the selected revision
12/23/2016 11:59:59 (UTC): Change date of the selected revision (UTC)

Note: The dialog provides the same options as the Revision group.

Opens the SVN Repository Browser dialog

There you can browse the SVN repository.

Table 18. Revision

Options for selecting a revision Note: the current valid selection is also displayed in the buttons next to the SVN repository URL.
HEAD	: Latest revision (top revision) selected within a branch
Revision	: A specific revision by the revision number Example: `3`
Date	: A specific revision by the modification date Example: `12/23/2016 11:59:59`
Use UTC Time	: Modification date in universal time

Adds the external and its sub-objects with the property svn:externals to your project (below the selected object)

The working copy is updated and the external is overlaid with the symbol.

Example: (external device Source)

Note: If the linking fails (for example when adding a device below a task configuration), then the complete operation fails and reverts back.

Note: Renaming or moving individual externals is permitted inly within an "external tree", whereby it is not permitted to move the top object.

To move an entire tree, you have to remove it and link it to another location.

Tip

"... You should seriously consider using explicit revision numbers in all of your externals definitions. Doing so means that you get to decide when to pull down a different snapshot of external information, and exactly which snapshot to pull. Besides avoiding the surprise of getting changes to third-party repositories that you might not have any control over, using explicit revision numbers also means that as you backdate your working copy to a previous revision, your externals definitions will also revert to the way they looked in that previous revision, which in turn means that the external working copies will be updated to match the way they looked back when your repository was at that previous revision. For software projects, this could be the difference between a successful and a failed build of an older snapshot of your complex codebase. ..."

This is cited from: http://svnbook.red-bean.com/nightly/en/svn.advanced.externals.html