Etap - Spel Interface

ETAP - SmartPlant Electrical Bidirectional Interface
Page 1 of 9

The ETAP - SmartPlant Electrical interface allows you to import ETAP data to SmartPlant Electrical and export
data to ETAP. When exporting data to ETAP you can publish single electrical analysis SLDs or a complete set of
all the existing electrical analysis SLDs in one set. When retrieving ETAP data, you can retrieve a particular
ETAP one-line diagram or publish all project data to SmartPlant Electrical. (Note that this is an ETAP feature and
the setting is defined in ETAP.)
The interface is based on a fixed mapping file that is shipped with SmartPlant Electrical. This file determines the
mapping between the ETAP elements and various equipment types in SmartPlant Electrical. ETAP users cannot
modify the mapping of ETAP elements to SPEL item types. However, it is possible to change the mapping of the
properties in both SmartPlant Electrical and ETAP and change the direction of the data propagation between the
two applications.
Note the following limitations regarding publishing and retrieving parallel connections:
It is not possible to publish to ETAP electrical items that are connected in parallel. These items will not
be published at all.
When retrieving electrical items that are connected in parallel from ETAP, the software creates a new
bus in SmartPlant Electrical and connects these items to this bus using a non-parallel connection.
When publishing junction boxes from SmartPlant Electrical to ETAP, ETAP retrieves these items as bus
nodes. When publishing these bus nodes back to SmartPlant Electrical, the software identifies them as
junction boxes. Note that the software disregards any existing circuits in the junction boxes and publishes
them as black boxes.
Top of Page
ETAP - SmartPlant Electrical Mapped Items

SmartPlant Electrical is shipped with a fixed default mapping of ETAP elements and SmartPlant Electrical
equipment. The table below shows this default mapping.
Note that in cases where the mapping is "many-to-one", you must define the type by specifying the identifier that
you select from the Equipment Type Identifier select list (shown here in parentheses).
ETAP Element
SmartPlant Electrical Equipment
Bus
Bus
Cable
Cable
Capacitor
Capacitor
Charger
Battery charger
Contractor (ContractorType =
Contractor)
Contractor
Contractor (ContractorType = Starter)
Starter
Current transformer
Current transformer
Fuse
Fuse
HVCB
Circuit breaker / High Voltage CB
In-line overload relay
Overload relay (In-line overload relay)
Induction motor
Generator (Induction Generator)
Lumped load
Other electrical equipment (Lumped load)
file://C:\Documents and Settings\miguel.garcia.INELECTRA-NA\Local Settings\Temp\~... 18/03/2014
LVCB
Circuit breaker / Low Voltage CB
Motorized valve
Motor
Overload heater
Overload relay
Power grid
OffSite power
Reactor
Current limiting reactor
Recloser
Circuit breaker (recloser)
Single through switch
Disconnect switch
Static load (Load type = Resistor)
Resistor
Static load (Load type = Heater)
Heater
Static load (Load type = Trace)
Heat trace
Static load (Load type = Lighting)
Lighting fixture
Static load (Load type = Socket outlet)
Socket outlet
Page 2 of 9
Static load (Load type = Welding outlet) Welding outlet

Static load (Load type = Cabinet)
Cabinet
Static load (Load type = Instrument)
Instrument
Synchronous motor
Motor
SyncGenerator
Generator
Three-winding transformer
Three-winding transformer
Two-winding transformer
Two-winding transformer
Variable frequency drive
Variable frequency drive
Unsupported Items
A number of items are not supported by the ETAP - SmartPlant Electrical interface. Publishing an unsupported
item can have the following possible results:
Items could be skipped or ignored in the importing application. After exporting these items back to the
original application, they may be deleted or become disconnected or dissociated from their related items.
Inability to synchronize or update data.
Unexpected behavior.
Unsupported ETAP Items

The following ETAP items are not supported by the ETAP - SmartPlant Electrical interface:
Instrumentation
DC systems
Multi-function relays
Single-phase systems
Wind turbine generator
Transmission lines
MG sets
SVC
HVDC
Double through switches
Panels
Potential transformers
Inverters
Page 3 of 9
Unsupported SmartPlant Electrical Items

