The following tables list the tags used for export and import, their attributes, and additional information. Here, the data types in the "Type" column have the following meanings:
Bool
"0" or " " mean "no", "false", or "off", "1" means "yes", "true", or "on".
Integer / Long
"", "0", "1", "2", or "-5"
"" means the same as "0".
For attributes of a selection list, only certain values may be used which can be selected in parts management. An overview of the valid values can be found in the section Overview of Selection Lists.
Double / Currency
The decimal separator is the period.
"1.99" or "2.5"
"" means the same as "0".
Text / memo
"This is a text" or "".
Multilingual text
Language parts in a multilingual text are defined starting with the language code and ending with a semicolon. Between the language code and the text there must be an "@".
<partsmanagement>
Attribute |
Field name |
Remark |
---|---|---|
|
Unit of length | Unit in which lengths are imported, for instance "mm" or "inch". Optional, default "mm". |
|
Type | Type of parts management. Currently the only supported value is "EPLAN.PartsManagement". Optional. |
|
Build number | Build number at the time of export. Optional. |
<part>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Integer | 2 bytes | Type | This attribute must be set to the value "1" ("Component"), "4" ("Assembly") or "5" ("Module")! |
|
Text | 255 characters | Part number |
|
|
Bool | 1 bytes | Accessories |
|
|
Text | 50 characters | Certification: General |
|
|
Bool | 1 bytes | Certification: CE |
|
|
Text | 50 characters | Certification: UL |
|
|
Text | 50 characters | Certification: VDE |
|
|
Text | 50 characters | Certification: ATEX identifier |
|
|
Text | 40 characters | Drilling pattern |
|
|
Bool | 1 bytes | Trade: Cooling |
|
|
Bool | 1 bytes | Trade: Electrical engineering |
|
|
Bool | 1 bytes | Fluid power trade |
|
|
Bool | 1 bytes | Trade: Hydraulics |
|
|
Bool | 1 bytes | Trade: Lubrication |
|
|
Bool | 1 bytes | Trade: Mechanics |
|
|
Bool | 1 bytes | Trade: Pneumatics |
|
|
Bool | 1 bytes | Trade cooling lubricant |
|
|
Bool | 1 bytes | Trade gas engineering |
|
|
Bool | 1 bytes | Trade fluid power (undefined) |
|
|
Bool | 1 bytes | Process engineering trade |
|
|
Text | 40 characters | Creation date |
|
|
Double | 8 bytes | Depth |
|
|
Bool | 1 bytes | Discontinued part |
|
|
Double | 8 bytes | Mounting clearance Depth: Front |
|
|
Double | 8 bytes | Mounting clearance Depth: Rear |
|
|
Memo | 0 characters | Designation 1 | Multilingual |
|
Memo | 0 characters | Designation 2 | Multilingual |
|
Memo | 0 characters | Designation 3 | Multilingual |
|
Double | 8 bytes | Discount |
|
|
Text | 255 characters | Texture | Example: |
|
Text | 50 characters | ERP no. |
|
|
Memo | 0 characters | External document 1 | |
|
Memo | 0 characters | External document 2 | |
|
Memo | 0 characters | External document 3 | |
|
Memo | 0 characters | External document 4 | |
|
Memo | 0 characters | External document 5 | |
|
Memo | 0 characters | External document 6 | |
|
Memo | 0 characters | External document 7 | |
|
Memo | 0 characters | External document 8 | |
|
Memo | 0 characters | External document 9 | |
P_ARTICLE_EXTERNAL_DOCUMENT_10 | Memo | 0 characters | External document 10 | |
|
Memo | 0 characters | External document 11 | |
|
Memo | 0 characters | External document 12 | |
|
Memo | 0 characters | External document 13 | |
|
Memo | 0 characters | External document 14 | |
|
Memo | 0 characters | External document 15 | |
|
Memo | 0 characters | External document 16 | |
|
Memo | 0 characters | External document 17 | |
|
Memo | 0 characters | External document 18 | |
|
Memo | 0 characters | External document 19 | |
P_ARTICLE_EXTERNAL_DOCUMENT_20 | Memo | 0 characters | External document 20 | |
|
Bool | 1 bytes | External placement |
|
|
Text | 30 characters | Function group |
|
|
Text | 20 characters | Barcode number |
|
|
Text | 20 characters | Barcode type |
|
|
Text | 255 characters | Graphical macro (incl. directory) |
|
|
Text | 10 characters | Group number |
|
|
Text | 255 characters | Macro | Example: |
|
Double | 8 bytes | Height |
|
|
Double | 8 bytes | Mounting clearance Height: Above |
|
|
Double | 8 bytes | Mounting clearance Height: Below |
|
|
Text | 40 characters | Last change |
|
|
Text | 16 characters | Service time |
|
|
Text | 16 characters | Lubrication / maintenance |
|
|
Text | 30 characters | Manufacturer |
|
|
Long | 4 bytes | Mounting surface | Selection list |
|
Double | 8 bytes | Space requirement |
|
|
Memo | 0 characters | Description | Multilingual |
|
Text | 255 characters | Order number |
|
|
Currency | 8 bytes | Purchase price 1/packaging |
|
|
Currency | 8 bytes | Purchase price 2/packaging |
|
|
Double | 8 bytes | Quantity/packaging |
|
|
Text | 255 characters | Image file |
|
|
Text | 10 characters | Part group |
|
|
Integer | 2 bytes | Price unit |
|
|
Integer | 2 bytes | Generic product group | Selection list |
|
Integer | 2 bytes | Product group | Selection list |
|
Integer | 2 bytes | Product subgroup | Selection list |
|
Currency | 8 bytes | Purchase price 1/price unit |
|
|
Currency | 8 bytes | Purchase price 2/price unit |
|
|
Memo | 0 characters | Quantity unit | Multilingual |
|
Double | 8 bytes | Offset in X direction (connection point pattern) | |
|
Double | 8 bytes | Offset in Y direction (connection point pattern) | |
|
Text | 20 characters | Identifier for reports |
|
|
Memo | 0 characters | Symbol for reports |
|
|
Currency | 8 bytes | Sales price 1 |
|
|
Currency | 8 bytes | Sales price 2 |
|
|
Double | 8 bytes | Clip-on height |
|
|
Double | 8 bytes | Center mismatch |
|
|
Double | 8 bytes | Mounting depth |
|
|
Text | 16 characters | Spare part |
|
|
Text | 16 characters | Stress |
|
|
Memo | 0 characters | Subtrade "Electrical engineering" | Multilingual; if you yourself have produced a subtrade under a trade, this is output in the form P_ARTICLE_SUBCRAFT_<Trade>-1="??_??@<Subtrade name>;" (so e.g. P_ARTICLE_SUBCRAFT_ELECTRICAL-1="??_??@test;" for the first subtrade under "Electrical engineering" with the name "test"). As the properties are indexed, the index is output with a "minus". |
|
Memo | 0 characters | Subtrade "Mechanics" | Multilingual |
|
Memo | 0 characters | Subtrade "Hydraulics" | Multilingual |
|
Memo | 0 characters | Subtrade "Pneumatics" | Multilingual |
|
Memo | 0 characters | Subtrade "Lubrication" | Multilingual |
|
Memo | 0 characters | Subtrade "Cooling" | Multilingual |
|
Memo | 0 characters | Subtrade "Process engineering" | Multilingual |
|
Text | 30 characters | Supplier |
|
|
Text | 40 characters | Connection point designation (connection points) |
|
|
Text | 255 characters | Connection dimension target |
|
|
Text | 255 characters | Connection dimension source |
|
|
Text | 255 characters | Type number |
|
|
Text | 50 characters | Unique part ID |
Derives from Data Portal. |
|
Text | 16 characters | Procurement |
|
|
Text | 16 characters | Wearing part |
|
|
Double | 8 bytes | Weight |
|
|
Double | 8 bytes | Width |
|
|
Double | 8 bytes | Mounting clearance Width: Left |
|
|
Double | 8 bytes | Mounting clearance Width: Right |
|
|
Text | 255 characters | Graphical macro |
|
The following additional attributes are for mechanical parts:
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Long | 4 bytes | Door: hinge | Properties; Selection list |
<variant>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Text | 3 characters | Variant |
|
|
Bool | 1 bytes | Distributed placement of assembly | Assembly |
|
Text | 255 characters | Connection point designation |
|
|
Text | 30 characters | Symbol library |
|
|
Text | 30 characters | Symbol number |
|
|
Text | 60 characters | Technical characteristics |
|
|
Integer | 2 bytes | Unit for connection cross-section / diameter | Properties; Selection list |
<functiontemplate>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Integer | 2 bytes | Position |
|
|
Integer | 2 bytes | Category (function data) | Selection list |
|
Integer | 2 bytes | Group (function data) | Selection list |
|
Integer | 2 bytes | Function definition (function data) | Selection list; the attributes "functiondefcategory", "functiondefgroup", and "functiondefid" together make up a function definition (see also Overview of Function Definitions). |
|
Memo | 0 | Description (function data) | Multilingual |
|
Text | 60 characters | Technical characteristics | The meaning of this attribute depends on the type of part: Product group "General": "Technical characteristics" Product group "Cables": "Potential type" (Selection list) Product group "Relays, contactors": "Technical characteristics" Product group "Plugs": is not used Product group "Terminals": is not used Product group "PLC": is not used |
|
Text | 255 characters | Connection point cross-section / diameter |
|
|
Text | 255 characters | Connection point designations | The meaning of this attribute depends on the type of part: Product group "General": "Connection point designations" Product group "Cables": "Connection color / number" Product group "Relays, contactors": "Connection point designations" Product group "Plugs": "Connection point designations" Product group "Terminals": "Connection point designations" Product group "PLC": "Connection point designations" A line break is used as a separator! |
|
Text | 255 characters | Connection point descriptions |
|
|
Text | 255 characters | Connection dimension |
|
|
Text | 30 characters | Terminal / pin description |
|
|
Bool | 1 bytes | Terminal with LED |
|
|
Bool | 1 bytes | Terminal with plug-in adapter | Only available for function templates of terminals. |
|
Text | 30 characters | Index 1 | The meaning of this attribute depends on the type of part: Product group "General": is not used Product group "Cables": "Shielded by" Product group "Relays, contactors": "Contact / coil index" Product group "Plugs": is not used Product group "Terminals": "Level" Product group "PLC": "Channel designation" |
|
Text | 30 characters | Index 2 | The meaning of this attribute depends on the type of part: Product group "General": is not used Product group "Cables": "Pair index" Product group "Relays, contactors": is not used Product group "Plugs": is not used Product group "Terminals": is not used Product group "PLC": is not used |
|
Bool | 1 bytes | Intrinsically safe |
|
|
Text | 30 characters | Subordinate DT |
|
|
Text | 20 characters | Pipe class |
|
|
Integer | 2 bytes | Bus system | Selection list |
|
Bool | 1 bytes | Safety function |
|
|
Text | 50 characters | Symbol |
|
|
Text | 255 characters | Symbol macro |
|
|
Integer | 2 bytes | Terminal category | Selection list |
|
Text | 20 characters | Labeling type |
|
|
Text | 30 characters | Terminal number | The meaning of this attribute depends on the type of part: Product group "General": is not used Product group "Cables": "Connection cross-section / diameter" Product group "Relays, contactors": is not used Product group "Plugs": "Terminal / pin designation" Product group "Terminals": "Terminal / pin designation" Product group "PLC": "Plug designation" |
<freeproperty>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Integer | 2 bytes | Position | No more than 200 allowed! |
|
Memo | 0 characters | Free properties: Description | Multilingual |
|
Text | 50 characters | Free properties: Unit |
|
|
Memo | 0 characters | Free properties: Value | Multilingual |
<blockingSurfacePosition>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Integer | 2 bytes | Position |
|
|
Bool | 1 bytes | Front |
|
|
Double | 8 bytes | Height |
|
|
Long | 4 bytes | Type | Selection list |
|
Double | 8 bytes | Width |
|
|
Double | 8 bytes | X position |
|
|
Double | 8 bytes | Y position |
|
<doorPosition>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Integer | 2 bytes | Position |
|
|
Text | 255 characters | Part number |
|
|
Text | 3 characters | Variant |
|
|
Double | 8 bytes | X position |
|
|
Double | 8 bytes | Y position |
|
|
Double | 8 bytes | Z position |
|
<mountingPanelPosition>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Integer | 2 bytes | Position |
|
|
Double | 8 bytes | Angle |
|
|
Long | 4 bytes | Mounting location | Selection list |
|
Text | 255 characters | Part number |
|
|
Text | 3 characters | Variant |
|
|
Double | 8 bytes | X position |
|
|
Double | 8 bytes | Y position |
|
|
Double | 8 bytes | Z position |
|
<supportBarPosition>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Integer | 2 bytes | Position |
|
|
Double | 8 bytes | Length |
|
|
Text | 255 characters | Part number |
|
|
Text | 3 characters | Variant |
|
|
Double | 8 bytes | X position |
|
|
Double | 8 bytes | Y position |
|
|
Double | 8 bytes | Z position |
|
<assemblyposition>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Integer | 2 bytes | Position |
|
|
Integer | 2 bytes | Quantity |
|
|
Text | 255 characters | Part number |
|
|
Text | 3 characters | Variant |
|
|
Text | 50 characters | Item number |
|
|
Text | 50 characters | Supplementary text |
|
<moduleposition>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Integer | 2 bytes | Position |
|
|
Integer | 2 bytes | Quantity |
|
|
Text | 255 characters | DT |
|
|
Text | 16 characters | Module ID |
|
|
Text | 255 characters | Part number |
|
|
Text | 3 characters | Variant |
|
<attributeposition>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Integer | 2 bytes | Position |
|
|
Text | 80 characters | Value |
|
<accessoryposition>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Bool | 1 bytes | Required |
|
|
Text | 255 characters | Part number |
|
|
Integer | 2 bytes | Position |
|
|
Text | 3 characters | Variant |
|
|
Integer | 2 bytes | Record type | Selection list; only "Component" and "Accessory list" are supported! |
placement | Text | 50 characters | Accessory placement |
|
<accessorylist>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Integer | 2 bytes | Type | Only the value 13 is supported! |
|
Text | 40 characters | Creation date |
|
|
Memo | 0 characters | Description |
|
|
Text | 40 characters | Last change |
|
|
Text | 40 characters | Name |
|
<accessorylistposition>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Text | 255 characters | Part number |
|
|
Integer | 2 bytes | Position |
|
|
Text | 3 characters | Variant |
|
|
Text | 50 characters | Accessory placement |
|
<accessoryplacement>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Integer | 2 bytes | Type | Only the value 14 is supported! |
|
Text | 40 characters | Creation date |
|
|
Memo | 0 characters | Description |
|
|
Text | 40 characters | Last change |
|
|
Text | 50 characters | Name |
|
<accessoryplacementposition>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Text | 40 characters | Installation variant |
|
|
Integer | 2 bytes | Position |
|
|
Integer | 2 bytes | Base point |
|
|
Double | 8 bytes | Rotation |
|
|
Double | 8 bytes | Offset in X-direction |
|
|
Double | 8 bytes | Offset in Y-direction |
|
|
Double | 8 bytes | Offset in Z-direction |
|
|
Bool | 1 bytes | Can be moved |
|
<construction>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Integer | 2 bytes | Type | Only the value 6 is supported! |
|
Text | 40 characters | Creation date |
|
|
Memo | 0 characters | Description | Multilingual |
|
Text | 40 characters | Last change |
|
|
Text | 40 characters | Name |
|
<constructionPosition>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Integer | 2 bytes | Position |
|
|
Text | 40 characters | Name |
|
|
Double | 8 bytes | Offset in X-direction |
|
|
Double | 8 bytes | Offset in Y-direction |
|
<drillingPosition>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Integer | 2 bytes | Position |
|
|
Double | 8 bytes | Angle |
|
|
Double | 8 bytes | 1st dimension |
|
|
Double | 8 bytes | 2nd dimension |
|
|
Double | 8 bytes | 3rd dimension |
|
|
Long | 4 bytes | Drill every n-th hole |
|
|
Text | 255 characters | Outline name |
|
|
Double | 8 bytes | End spacing |
|
|
Double | 8 bytes | Repetitive spacing |
|
|
Long | 4 bytes | Subtype | Selection list |
|
Long | 4 bytes | Drill type | Selection list |
|
Double | 8 bytes | X position |
|
|
Double | 8 bytes | Y position |
|
|
Bool | 1 bytes | Always make |
|
<terminal>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Integer | 2 bytes | Type | Only the value 7 is supported! |
|
Double | 8 bytes | Additional length |
|
|
Text | 40 characters | Creation date |
|
|
Memo | 0 characters | Description | Multilingual |
|
Long | 4 bytes | Routing direction | Selection list |
|
Text | 40 characters | Last change |
|
|
Text | 40 characters | Name |
|
|
Long | 4 bytes | Wire termination processing (EPLAN Cabinet) | Selection list |
|
Text | 20 characters | Connection dimension |
|
|
Long | 4 bytes | Connection category | Selection list |
<terminalPosition>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Integer | 2 bytes | Position |
|
|
Double | 8 bytes | Additional length |
|
|
Text | 255 characters | Plug designation |
|
|
Long | 4 bytes | Routing direction | Selection list |
|
Integer | 2 bytes | Level |
|
|
Double | 8 bytes | Max. cross-section / diameter |
|
|
Long | 4 bytes | Max. number of connections |
|
|
Double | 8 bytes | Min. cross-section / diameter |
|
|
Text | 20 characters | Max. AWG |
|
|
Text | 20 characters | Min. AWG |
|
|
Text | 20 characters | Connection point designation |
|
|
Integer | 2 bytes | Internal / External index |
|
|
Text | 20 characters | Connection dimension |
|
|
Bool | 1 bytes | Dual sleeve prescribed |
|
|
Long | 4 bytes | Connection category | Selection list |
|
Double | 8 bytes | X position |
|
|
Double | 8 bytes | Y position |
|
|
Double | 8 bytes | Z position |
|
|
Double | 8 bytes | X vector |
|
|
Double | 8 bytes | Y vector |
|
|
Double | 8 bytes | Z vector |
|
<safetyRelatedValuePosition>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Integer | 2 bytes | Position |
|
|
Integer | 2 bytes | Position ID |
|
|
Memo | 0 | Level 1 (text in tree structure) | Multilingual |
|
Memo | 0 | Level 2 (text in tree structure) | Multilingual |
|
Memo | 0 | Level 3 (text in tree structure) | Multilingual |
|
Memo | 0 | Level 4 (text in tree structure) | Multilingual |
|
Memo | 0 | Level 5 (text in tree structure) | Multilingual |
|
Bool | 1 bytes | Input (collect) |
|
|
Bool | 1 bytes | Logic (Generate report) |
|
|
Bool | 1 bytes | Output (React) |
|
|
Text | 30 characters |
|
|
|
Text | 30 characters |
|
|
|
Double | 8 bytes |
|
|
|
Double | 8 bytes |
|
|
|
Double | 8 bytes |
|
|
|
Double | 8 bytes |
|
|
|
Double | 8 bytes |
|
|
|
Double | 8 bytes |
|
|
|
Double | 8 bytes |
|
|
|
Double | 8 bytes |
|
|
|
Double | 8 bytes |
|
|
<address>
Attribute |
Type |
Length |
Field name |
Remark |
---|---|---|---|---|
|
Integer | 2 bytes | Type | Selection list; only "Customer" and "Manufacturer / supplier" are supported! |
|
Text | 70 characters |
|
|
|
Text | 30 characters | Fax |
|
|
Text | 40 characters | Last change |
|
|
Text | 70 characters | Full name |
|
|
Text | 40 characters | Name 1 |
|
|
Text | 40 characters | Name 2 |
|
|
Text | 40 characters | Name 3 |
|
|
Memo | 0 characters | Description |
|
|
Text | 30 characters | Customer number |
|
|
Text | 50 characters | Phone |
|
|
Text | 30 characters | P.O. box |
|
|
Text | 30 characters | Short name |
|
|
Text | 30 characters | Country |
|
|
Text | 100 characters | Street |
|
|
Text | 30 characters | Title |
|
|
Text | 100 characters | City |
|
|
Text | 30 characters | Zip code / P.O. box |
|
|
Text | 30 characters | Zip code / City |
|