EPLAN.EPLAN21.WIRENUMBERING.BUILDCONFIG

Contents

Description

Command for creating configurations for the wire numbering. On account of the complexity of the wire numbering function with more than 20 available setting possibilities per numbering type, the Settings dialog available in EPLAN should be preferably used. The command allows for taking over the default settings as specified there in the form of a "configuration." Configurations simplify working with wire-numbering routines by enabling the user to modify complete parameter records and save them under a new name. The configurations created this way can then be used by the EPLAN.EPLAN21.WIRENUMBERING.PROJECT command.
 

A configuration consists of a list of properties with associated values (property list). The following default configurations are available:

"TargetBased" and "PotentialBased".

These correspond to the Potential-based and Target-based settings as definable via dialog. (There is an additional default setting "wirenum_Automatic". This default corresponds to the setting which was active when last calling up the wire-numbering function.)
In order to be able to use the command sensibly, the configuration should be determined first; then the individual values can easily be overwritten.

General Procedure:

setParam(....,EPL_PARAM_WN_CONFIGNAME,"<here configuration_name">)

    //and then determine the deviating values, e.g.:

setParam(....,EPL_PARAM_CHARSET,"01");
    //number in the dual system...
    //Finally, the new configuration name is indicated

setParam(...,EPL_PARAM_WN_NEWCONFIGNAME)

Parameters

All parameters have the prefix "EPL_PARAM_WN_".

ParameterID Type Description
NEWCONFIGNAME  [IN, OPTIONAL]
String
Name of the NEW configuration.
CONFIGNAME  [IN, OPTIONAL]
String
Name of the configuration to be used as template.
FORCECOUNTER  [IN, OPTIONAL]
String
Use counter on/off.
USEIOADRESS  [IN, OPTIONAL]
String
Use PLC I/O addresses.
XREFFORMAT  [IN, OPTIONAL]
String
 Format string (property user is wire).
DOOVERWRITE  [IN, OPTIONAL]
String
Overwrite mode on/off.
DOUSEDET  [IN, OPTIONAL]
String
Use preferably device-end terminal name.
GKLEMMFORMAT  [IN, OPTIONAL]
String
Transfer format of GE terminals (default "" is ok!).
DOHOLDNAM  [IN, OPTIONAL]
String
Compatibility to 2.15 (do not use).
DOHIDEMULTI  [IN, OPTIONAL]
String
Display wiring text only on unique wires.
PREFIX  [IN, OPTIONAL]
String
Prefix (format string and/or text. Property user is connection "From").
POSTFIX [IN, OPTIONAL]
String
Postfix(format string and/or text. Property user is connection "To").
STARTNUMBER  [IN, OPTIONAL]
String
Start number.
INCREMENT  [IN, OPTIONAL]
String
Increment value.
ANZAHLSTELLEN  [IN, OPTIONAL]
String
Number of characters to be used.
NUMBERPOTENTIAL  [IN, OPTIONAL]
String
Potential-based numbering on/off.
FORMATFROMSOURCE  [IN, OPTIONAL]
String
Format string for "From."
FORMATFROMDESTINATION  [IN, OPTIONAL]
String
Format string for "To."
FORMATFROMPOTENTIAL  [IN, OPTIONAL]
String
Format string from potential.
FORMATFROMPOSITION  [IN, OPTIONAL]
String
Format string from position (wiring position).
ALPHANUMERICCOUNTER  [IN, OPTIONAL]
String
Use alphanumeric counter.
TXTONLYONCEPERWIRE  [IN, OPTIONAL]
String
Display texts only once per wire.
SEP  [IN, OPTIONAL]
String
Separating character between name and counter.
CHARSET  [IN, OPTIONAL]
String
Character set for the numbering (example: 01 for binary 0123456789ABCDEF for hexadecimal).
MARKASMANUALSET  [IN, OPTIONAL]
String
Mark as manually set.

Error Messages

If no new configuration name is entered, EPL_ERROR is returned.