The following SmartPlant Electrical items are not supported by the ETAP - SmartPlant Electrical interface:
Junction boxes
When publishing junction boxes from SmartPlant Electrical to ETAP, ETAP retrieves these items as bus
nodes. When publishing these bus nodes back to SmartPlant Electrical, the software identifies them as
junction boxes. Note that the software disregards any existing circuits in the junction boxes and
publishes them as black boxes.
Local panels
Metering equipment (except for current transformers)
DC items
Single phase items
Other disconnect equipment
Potential transformers
Other converting equipment
Control stations (not exported at all)
Circuits (not exported at all)
Cells (not exported at all)
Power distribution boards (not exported at all)
Top of Page
Preliminary Settings for ETAP

Prior to importing ETAP data or exporting SmartPlant Electrical data to ETAP, you have to define a number of
settings in SmartPlant Electrical Options Manager:
Define the ETAP Project Name
Map ETAP File Location
Import ETAP Mapping Data
Set the ETAP-SPEL Reference Cable Exchange File Location
Export SmartPlant Electrical Reference Cables (Power Cables)
Export SmartPlant Electrical Reference Cables (Cable Specifications)
Import ETAP Library Cables
Top of Page
Define the ETAP Project Name

Prior to working with the ETAP - SmartPlant Electrical interface, you have to define the name of the ETAP project
exactly as it appears in ETAP.
1. In Options Manager, click Options > General Settings.
2. In the General Settings window, to the right of Project name in external analyzing software type the
exact name of the project as it appears in ETAP.
3. Click Save
Page 4 of 9
Top of Page
Map ETAP File Location

The mapping of SmartPlant Electrical item properties to ETAP item types is done in ETAP Mapping Table. This
information is stored in ETAP in an .mdb file and converted by SmartPlant Electrical to an .xml file called
ETAPSPELMapping.xml. SmartPlant Electrical provides a default .xml file and you can change its default
location if needed.
1. In Options Manager, click Options > Locations.
2. In the Locations window, to the left of the ETAP SmartPlant Electrical mapping file click the ellipsis
button .
3. Navigate to the ETAPSPELMapping.xml file.
4. Click Save
Top of Page
Import ETAP Mapping Data

One of the first things that you should do is to synchronize the mapping table of a specific ETAP project with the
SmartPlant Electrical mapping file. SmartPlant Electrical always checks the compatibility of the mapping file
when importing data from ETAP. In case of version inconsistency, a warning message is displayed asking to
import the latest mapping file from ETAP.
1. In Options Manager, click Interfaces > ETAP > Build Mapping XML.
2. On the Build Mapping XML dialog box, navigate to the appropriate mapping .mdb file and click Open.
This .mdb file is located in the ETAP home directory, under the specific project library > DataEx_SPEL.
SmartPlant Electrical converts this .mdb file to ETAPSPELMapping.xml and overwrites the file in the
location specified in Option Manager under ETAP - SmartPlant Electrical mapping file location.
Top of Page
Set the ETAP-SPEL Reference Cable Exchange File Location

SmartPlant Electrical and ETAP can exchange reference cable information so that cable libraries become
synchronized. SmartPlant Electrical provides a default exchange .mdb file and you can use it or modify it as you
see fit. The default location of this file is also set automatically in Options Manager in the SmartPlant Electrical
reference data library, under ETAP. However, you can change this location if required.
1. In Options Manager, click Options > Locations.
2. In the Locations window, to the left of the ETAP - SPEL reference cable exchange file click the ellipsis
button .
3. Do one of the following:
Navigate to the shipped default mdb file in the following location:

Program Files\SmartPlant\Electrical Reference Data\ETAP\ETAPSPELCableLib.mdb
Navigate to an appropriate .mdb file of your choice.
4. Click Save
Top of Page
Export SmartPlant Electrical Reference Cables (Power Cables)

