Importing Exporting Project Data PDF
Importing Exporting Project Data PDF
30/72-8010-14 EN
Composer
Contents:
1 Importing and exporting data tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.1 Data import (CSV) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2 List of importable project design objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.2.1 Plant areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.2.2 Function units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.2.3 Function diagram generation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.2.4 Process points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.2.5 Process data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
1.2.6 Signals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.2.7 Utilizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.2.8 Field devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
1.2.9 Channel allocations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.2.10 Signal tags. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.2.11 Utilization tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.2.12 Connection diagrams (documents) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1.2.13 Documents (Word, Excel, HTML ...) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
1.2.14 Marshalling/distribution data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
1.2.15 Plant marshalling area plan data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
1.3 Dokument frame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
1.4 Station allocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
1.5 Data export (CSV) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
can be read.
Special Excel forms can be used to simplify data input or editing in Excel.
For flexible handling of the import process, it is possible to individual set how many header lines are to be skip-
ped during importing and which text delimiters are to be used.
The following list contains the importable project design objects, broken down according to the CSV file formats.
It has the following structure:
• CSV file format
• Project design object
• Prodos 2.11 report generator
• Function units
• Process points
• Signals
• Utilizations
• Field devices
• Excel CSV file in Prodos 2.x format
• Function units
• Process points
• Signals
• Utilizations
• Field devices
• Composer format
• Plant areas
• Function units
• Function diagram generation
• Process points
• Process data
• Signals
• Utilizations
• Field devices
• Channel allocation
• Signal tags
• Utilization tags
• Connection diagrams (documents)
• Documents (Word, Excel, HTML ...)
• Marshalling/distribution data
• Plant marshalling area plan data
All attributes of the respective project design object that can be imported by means of CSV files are described in
tabular form.
"E: 14": E=power engineering. In power engineering, up to 14 characters are available for the object designation.
"V: 12": V=process engineering. In process engineering, up to 12 characters are available for the object designa-
tion.
• Description of the CSV file formats
To be able to import data in Composer, CSV files must be created for this purpose in which the attributes of the
objects are specified in a certain order, separated by default by a semicolon. A comma or a tab stop can also be
used as the delimiter. The CSV file can be created directly by means of the editor, taking the order of attributes
into account, or with the aid of Excel forms (see chapter entitled "Excel forms").
A further possibility consists of generating the Excel template from Composer. To do this, call up the Data import
(CSV) window. Set the CSV file format and the CSV file type in the window. Generation of the template is started
in the "Options", "Generate template" menu item.
Composer format
Column: Content:
1 Plant area
2 Text
3 Order number
4 Short text
Column: Contents:
1 Text
2 not used
3 Type
4 Order number
5-7 not used
8 Remark
9 Author
10 Planner
Composer-Format:
Column: Contents:
1 Function unit
2 Type
3 Text
4 Order number
5 Short text
6 not used
7 not used
The "function diagram generation" import functions like the "Copy from..." function. This function is described in
the TI "Copying project data".
Composer format:
Column: Contents:
1 1. Process point target
2 1. Process point template
3 1. Process point target
4 1. Process point template
... ...
German English
Measurement M M
Drive A D
Processing V P
Alarm unit MA AU
Recipe R R
Column: Contents:
1 Text
2 Function unit
3 Type
4 Order number
5 not used
6 Plant area
7 not used
8 Remark
9 Author
10 Planner
11 Short text
12 Diagram
13,14 not used
15 Processing
16 Measuring range start
17 Measuring range end
18 Dimension
19 not used
20 Drive type
21,22 not used
23 Process point
Composer format:
Column: Contents:
1 Process point
2 Text
3 Type
4 Kind
5 Order number
6 Alias structure name
7 Function unit
8 Plant area
9 Diagram
10 Processing
11 Measuring range start
12 Measuring range end
13 Dimension
14 Drive type
15 Short text
16 Planner
17 Author
Column: Contents:
1 Signal
2 Text
3 High signal value
4 not used
5 Limit (percent)
6 Kind
7 Measuring range start
8 Measuring range end
9 Dimension
10 not used
11 Process point
Column: Contents:
1 not used
2 Signal tag
3 Text
4 Kind
5 High signal value
6 Low signal value
7 Limit (percent)
8 Limit (dimension)
9 "Percent/Physical" switch
10 Measuring range start
11 Measuring range end
12 Dimension
13 Alarm template
14 Archive template
15 Process point
1.2.7 Utilizations
Column: Contents:
1 Utilization
2 Text
3 Utilization value
4 not used
5 Process point
Composer format:
Column: Contents:
1 Process point
2 Utilization tag
3 Text
4 Utilization value
Column: Contents:
1 not used
2 Process item tag
3 Code number
4 not used
5 Text
6 not used
7 Mounting position
8 Slot
9 Position
10 Order number
11 not used
12 Process point
Composer format:
Column: Contents:
1 Process point
2 not used
3 Process item tag
4 Text
5 Kind
6 Code number
7 not used
8 not used
9 Location
10 Mounting position
11 Slot
Composer format:
Column: Contents:
1 Station
2 Module type
3 Location
4 Mounting position
5 Position (+.)
6 not used
7 not used
8 Channel
9 Process point
10 not used
11 Process item tag
12 Location
13 Mounting position
14 Position (+.)
15 Channel
16 I/O component
17 St-F
18 Group
Composer format:
Column: Contents:
1 Type
2 Text
3 High signal value
4 Low signal value
5 Kind
6 Signal
On importing, the text for the signal tag (Column 2) is stored for the language that is set in the Navigator! There-
fore, make sure that the desired language is set before importing.
Composer format:
Column: Contents:
1 Type
2 Text
3 Utilization value
4 Utilization
On importing, the text for the utilization tag (Column 2) is stored for the language that is set in the Navigator! The-
refore, make sure that the desired language is set before importing.
Composer format:
Composer format:
Column: Contents:
1 Document type identifier
2 Document group
3 Drawing number
4 Document title 1
5 Document title 2
6 Typ
7 Higher-level tag
8 Process item tag
9 Customer drawing number
10 Customer page number
11 Owner drawing number
12 Owner page number
13 File name
14 Path
15 Control column (D=delete assignment)
Composer format:
This format is used to import (distributor allocations (marshalling/distribution, ..). The distributor type - and thus
the definition of which data field is written to - is specified during the import operation.
Composer format:
Column: Contents:
1 Document type key
2 Drawing number
3 Page number
4 Document group
5 Text1 for sheet
6 Text2 for sheet
7 Functional Assignment
8 Upper level tag
9 Type
10 Cubicle (+)
11 Slot (+.)
12 Customer drawing number
13 Customer sheet number
14 End user document tag
15 End user page number
16 Creation Date
This import serves to create or modify station allocations. This import can also modify program allocations.
Almost all project design data that can be imported can also be re-exported as a CSV file. CSV exports are
always started from an affiliated mask. The respectively selected filter set is exported.
The following table provides information about which mask in Composer the export is started from.
Under the designations Binary Export and Binary Inport, in Composer you find a possibility of exchanging data
between various Composer projects. The word 'Binary' indicates that the exchange format is not a neutral one.
The CSV Export/Import is another possibility of exchanging data.
Version areas are the smallest elements that you can export and import. All areas that are released and which
have been commissioned can also be exported and imported in binary form. This embraces:
• System
• Island
• Station
• Task
• Cubicle
• Process point function
Plant diagrams, area and overview diagrams can also be exported in binary form although they do not exist in dif-
ferent versions (see Plant diagrams, area and overview diagarams).
All areas can only be exported and imported in the planning phase.
An area that is to be exported out of a project contains references to parts of the library and to other areas. These
references must be built up again in the target project, i.e. the area must fit into the target project. Therefore,
• data can only be exchanged between projects with the same Composer version
• the libraries in the source and target projects must be at the same level
• higher-level areas in the hierarchy must exist in the destination project before a subordinate area can be
imported.
The sequence when importing is also important wherever there are no hierarchical relationships. To ensure that
a function diagram with program and channel allocations can be imported, the station must be available with
modules and task in the target as otherwise the function diagram will be imported without program and channel
allocations. In the case of the station delivery batch import/export function (see Delivery batches), the correct
sequence is specified automatically. Otherwise, the following sequence is recommended:
• System
• Island
• Station
• Task
• Process point function
The following mask is used for importing and exporting; the layout only differs with respect to the title (Import or
Export).
A The directory to which the export files are written or from which the import files
are read is selected in this window.
B Here, data from the project is displayed, i.e. the area that is to be exported or
which has been imported.
C Here, all areas that are in the selected directory as files are displayed.
In the top (Composer) and bottom windows (data medium) the respective actions are called up by way of the
context menu. The entries in the window sections can be selected or cancelled by clicking the button.
In the Composer window, the name, version, version number and change date are entered for each element. In
the Data medium window, you also see the export date, the export ID (see Procedure) and the name of the
export file.
2.3.2 Call
The mask for exporting and importing is called up via the Binary Export and Binary Import menu items from the
tools for editing the respective areas:
• from the masks for editing systems, islands, stations, tasks, cubicles, plant identifiers and function identifiers.
• from the Function and System overviews
• from the function diagram editor and the editor for plant diagrams, area and overview diagrams
The import mask only shows the areas in the Data medium window whose type is defined in the call:
In the Station mask, there are also the Export delivery batch and Import delivery batch calls (see Delivery bat-
ches). For plant diagrams, area and overview diagrams there are the Export hierarchy and Import hierarchy calls
(see Plant diagrams, area and overview diagrams).
Errors that occur during exporting and importing and some items of information are displayed in a message box.
An import error prevents importing of area. In the event of a severe error, the complete import operation is ended.
This is the case, for example, if a storage error occurs. If normal errors occur, the import operation is continued
with the next area.
Information is displayed whenever an area has been imported, but not with all information (see also Handling
exceptions when importing), for example:
• A function diagram has been imported without channel allocations or without a task allocation.
• It has not been possible to re-establish the bus allocation for an imported station.
2.4.1 Procedure
To transfer larger portions of a project to another project, users must export and import the affiliated areas. The
Export delivery batch and Import delivery batch functions simplify this for partial deliveries. A delivery batch con-
sists of a station, all affiliated P cards, tasks and the function diagrams that are linked to the station by way of
channel or program allocation.
The procedure for exporting and importing a delivery batch scarely differs from normal exporting and importing:
• In the Station mask or overview, a station is selected and the import mask is called up by selection of the
Export delivery batch menu item.
• In the Composer window, all parts of the delivery batch are displayed, and the elements are all selected and
must be exported together to ensure that they are given the same export ID (visible in the Data medium
window). During importing, the parts belonging to the delivery batch are determined via the export ID.
• The directory containing all files of the delivery batch is transferred to the target system.
• The import mask is called up via the Import delivery batch menu item from the Station mask and the directory
of the export files is selected.
• All parts of the delivery batch appear in the Data medium window and can be imported via the context menu.
The same conditions apply to delivery batches as to individual areas. Exporting and importing takes place in the
planning phase. Higher-level areas, in this case the island to which the station belongs, must exist with the same
name as in the source project.
The first delivery batch is created in the actual project and goes with it to the construction site. Further delivery
batches are created in a copy of the project and are then incorporated into the project on the site by way of
exporting and importing of a delivery batch. Initialisation and repeated loading of Melody is necessary for the new
delivery batch.
2.4.2 Recommendations
The following procedure is recommended if it is planned to handle a project in delivery batches from the very
onset:
• First create a project and define it as the project master.
• In the project master, enter the system structure of the overall project in relation to CMC, CCC, and CCO.
• Release and commission systems, islands and all stations.
• As early as possible, make all project-specific changes to the library, for example project-specific macros, in
the project master.
• Edit delivery batch 1 in the project master. Create a copy of the project master (subproject) for the further
delivery batches.
• Changes to the system structure must always also be made within the project master. They can then be
exported/imported to a subproject. Changes within a station (number of P cards) can be made in the
subproject.
It goes without saying that it is possible to deviate from this procedure and, in some cases, this cannot be avo-
ided either. This may be the case if the system structure is later expanded by further stations. This is then done in
a copy of the project at the project design location and additional steps are necessary:
• To ensure that a new station can be set to the operation status in the project copy, the existing stations in
operation must be set to unlinked in Composer because the project hardware is not available here. In this
respect, authors depend on service support.
• In additonal to importing the delivery batch, it may be necessary to place the station in the cubicle layout
diagram, or the cubicle layout diagram also has to exported and imported (see Cubicle layout diagrams).
Plant diagrams, area and overview diagrams can be exported and imported by way of Binary Export and Binary
Import. The functions can be called up from the editors for the plant diagram, area or overview diagram and from
the plant identifier and function identifier masks.
Other plant identifiers or function identifiers and process points, signals and utilisations can be entered in these
diagrams. The diagrams are exported with all information that is needed for them to look exactly the same in the
target project as in the source project. If some displayed elements do not exist in the target project, they are crea-
ted with the displayed information (e.g. process points). However, the displayed elements are not also exported
completely.
Plant diagrams, area and overview diagrams can be arranged hierarchically. When a diagram is imported, the
higher-level area must exist.
By means of the Export Hierarchy function, an area including all subordinate areas can be exported and impor-
ted. Similarly to the delivery batch export, the areas exported together are assigned the same identifier (export
ID) and are imported in the correct order by way of the Hierarchy Import.
Just like other versioned areas, a cubicle layout diagram can be exported by means of Binary Export and can be
imported by means of Binary Import. However, the modules displayed in the diagram belong to separate areas
(islands or stations) and are not also exported when the cubicle layout diagram is exported.
When a layout diagram is imported, an attempt is made to restore the allocations from the source project. If the
modules exist in the target project, they are displayed in the imported diagram. Equally, when a station is impor-
ted, an attempt is made to restore the allocations from the source project. Therefore, in most cases there is no
need to export the layout diagram and to import it in order to get the cubicle layout. Only in cases where the
cubicle does not exist in the target project does it have to be exported and imported together with the station.
Subject to technical changes Printed in the Fed. Rep. of Germany 30/72-8010-14 EN 10/1999 ABB