EPLAN.EPLAN21.WIRENUMBERING.CIRCUIT

Contents

Description

Command for numbering wires. 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 from configurations, with a configuration consisting of a list of properties with the associated values.

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,"<enter configuration_name here>")

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

setParam(....,EPL_PARAM_CHARSET,"01"); // number in the dual system...

Parameters

All parameters have the prefix "EPL_PARAM_WN_".

ParameterID Type Description
PROJECT  [IN]
EplHandle
Name of the project whose wires are to be numbered.
CONFIGNAME  [IN]
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 terminals.
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]
Integer
Start number.
INCREMENT  [IN, OPTIONAL]
Integer
Increment value.
ANZAHLSTELLEN  [IN, OPTIONAL]
Integer
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.

Reference