You can synchronize the SmartPlant Electrical reference cables with the ETAP cable library of a particular ETAP
project if you want to have a commonly shared cable library. This synchronization is optional. If you do not
Page 5 of 9
synchronize the libraries, both applications function independently of the cable library of the other application.
However, if you synchronize the cable libraries, each application will identify the reference cables that were
specified by the other application.
To effect this synchronization, you need to export your reference cables to ETAP and import ETAP library cables
to SmartPlant Electrical. The following procedure explains how to export your reference cables by selecting the
reference power cables from the entire list of all the existing reference power cables.
1. On the Options Manager menu bar, click Interface > ETAP > Export Reference Cables.
2. On the Reference Power Cable Selection Method page of the Export SmartPlant Electrical Reference
Cables wizard, select the All power cables option.
3. Click Next.
4. On the Reference Cable Selection page, select the reference power cables that you want to export.
5. Click Finish.
The software exports the reference cables to the cable library file that you specified in Options Manager and
appends the new cables to the list of the existing cables in that library.
If you export reference cables that already exist in the cable library, the software ignores the cables that
have identical properties. The software exports only those cables whose properties differ from the cables
that already exist.
There are certain cable properties that must be defined for the reference cables prior to exporting them.
These properties form the ETAP cable headers and they are all mandatory for ETAP. In addition to the
properties required by SmartPlant Electrical to form reference cables, you must define other properties that
form the ETAP cable headers. Any reference cable that lacks even one of these property definitions is
rejected by the software after the export process. The following properties must be defined before starting
export:
Conductor Material
Frequency
Base Temperature
Installation
Insulation Material
Insulation Voltage Rating
kV Class
Length Unit of Measure
Number of Conductors
Source Name
Ta Base Above Ground
Ta Base Under Ground
Tc Base Above Ground
Tc Base Under Ground
Unit System
RHO
If you want to use SmartPlant Electrical cables in ETAP, you have to define all the electrical properties that
are required by ETAP. We recommend that you specify a distinct "source name" for these cables so that
they do not interfere with or override ETAP original library cables.
Top of Page
Export SmartPlant Electrical Reference Cables (Cable Specifications)
Page 6 of 9
To effect this synchronization, you need to export your reference cables to ETAP and import ETAP library
cables. This procedure explains how to export your reference cables by selecting particular cable specifications.
1. On the Options Manager menu bar, click Interface > ETAP > Export Reference Cables.
2. On the Reference Power Cable Selection Method page of the Export SmartPlant Electrical Reference
Cables wizard, click the Power cables with selected cable specifications option.
3. Under Cable specifications, select the appropriate specifications and click Add.
After clicking Next, the software will display a list of reference power cables that have the cable
specifications you select on this page.
4. Click Next.
5. On the Reference Cable Selection page, select the reference cables that you need.
6. Click Finish.
The software exports the reference cables to the cable library file that you specified in Options Manager and
appends the new cables to the list of the existing cables in that library.
If you export reference cables that already exist in the cable library, the software overwrites the old cables
with the newly exported cables.
There are certain cable properties that must be defined for the reference cables prior to exporting them.
These properties form the ETAP cable headers and they are all mandatory for ETAP. In addition to the
properties required by SmartPlant Electrical to form reference cables, you must define other properties that
form the ETAP cable headers. Any reference cable that lacks even one of these property definitions is
rejected by the software after the export process. The following properties must be defined before starting
export:
Conductor Material
Frequency
Base Temperature
Installation
Insulation Material
Insulation Voltage Rating
kV Class
Length Unit of Measure
Number of Conductors
Source Name
Ta Base Above Ground
Ta Base Under Ground
Tc Base Above Ground
Tc Base Under Ground
Unit System
RHO
If you want to use SmartPlant Electrical cables in ETAP, you have to define all the electrical properties that
are required by ETAP. We recommend that you specify a distinct "source name" for these cables so that
Page 7 of 9
they do not interfere with or override ETAP original library cables.

Top of Page
Import ETAP Library Cables

To effect this synchronization, you need to import ETAP library cables and export your reference cables to
ETAP. This procedure explains how to import ETAP library cables.
ETAP exports project library cables to an .mdb file which is then used by SmartPlant Electrical to effect
the import.
1. On the Options Manager menu bar, click Interface > ETAP > Import Reference Cables.
2. On the Import ETAP Library Cables dialog box, click
ETAP library cables.
and navigate to an ETAP .mdb file that contains
3. Under Cable details, select the required cables, click Update Cable Specifications.
You must specify an appropriate cable specification for each ETAP library cable before you import the
cables to SmartPlant Electrical.
Make sure that before you start the import process, all the source names of the ETAP library cables that
you want to import have been added to the Source name select list in the Data Dictionary.
4. On the Cable Specification dialog box, do one of the following:
Click the Select check box next to the cables that you want to import.
Click Select all to select all the cables in the Cable details data window.
5. Click OK to start the import process.

