This function allows you to export Group Addresses for the purpose of editing them externally (and subsequently re-importing them into ETS) or for import into other tools. When exporting, you can select either XML or CSV format.
Procedure
- Right click on the 'Group Address' item on the object tree list and select 'Import Group Addresses'
![ExportGroupAddresses.png](/hc/article_attachments/360004810300/ExportGroupAddresses.png)
XML Format
The output format is similar to the ETS4/5 XML project format and it is easy to edit because only the data related to the Group Address structure are included. Therefore, no other settings need to be made for the export.
- If at least one Datapoint Type is assigned directly to a Group Address, it is shown as the last item in the Datapoint Type structure. The 1..n Datapoint Types that are assigned to a Group Object (if there are any) are shown before it.
- The XML, ETS4 format does not contain any Datapoint Types="..." Sequence (on Group Address/Group Object) and no Group Address description field to ensure ETS4 compatibility.
- The XML-based format can be opened with a text or XML editor, e.g. Microsoft Excel® (XML import function).
3-Level Group Address Style
...
<GroupRange Name="Main Group" RangeStart="1" RangeEnd="2047">
<GroupRange Name="Middle Group" RangeStart="1" RangeEnd="255">
<GroupAddress Name="My Group Address 1" Address="0/0/1" Central="true" Unfiltered="true" Description="My Description" DPTs="DPST-1-1,DPST-1-6" />
<GroupAddress Name="My Group Address 1" Address="0/0/2" />
</GroupRange>
</GroupRange>
...
2-Level Group Address Style
...
<GroupRange Name="Main Group" RangeStart="1" RangeEnd="2047">
<GroupAddress Name="My Group Address 1" Address="0/1" Central="true" Unfiltered="true" Description="My Description" DPTs="DPST-1-1,DPST-1-6" />
<GroupAddress Name="My Group Address 1" Address="0/2" />
</GroupRange>
</GroupRange>
...
Free-Level Group Address Style (4-level)
...
<GroupRange Name="Level 1" RangeStart="1" RangeEnd="2047">
<GroupRange Name="Level 2" RangeStart="2" RangeEnd="512">
<GroupRange Name="Level 3" RangeStart="3" RangeEnd="129">
<GroupRange Name="Level 4" RangeStart="3" RangeEnd="33">
<GroupAddress Name="My Group Address 1" Address="3" Central="true" Unfiltered="true" Description="My Description" DPTs="DPST-1-1,DPST-1-6"/>
</GroupRange>
</GroupRange>
</GroupRange>
</GroupRange>
...
CSV Format
The output format is a pure text format and the actual values are written between quotation marks ("). The following settings can be made
- The separator for the items can be a tab, comma or semicolon.
- The 'Export with header line' option adds an extra line to the output file (for columns, see Group Address Style).
- The format CSV, ETS3 format does not contain any DPTs="..." Sequence (on Group Address/Group Object) and no GA description field to ensure ETS3 compatibility (not ETS4; XML can be used there).
The CSV export is not possible when the Group Address style used in the project is 'Free'. In this case only XML export is available, as it's not possible to model the 'Free level' Group Address structure to a CSV export.
Format 3/1
4 columns
Example* (Items separated by ";" and "Export with header line" included).
|
"Main" |
;"Middle" |
;"Sub" |
;"Address" |
"Main Group" |
; |
; |
;"0/-/-" |
|
;"Middle Group" |
; |
;"0/0/-" |
|
; |
;"My GA" |
;"0/0/1" |
Format 1/3
4 columns
Example* (Items separated by ";" and "Export with header line" included).
|
"Group name" |
;"Main" |
;"Sub" |
;"Address" |
"Main Group" |
;"0" |
;"" |
;"" |
"Middle Group" |
;"0" |
;"0" |
;"" |
"My Group Address" |
;"0" |
;"0" |
;"1" |
Format 1/1
2 columns
Example* (Items separated by ";" and "Export with header line" included).
|
"Group name" |
;"Address" |
"Main Group" |
;"0/-/-" |
"Middle Group" |
;"0/0/-" |
"My Group Address" |
;"0/0/1" |
Format 3/3
6 columns
Example* (Items separated by ";" and "Export with header line" included).
|
"Main" |
;"Middle" |
;"Sub" |
;"Main" |
;"Middle" |
;"Sub" |
"Main Group" |
; |
; |
;"0" |
;"" |
;"" |
|
;"Middle Group" ; |
; |
;"0" |
;"0" |
;"" |
|
; |
;"My GA" |
;"0" |
;"0" |
;"1" |
* |
Spaces have been inserted manually here for readability. |
Notes
The export always relates to the currently selected part. For example, if a Middle Group is selected, the part below this level will be exported. The following fields are included in an export:
- Range or 'GroupRange' (depending on the Group Address style, these are, for example, Main Group, Middle Group and simply the corresponding level).
- The Group Address Name
- The Group Address Value
- Group Address Description
- Datapoint Types associated with this Group Address
- Group Objects associated with this Group Address and Datapoint Types associated with it.