This functionality is only available for certain module packages. Info / Copyright

Configuration File for Importing Festo Parts

In the festo.cfg file, which is located in the ..\<Version number>\cfg directory, you define the Festo part properties that are to be imported. The assignment of the Festo parts to EPLAN macros or symbols is also done here. You can also define your own assignments for the properties.

The configuration file is divided into different sections: In the "Festo-Settings" section, you define the property assignments. This allows you, for example, to configure how the part numbers are constructed. The "Festo-MacroMapping" section defines the assignment of the macros to the Festo parts.

The following rules apply to editing of the configuration file:

Import mode

In the "DataImportSetting" section of the configuration file, you define the import mode using the following syntax:

ImportMode=<Number>

The import mode defines whether parts overwrite, or are appended to existing data when importing into the EPLAN internal parts management. The following import modes are possible:

Assign properties

Properties are assigned in the "Festo-Settings" section of the configuration file, according to the following syntax:

<Property number> = "<value>"

Warning:

You should not change the default properties in the "Festo Settings" section, since these are used to ensure that a functioning EPLAN part is created after the import.

You can define additional properties according to the rules specified above. Since the configuration file is processed sequentially, we recommend that you add your own definitions at the end of the section.

Defining the Festo properties to be imported

The Festo properties to be imported are specified via xDKI–PlaintextName (this is the language-independent name of the Festo property), whereby the name is case-sensitive.

The following Festo part data can be imported:

Placeholders for properties are designated by a preceding "#'" character.

Syntax: [#<Property name>]

For Festo properties: [#<xDKI clear name>]

Note:

If new Festo properties are added to new Festo product catalogs in the future, then these can also be imported by specifying the corresponding xDKI–PlaintextName.

Indexed properties

It is possible to access indexed properties (e.g., the "Free properties").

Syntax: <EPLAN Property number>.<Index>

Other customization

You can make a number of import customizations in the configuration file. Among others, you can use the following commands and elements for this. Be sure to observe the rules at the beginning of the configuration file.

IF conditions

IF conditions can be used within the assignment file. Only one pair of properties can be compared using the IF condition. Upper / lower case sensitivity is important when evaluating IF conditions. The following comparison operators are available:

Hyperlinks

Hyperlinks in the parts data provide access to the Festo website, which contains current documentation and technical data of the parts. On import, hyperlinks are automatically entered into the File / Hyperlink 1 field on the Documents tab of the Parts management module.

Displayed language

You can use the #EPLAN.Lng placeholder to display properties in a particular language. On import, this placeholder is filled with the current display language.

Syntax: long=[#EPLAN.Lng]

Warning:

The display language at the time of import is permanently entered into the properties and is not updated when the display language is changed. The language can only be changed by re-importing the parts with the changed display language. The old parts must be deleted when doing this.

You can also enter a language directly using the lang=<Language> entry (for example lang="en_US").

Variables

10 variables of type "String" are available for temporary storage of values within the configuration (without misusing EPLAN properties for this purpose). Variables are designated by a preceding "$" character.

Syntax: [$EPLAN.Str0][$EPLAN.Str9]

The values assigned to variables are only temporarily available during the import, and do not change any values of the Festo part properties to be imported.

Assign macros or symbols

Macros or symbols are assigned to the Festo parts in the "Festo-MacroMapping" section of the configuration file, according to the following syntax:

For macros:

if ([#SymbolId] == "<Order number>") 22145 = "<Subdirectory>\<Macro name>.EMA"

or

if ([#SymbolId] == "<Order number>") 22145 = "<Subdirectory>\<Macro name>.EMS"

For symbols:

if ([#SymbolId] == "<Order number>") 22146 = "<Subdirectory>\<Symbol name>.ESY"

See also