Top of Page
Publish a Single SLD Drawing to ETAP (Partial Publishing)

SmartPlant Electrical publishes single line diagrams to ETAP using electrical analysis SLDs. After generating an
electrical analysis SLD and saving it, ETAP will use its XML as the source for import.
Note that publishing a single SLD to ETAP is called partial publishing. The XML that you create by saving the
SLD has this partial identifier. As a result, in ETAP there will be no indication of deleted items after importing
partial SLDs. To indicate that certain items have been deleted in SmartPlant Electrical, use the full publishing
method.
1. In SmartPlant Electrical, in the Electrical Engineer, select an appropriate item for which you want to
generate an electrical analysis SLD.
The item can be on any hierarchy level in the Electrical Engineer, for example a bus.
2. Right-click the item that you selected and then on the shortcut menu, click New SLD.
3. On the Single Line Diagram Options dialog box, in the SLD type group box, select Electrical analysis
SLD.
4. Click Generate.
5. Save the drawing.
6. In the Electrical Index, expand the Documents > Electrical Analysis SLDs hierarchy.
If you want to publish an existing SLD and make sure that you retain all the changes made
Page 8 of 9
since the last time it was published, you must open this SLD and save it prior to publishing. If you do not do
that, the software will publish the updated items with inappropriate coordinates. As a result, ETAP will
position these SLD items in inappropriate places on ETAP drawings.
7. Right-click the new SLD drawing and then on the shortcut menu, click Publish to External Analyzing Tool.
8. On the Publish to External Analyzing Tool dialog box, save the drawing as an .xml file, which will be used
by ETAP as an import source.
Top of Page
Publish All Plant SLDs to ETAP (Full Publishing)

SmartPlant Electrical publishes single line diagrams to ETAP using electrical analysis SLDs. After generating an
electrical analysis SLD and saving it, ETAP will use its XML as the source for import.
Full publishing of SLDs to ETAP is when you publish all the existing electrical analysis SLDs in a single set of
drawings. This set is identified as the complete SLD of the plant and it includes all plant items that constitute the
electrical analysis SLDs.
The full publishing method enables you to create an indication in ETAP of items that have been deleted in
SmartPlant Electrical. When ETAP imports a full xml, the software compares the items that are included in the
current session with the existing project as stored in the ETAP database and deletes all the items that are not
found in the full xml that was used for import.
The data transfer between SmartPlant Electrical and ETAP is based on the mapping table. Only those
properties that have been mapped with the appropriate mapping direction are propagated from SmartPlant
Electrical to ETAP. For more details, see ETAP - SmartPlant Electrical Mapped Items.
If you want to publish existing SLDs and make sure that you retain all the changes made since the last time
these SLDs were published, you must open each SLD and save it prior to publishing. If you do not do that,
the software will publish the updated items with inappropriate coordinates. As a result, ETAP will position
these SLD items in inappropriate places on ETAP drawings.
1. On the SmartPlant Electrical menu bar, click Tools > ETAP Interface > Publish All.
2. On the Publish to External Analyzing Tool dialog box, save the file as an .xml file, which will be used by
ETAP as an import source.
Top of Page
Retrieve ETAP Project Data

ETAP exports its project data in XML format. ETAP users can select all the project data or specific items (see the
documentation in ETAP on how to make this selection).
In order to preserve the electrical associations that exist in ETAP, before publishing to SmartPlant
Electrical, make sure that all the relevant electrical items are connected to a power source in ETAP. The power
source items themselves, however, need not be included in the publish.
1. On the SmartPlant Electrical menu bar, click Tools > ETAP Interface > Retrieve.
2. Navigate to the appropriate ETAP project .xml file and click Open.
The retrieve process starts only if the ETAP project name specified in the selected .xml file is the one
specified in Options Manager. If the project name specified in Options Manager is different from the one
in the selected .xml file, the software rejects the retrieval and displays a warning message.
The software checks the mapping table revision number, which is also part of the ETAP project .xml file.
If the mapping has been modified in ETAP and no new mapping has been done, the software displays a
warning. You can continue the retrieval if you want to do so.
Once the retrieve is completed, it results in a To Do List action similar to the one used in SmartPlant
Electrical in integration. You can examine each task before committing the whole action list to your
Page 9 of 9
SmartPlant Electrical database.

