Skip to content

EPLAN Symbols, Parts and Master Data

On this page

Symbols, parts and master data are part of the EPLAN integration in the Pro+ and Enterprise plans. Studio shows the symbols of the open EPLAN project with their pictures, looks up, creates, changes and deletes parts in the EPLAN parts database and brings master data from EPLAN into the project, without switching to EPLAN.

Prerequisites

  • An open EPLAN project in Studio (see EPLAN Integration).
  • A Pro+ or Enterprise license.
  • For looking up and editing parts: the EPLAN option for the parts management API. To change parts, EPLAN must open the parts database for writing. For EDZ export also the EPLAN EDZ option. For importing and exporting symbol libraries: the EPLAN symbol library option. Without an option, its commands are greyed out and the tooltip names the missing option.

The Symbols View

Open the Symbols view in the EPLAN sidebar. It lists the symbol libraries of the project, and below each library its symbols with picture, symbol number, name and description.

  • Type in the filter box to find symbols by name or description.
  • Show More at the end of the list loads further symbols.
  • Hover over a symbol to see the pictures of all its variants, with the variant name and the number of connection points. Variants A to D turn the symbol, variants E to H mirror it.
  • Filter by Library… in the title bar shows one library only; All Libraries shows them all again. Refresh Symbols reads the symbols again.
  • Right-click a symbol for Insert into Page… and Copy Symbol Name.

Insert a Symbol

  1. Double-click a symbol or choose Insert into Page…. On a page in the Project Explorer, Insert Symbol… asks for the library and the symbol first.
  2. Pick the variant. The list shows the picture of each variant; the variant you used last for this symbol comes first.
  3. Pick the page. The page open in the page preview comes first.
  4. Choose the position: Place in Preview waits for your click on the page (Escape cancels), Enter Coordinates asks for X and Y in millimetres.

Studio reports the inserted symbol; Show Page opens the page.

Drag a Symbol onto a Page

Open a page in the page preview and drag a symbol from the Symbols view onto it. The preview shows a frame while you drag; release the mouse where the symbol goes. Studio inserts it with the variant you chose last for this symbol (variant A the first time). Press Escape while dragging to cancel.

Manage Parts

Choose Manage EPLAN Parts in the title bar of the Project Explorer or in the Command Palette. The EPLAN Parts editor opens.

Look Up Parts

  1. Type a search text, for example the order number 6ES7 521, and choose Search.
  2. Tick the fields to search: part number, order number, type number, PLC type designation, GSD file, manufacturer or description. Part number, order number, type number and PLC type designation are ticked at first.
  3. Optionally type the name of a filter scheme of the EPLAN parts management.

The table shows part number, variant, order number, manufacturer, description, PLC type designation and GSD file; Show More loads further parts. Select a part to see its fields and its function templates below the table.

  • Copy Part Number copies the part number of the selected part.
  • Use as Article of Selected Device sets the part on the device selected in the Project Explorer: after your confirmation, it replaces the first article of the device, or assigns it when the device has none.
  • Export as EDZ… writes the selected parts (Ctrl+click selects several) with all their variants into an EDZ file you choose.

Every change described below goes straight into the EPLAN parts database. Studio makes no backup of the parts database, so make one in EPLAN first if you want to be able to go back.

Create a Part as a Copy

  1. Select the part you want to start from and choose New Part from Selected….
  2. Enter the new part number (Studio suggests the part number with _copy) and the variant.
  3. If you like, enter a new order number and description right away.

Studio creates the part with all the data and function templates of the source and shows it at once. The copy does not take over the ERP numbers and ERP descriptions, the unique ID and the data portal identifiers of the source, so it does not pass for the original part. If the part number and variant exist already, Studio tells you and creates nothing.

Change the Fields of a Part

