Document toolboxDocument toolbox

(no) Export

Owned by Tom Wyczółkowski
Jul 21, 2023
3 min read

Translation needed

The content of this page was copied from another page tree and needs to be translated or updated.

When you finish translation, make sure to

  • Replace the label NEEDS-TRANSLATING with TRANSLATED

  • Remove this macro from the page

 

This functionality creates a package containing selected portion of your database. 

Package includes XML files describing structure of exported objects and may contain drawings, geometries, and attachments. 

Exporting data requires Data Exchange Manger role.

 

How to perform an export?

From Tree context menu

  • Click on selected object on Tree, and select Export option. 

  • Select  HDC Internal domain or any of public External Domains which will define objects class/fields name in exported package.

 

After clicking on   button and selecting export Domain you will see Export window.

  • Description - custom name for export. This name will be displayed on export log in TDXM.

  • Primary Perspective - perspective to select base structure for export objects (like hierarchy Tree).

  • Secondary Perspective - for each object exported look for linked objects based on secondary perspective (documents for instance).

  • Export output format - decide what format should have exported package. 

    • HDC Internal option produces HDC internal format used for Importing to other HDC database.

    • FI2 v. 1.22 - produces package of data that is compatible with Fi2 standard in version 1.22. See below for more info about FI2 export.

  • Include subtree - decide if subtree objects of selected one should be exported as well (in chosen perspective).

  • Export documents - if checked corresponding objects in default GRID perspective will be exported as well. 

  • Export geometries - decide if spots should included in export package.

  • Export attachments - decide if external files should be included in export package.




From Object set

You can add selected objects from Grid to Object set and then Export selected ones.

Using this method allows to select a single or more documents from Grid perspective and get metadata, drawing and spots in svg format.
When only documents are exported from here Primary and Secondary Perspective options in Export dialog is not important. It can be left with default choices.

Note that export of documents from grid can be done only to HDC Internal format!

More information on export format can be found in (no) HDC Internal Export Format

FI2 Export Properties

In case of export to the FI2 format, three export options are not available: Export documents, Export geometries and Export attachments.
User can select Include subtree option only. Then export package will contain data for all floor objects that are children of the object selected for the export.


Exported FI2 package can also contain single document for each exported floor but only if two conditions are met:

  • proper Perspective for export is chosen (the one that have documents classes for Floor class so perspective of "All" type can be used).

  • floor have a default document chosen (for selected Secondary Perspective) or there is only one document for given floor.

 

When exporting in FI2 format, External Domain selected for the export must be the one that is used for importing FI2 files - that is the one with classes that matches FI2 standard.

Otherwise the export will fail.

 


FI2 ExPort Properties

Domain used in export should have following mapped properties:

  • Document

    • FI2DokumentBeteckning

    • FI2DokumentAndringsbeteckning

    • FI2DokumentTitel

  • fi2property

    • fi2prop_id

    • fi2prop_name

    • GUID

  • fi2structure

    • fi2struct_id

    • fi2struct_name

    • GUID

  • fi2floor

    • fi2spsys_id

    • fi2spsys_name

    • GUID

  • fi2space

    • fi2space_id

    • fi2space_name

    • fi2space_usage

    • fi2space_status

    • GUID

Other properties (except properties for Document) will be added as fi2XXX_value block e.g.:

<fi2space_value> <fi2value_code>fi2space_function</fi2value_code> <fi2value_value>00</fi2value_value> </fi2space_value>

TDXM Export log & download

Go to TDXM and click on Export panel.

Each row is single export. View is similar to import log but it's a bit simpler. 
Select checkbox with your export after it's done and then click on Download button to download ZIP package with exported data.

Packages can be deleted without fear after downloading as you can always perform export again in case it's needed.

 

 

 

Importing exported data

If export package is to be imported in HDC database then first it needs to be uploaded. Proper package type have to be chosen. 
If package was exported to HDC Internal output format then the package should be registered as Internal type.