3. On the SmartPlant Electrical menu bar, click SmartPlant > To Do List.
4. In the To Do List window, double-click a task to check what data is going to be populated in your database.
The following types of task can appear in the To Do List:
Create New items will be created in SmartPlant Electrical if the items are totally new in SmartPlant
Electrical. A new item in SmartPlant Electrical is an item that the software cannot identify by its
SmartPlant Electrical ID (SP_ID), ETAP IID, or SmartPlant Electrical item tag. Note that if the retrieved
item is a disconnect equipment item, the software does not check for the item tag property.
Update Existing items will be updated if SmartPlant Electrical can identify them by one of the
properties mentioned above.
Delete Items deleted in ETAP will be deleted in SmartPlant Electrical. Note that this type of task is
only possible when performing a Full Retrieve from ETAP.
5. Select the tasks you want to run and click Run
Top of Page

Etap - Spel Interface

Încărcat de

Informații document

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

Etap - Spel Interface

Încărcat de

Drepturi de autor:

Formate disponibile

ETAP - SmartPlant Electrical Bidirectional Interface

ETAP - SmartPlant Electrical Bidirectional Interface

ETAP - SmartPlant Electrical Mapped Items

SmartPlant Electrical Equipment

Contractor (ContractorType = Starter)

Circuit breaker / High Voltage CB

In-line overload relay

Overload relay (In-line overload relay)

Generator (Induction Generator)

Other electrical equipment (Lumped load)

file://C:\Documents and Settings\miguel.garcia.INELECTRA-NA\Local Settings\Temp\~... 18/03/2014

ETAP - SmartPlant Electrical Bidirectional Interface

Circuit breaker / Low Voltage CB

Current limiting reactor

Circuit breaker (recloser)

Single through switch

Static load (Load type = Resistor)

Static load (Load type = Heater)

Static load (Load type = Trace)

Static load (Load type = Lighting)

Static load (Load type = Socket outlet)

Static load (Load type = Welding outlet) Welding outlet

Static load (Load type = Instrument)

Variable frequency drive

Variable frequency drive

Inability to synchronize or update data.

Unsupported ETAP Items

Wind turbine generator

Double through switches

file://C:\Documents and Settings\miguel.garcia.INELECTRA-NA\Local Settings\Temp\~... 18/03/2014

ETAP - SmartPlant Electrical Bidirectional Interface

Unsupported SmartPlant Electrical Items

Metering equipment (except for current transformers)

Single phase items

Other disconnect equipment

Other converting equipment

Control stations (not exported at all)

Circuits (not exported at all)

Cells (not exported at all)

Power distribution boards (not exported at all)

Preliminary Settings for ETAP

Define the ETAP Project Name

Map ETAP File Location

Import ETAP Mapping Data

Set the ETAP-SPEL Reference Cable Exchange File Location

Export SmartPlant Electrical Reference Cables (Power Cables)

Export SmartPlant Electrical Reference Cables (Cable Specifications)

Import ETAP Library Cables

Define the ETAP Project Name

file://C:\Documents and Settings\miguel.garcia.INELECTRA-NA\Local Settings\Temp\~... 18/03/2014

ETAP - SmartPlant Electrical Bidirectional Interface

Map ETAP File Location

Import ETAP Mapping Data

Set the ETAP-SPEL Reference Cable Exchange File Location

Navigate to the shipped default mdb file in the following location:

Navigate to an appropriate .mdb file of your choice.

Export SmartPlant Electrical Reference Cables (Power Cables)

file://C:\Documents and Settings\miguel.garcia.INELECTRA-NA\Local Settings\Temp\~... 18/03/2014

ETAP - SmartPlant Electrical Bidirectional Interface

Insulation Voltage Rating

Length Unit of Measure

Ta Base Above Ground

Ta Base Under Ground

Tc Base Above Ground