Automated project update

EPLAN Platform Version 2.7

Last update: 04 / 2017

EPLAN Software & Service GmbH & Co. KG

Technical Information
Automated project update
EPLAN Platform Version 2.7
Last update: 04 / 2017

Copyright © 2017 EPLAN Software & Service GmbH & Co. KG

EPLAN Software & Service GmbH & Co. KG assumes no liability for either technical or printing errors,
or for deficiencies in this technical information and cannot be held liable for damages that may result
directly or indirectly from the delivery, performance, and use of this material.
This document contains legally protected proprietary information that is subject to copyright. All rights
are protected. This document or parts of this document may not be copied or reproduced by any other
means without the prior consent of EPLAN Software & Service GmbH & Co. KG.
The software described in this document is subject to a licensing agreement. The use and reproduc-
tion of the software is only permitted within the framework of this agreement.
RITTAL® is a registered trademark of Rittal GmbH & Co. KG.
EPLAN®, EPLAN Electric P8®, EPLAN Fluid®, EPLAN Preplanning®, EPLAN PPE®, EPLAN Pro
Panel®, EPLAN Smart Wiring® and EPLAN Harness proD® are registered trademarks of EPLAN Soft-
ware & Service GmbH & Co. KG.
Windows 7®, Windows 8®, Windows 8.1®, Windows 10®, Windows Server 2008 R2®, Windows Server
2012®, Windows Server 2012 R2 ®, Microsoft Windows®, Microsoft® Excel®, Microsoft® Access® and
Notepad® are registered trademarks of the Microsoft Corporation.
PC WORX®, CLIP PROJECT®, and INTERBUS® are registered trademarks of Phoenix Contact GmbH
& Co.
AutoCAD® and AutoCAD Inventor® are registered trademarks of Autodesk, Inc.
STEP 7®, SIMATIC® and SIMATIC HW Konfig ® are registered trademarks of Siemens AG.
InstallShield® is a registered trademark of InstallShield, Inc.
Adobe® Reader® and Adobe® Acrobat® are registered trademarks of Adobe Systems Inc.
TwinCAT® is a registered trademark of Beckhoff Automation GmbH.
Unity Pro® is a registered trademark of Schneider Electric.
RSLogix 5000® and RSLogix Architect® are registered trademarks of Rockwell Automation.
All other product names and trade names are trademarks or registered trademarks of their respective
owners.
EPLAN uses the Open Source software 7-Zip (7z.dll), Version 16.00, Copyright © by Igor Pavlov. The
source code of 7-Zip is subject to the GNU Lesser General Public License (LGPL). The source code of
7-Zip and details on this license can be found on the following Web site: http://www.7-zip.org
EPLAN uses the Open Source software Open CASCADE, Version 7.1.0, Copyright © by Open
CASCADE S.A.S. The source code of Open CASCADE is subject to the Open CASCADE Technology
Public License. The source code of Open CASCADE and details on this license can be found on the
following Web site: http://www.opencascade.org
EPLAN provides an import function which uses eCl@ss. Usage of the eCl@ss standard is subject to
license and requires registration and ordering in the DownloadPortal: http://www.eclassdownload.com
EPLAN uses the dotNetRDF © library: http://www.dotnetrdf.org, Copyright (c) 2009-2013 dotNetRDF
Project (dotnetrdf-develop@lists.sf.net). The source code is subject to the MIT license: https://open-
source.org/licenses/MIT
EPLAN uses Google Chromium ©, Version 51. https://www.chromium.org, Copyright © 2012 The
Chromium Authors. The source code is subject to the BSD license.

2
 Automated project update
EPLAN Platform Version 2.7
Last update: 04 / 2017

EPLAN uses the Chromium Embedded Framework ©, Version 2704. https://bitbucket.org/chromi-

umembedded/cef, Copyright © 2008-2014 Marshall A. Greenblatt. Portions Copyright © 2006-2009
Google Inc. The source code is subject to the BSD license.
EPLAN uses CEFSharp ©, Version 51. https://cefsharp.github.io, Copyright © 2010-2016 The
CefSharp Authors. The source code is subject to the BSD license.
EPLAN uses Microsoft Unity ©, Version 4.0.1. https://github.com/unitycontainer/unity, Copyright © Mi-
crosoft. The source code is subject to the Apache license, Version 2.0.
The complete license text of the Open Source licenses is available under:
<Installation directory>\bin\License.txt