The Part section shows the part number, variant and manufacturer name, and lets you change:

  • order number, type number and manufacturer (the short name of a manufacturer that exists in the parts database),
  • description and note, on several lines, for each language: pick the language next to the field,
  • PLC type designation, device description file and its index, PLC station type, symbol macro and picture file,
  • PLC is CPU and Bus coupler,
  • generic product group, product group and product subgroup; each list offers only the groups that belong to the one above it.

Choose Apply to write your changes into the parts database, or Revert to bring back the stored values. If a value is refused, Studio names the fields it applied and the ones it did not. When you select another part or close the editor with changes you have not applied, Studio asks whether to discard them. Closing or reloading the Studio window discards them without asking.

Function Templates

The Function Templates section lists the function templates of the part with position, function, plug device tag, connection point and its description, cross-section, bus system, bus interface name and channel.

  • Add Function Template… adds a copy of a template, either From This Part or From Another Part… (enter the part number, then pick the template). The new template is added at the end and opens for editing.
  • Edit… turns a row into input fields; change the values and choose Save Row (or press Enter), Cancel (or Escape) keeps the row as it was. A template without PLC data only lets you change its additional description.
  • Move Up and Move Down change the position of a template.
  • Remove takes out one template, Remove Selected the templates you selected with Ctrl or Shift. Studio lists them and asks before it removes them.

If someone changed the function templates of the part in the meantime, Studio refuses the change; select the part in the results again so it is read again, then repeat the change.

Delete a Part

Select the part and choose Delete Part…. Studio asks before it deletes the selected variant; the other variants of the part stay. This cannot be undone. Projects that already use the part keep their own copy of its data.

Read-Only Parts Database

When EPLAN opens the parts database read-only, the editor shows Read-only database and every field and button for changes is locked; looking up parts still works. This also happens when a newer EPLAN version has upgraded the parts database: an older EPLAN version then opens it read-only. Open a writable parts database in EPLAN to make changes.

Master Data of the Project

Master Data in the title bar of the Project Explorer brings master data from EPLAN into the project. EPLAN's own master data always stays as it is.

  • Show Project Master Data lists the symbol libraries, forms, plot frames and other master data of the project; entries that EPLAN has too are marked "also in EPLAN".
  • Add Master Data to Project… offers the master data that EPLAN has and the project does not, optionally of one kind only. Select the entries and Studio copies them into the project.
  • Update Project Master Data replaces the master data of the project with the current versions from EPLAN.
  • Complete Project Master Data adds the master data the project uses but does not contain.

Symbol Libraries

  • Import Symbol Library… creates a symbol library from a symbol library exchange file (.esl) in a folder you choose. Studio does not write into the symbol folder of EPLAN; copy the new library into EPLAN yourself. If the target file exists, the save dialog asks before it is replaced.
  • Export Symbol Library… writes a symbol library of EPLAN into an exchange file (.esl).

Undo

Symbols inserted by the AI assistant are undone with Discard AI Changes. Adding, updating or completing master data cannot be undone that way: Studio and the assistant ask before they change the master data of the project, and changes the assistant made before are kept first.

Changes to the EPLAN parts database are not undone by Discard AI Changes either, whether you or the assistant made them, and Studio keeps no backup of the parts database. Discarding the assistant's changes to the project leaves the parts database as it is.

With the AI Assistant

You can ask the EPLAN Engineer agent to list symbols and their variants, insert a symbol in a variant, look up the part of a TIA Portal card by its order number and read its GSD file, export parts as EDZ, list and add master data or import and export symbol libraries. It asks for your confirmation before every change and every file it writes.

The agent can also manage the parts database: create a part as a copy, change its fields, add, change, reorder and remove function templates, and delete a part. Each of these changes shows a confirmation that names the part and what changes, every time: also when you chose Allow in This Session or Always Allow for the tool, and in Autopilot. The confirmation reminds you that Discard AI Changes cannot undo the change. If the function templates of the part changed since the agent last read it, the agent reads the part again before it can change them.

Availability

Symbols, parts and master data come with the Pro+ and Enterprise plans, the same access level as the other EPLAN features. Looking up and editing parts also needs the EPLAN option for the parts management API.