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

Libraries

A Library maps the product for which you later want to generate a documentation. You manage and organize your Library data in a library.

Organize data

The smallest information units in your Library are configuration variables and macros. While you define configuration variables in eBUILD, you manage macros in the EPLAN Platform. Placeholder objects in macros serve as the communicator between the EPLAN Platform and eBUILD.

You bundle several macros and the associated configuration variables into a Macro-Typical. Macro-Typicals can in turn be assigned in Typical-Groups. It is also possible to nest Typical-Groups in each other. The combination of the Macro-Typicals and Typical-Groups is then effected in the configurators. All these elements are part of your Library.

Define rules

You create and manage the rules in the Library. The rules can include rules on dependencies, calculations and on the appearance of the configurator. Configuration variables and the formula language designed for eBUILD are available for the definition of the rules. Through the rules you determine which configuration options the user has in Project Builder.

If you have filled a library with data, you can subsequently publish it. With the publication of the library it becomes visible for other users in the Project Builder.

  1. Navigation bar
  2. Selection area
  3. Defined working section

Preconditions:

  • You have started the EPLAN Platform.
  • You have signed in to EPLAN Cloud.
  • You have signed into an own organization.
  • You have called up the Designer.

ClosedCreate library
  1. Click Libraries in the navigation bar.
  2. Click New in the Libraries selection area.
  3. Enter the desired name for the library.
  4. The library is stored in the selection area.

Add a detailed description to your library. To this purpose open the Library information drop-down list in the defined working section to open an editor. Now edit your description.

ClosedSpecify settings for library

The settings apply for the Designer and the Project Builder.

  1. Select a Library in the Libraries selection area.
  2. Click Settings.
  3. Specify the desired options:
    • Measuring unit: Specify whether the measuring unit millimeter mm or inch in is to be applied.
    • Structure variables: Specify which structure identifiers of a macro are available. Activate the check box at all the structure identifiers that you require for your project structure.
    • Ladder logic: Activate the check box for the Ladder logic option if you want to generate a project documentation conforming to US standards.
  4. The settings for your library are specified.

Note

If you wish to use the measuring unit inch, ensure that you do so for all the elements that exist in your library. Otherwise the positions in the schematic cannot be calculated correctly.

ClosedPerform actions for libraries

You can perform different actions for your library.

  1. Select a Library in the Libraries selection area.
  2. Click Actions.
  3. Select one of the following options:
    • Upload: Upload a library that you have created with Cogineer. The rules of your library are also applied.
    • Import *.ela: Import a library from eBUILD, see also Archive a library.
  4. The action is performed for your library.

ClosedSynchronization between macro project and library

If you have modified macros that you already use in eBUILD in the macro project of the EPLAN platform, you have to update the whole library. This ensures that the macros that you use in the Macro-Typicals are up-to-date.

  1. Select a Library in the Libraries selection area.
  2. Click Synchronize macros.
  3. The synchronization between macro project and library is performed.

All the modifications are applied automatically for the corresponding elements in the Macro-Typicals or Typical-Groups. If data is deleted for which a reference existed in eBUILD (for example a deleted macro variant), a corresponding message is displayed.

ClosedTest a library in Project Builder

You can test your library in the Project Builder without other members of your organization having access to the library. You must have the role "Designer" in the Project Builder to be able to the test the library. Only in this way is the library visible for you. Drafts are shown as italic. Users with the "Project Builder" role cannot see the draft of your library.

  1. Draft of a library.

ClosedPublish library

If other employees from your organization are to have access in Project Builder to the library, you have to publish them.

  1. Select a Library in the Libraries selection area.
  2. Click Publish.
  3. The library is now available in the Project Builder to all members of your organization.

Note

You can recognize a published library by the icon which appears next to the name of the library in the selection area. Click the icon, a drop-down list is then opened. All versions of your library are listed in this drop-down list. Older published versions of your library are only available in read mode.

ClosedWithdraw publication

You can withdraw the publication of a version.

  1. In the Libraries selection area, choose a version of your library.
  2. Click Withdraw publication.
  3. The publication is withdrawn and the version of your library is no longer available to users with the role "eBUILD Project Builder" in Project Builder.

Note

After you have withdrawn the publication, you can publish the version again at any time.

ClosedRename a library

You can subsequently rename libraries already created.

  1. Select a Library in the Libraries selection area.
  2. Click Rename.
  3. The library is renamed.

ClosedDuplicate a library
  1. Select a Library in the Libraries selection area.
  2. Click Duplicate.
  3. The library is duplicated.

ClosedDelete library
  1. Select a Library in the Libraries selection area.
  2. Click Delete.
  3. The library is deleted.

ClosedDelete version
  1. In the Libraries selection area, select an unpublished version of your library.
  2. Click Delete.
  3. Confirm with Yes.
  4. The version is deleted.

ClosedArchive a library

You can export and import a library in eBUILD. This allows you to archive your data and to use them again, if required. The archive file contains all the macros and the rules that you have defined in the library. All the data are stored in compressed form. The file extension of an archive file is *.ela.

Export a library

  1. Select a Library in the Libraries selection area.
  2. Click the popup menu next to the name of the library.
  3. Click Export *.ela.
  4. The library is exported.

Note

You can also export libraries with versions. To do this, click Export with versions *.ela.

Import a library

  1. Select a Library in the Libraries selection area.
  2. Click Actions in the selection area.
  3. Click Import *.ela.
  4. Select the file to be imported.
  5. The library is imported.

Read more