3
Automated project update
EPLAN Platform Version 2.7
Last update: 04 / 2017

Automated project update

In the following, we will outline information about the topics of opening
and importing projects with EPLAN Platform 2.7.

When opening an editable project from an older version of EPLAN Plat-

form a prompt with regards to transferring the project data will display.
This function will allow you, as usual, to import individual projects directly
into Version 2.7. Only the selection "Yes" will allow you to edit the project
in Version 2.7 after the import. In that case, the project databases will be
updated to the level of Version 2.7. Furthermore, unless a data backup
(*.zw1) is not restored, a backup at the level of the original EPLAN Plat-
form version will be created to back up the data.

What are my options for automating the transfer of several projects at the
same time?
The functions, mentioned in this document, give you the option of auto-
matically importing edited EPLAN Project documents (starting with Ver-
sion 2.1) into EPLAN Version 2.7 via the Project Management or with a
script function. These functions make it possible to transfer entire direc-
tories and thereby support you during your migration to the current
EPLAN Platform. The imported projects will then be directly available to
you for editing. We use the example of EPLAN Electric P8 on the follow-
ing pages to demonstrate the procedure for both available paths.

Which versions can open projects created in EPLAN Platform 2.7?

Projects can be opened with EPLAN Version 2.7 only.

Which projects can be open with the EPLAN viewer 2.7?

The EPLAN Viewer 2.7 is only able to open projects from Version 2.7 di-
rectly. The project data has to be imported ahead of time for projects
from older versions of EPLAN Platform.

4
 Automated project update
EPLAN Platform Version 2.7
Last update: 04 / 2017

Project Management procedure

Set up automated processing
1. Start EPLAN Electric P8 2.7 and open any project from Version 2.7.
2. Select the menu items Utilities > Automated processing.
3. In the Run: Automated processing dialog, click the […] button at
the scheme.
4. Create a new scheme using the New button and add the action
Optimize project database to this scheme.

5. Save the newly created scheme with the [Save] button.

5
Automated project update
EPLAN Platform Version 2.7
Last update: 04 / 2017

Executing the transfer

1. Click on Project > Management in the menu bar …

2. Select one or more projects to be transferred.

3. Click [Organize] and select the entry Automated Processing…

4. Select the previously created scheme with the action Optimize pro-
ject database.
5. Confirm the Run: Automated processing dialog with [OK].
 Transfer of the selected project is started.

Note:
A backup file is created for each transferred project.
Version 2.7 projects will no longer be able to be opened with versions
lower than EPLAN Platform 2.7.

6
 Automated project update
EPLAN Platform Version 2.7
Last update: 04 / 2017

Script Function procedure

Load the scripts

1. Start EPLAN Electric P8 2.7.
2. Select the menu items Utilities > Scripts > Load....
3. In the Script file selection dialog, select the file
ESS_UpdateProjectsToPlatform2x.cs and confirm the selec-
tion with [Open].
 In the Utilities programs locate the menu item Update Projects.

Executing the transfer

4. Click on Utilities > Update projects in the menu bar.

5. Select the directory where the projects to be transferred are located

in the Browse for folder dialog and click [OK].

6. In the Upgrade projects… dialog, your directory selection will be

displayed. Confirm this dialog with [Yes] to start the transfer, or with
[No] to interrupt the function.
 Transfer of the projects created in the selected directory is started.

Note:
A backup file is created for each transferred project.
All projects in the selected directory and their subdirectories are trans-
ferred into the Version 2.7.
Version 2.7 projects will no longer be able to be opened with versions
lower than EPLAN Platform 2.7.

7
Automated project update
EPLAN Platform Version 2.7
Last update: 04 / 2017

Optionally available callup switch

The function used in the previously mentioned script: XprjActionUp-

gradeProjects will present the callup switch as mentioned in the fol-
lowing text. Well-versed EPLAN users may be able to use this to create
their own scripts.

NoBackup
When using this switch, no data backup of the projects to be transferred
takes place.

/NoBackup:true

Note:
Users are responsible for creating their own data backup for the projects!

8
 Automated project update
EPLAN Platform Version 2.7
Last update: 04 / 2017

EPLAN Software & Service GmbH & Co. KG

An der alten Ziegelei 2
40789 Monheim am Rhein · Germany
Phone: +49 (0) 21 73 / 39 64-0
Fax: +49 (0) 21 73 / 39 64-25
info@eplan.help · www.eplan.de/en