AECOsim Building Designer Dataset GB - Bentley · PDF filed AECOsim Building Designer -...

© 2

012

Ben

tley

Sys

tem

s, I

ncor

pora

ted

AECOsim Building Designer - Legacy Data Migration Utilities

Volker Thein, Dipl.-Ing. Arch.

Product Director

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed

2 | WWW.BENTLEY.COM

• schema changesnew and changed DataGroup property names, especially in the architectural portion

• removal of superfluous prefixes in dataset file names and content

• merge of the base, tall and wall casework DataGrouptypes into one

• render support for materials in DGN library palettes only

• support of ObjectMaterial property for Spaces

AECOsim Building Designer changes

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed

3 | WWW.BENTLEY.COM

• dataset upgrade tools– Dataset Upgrade Utility

– Part Rendering Upgrade Utility

– Space Part Upgrade Utility

– PAZ Part Mapping Utility

– BXC Mapping Utility

– DataGroup Catalog Upgrade Utility

• model upgrade tools– key-in: mdl load Bentley.Building.DataGroup.Upgrade.dll

key-in: dg upgrade

– DataGroup Transition Utility

Legacy data migration tools

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed

4 | WWW.BENTLEY.COM

Cautionary Notes

F

Preferably, projects should be completed with

the application(s) and workspaces they were

started with and only upgraded to AECOsim

Building Designer if necessary.

F

Do not make changes to the AECOsim Building

Designer dataset as they may be overridden

when the new version is installed.

FBackup your workspace before using any of

the Building Designer Utilities!

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed

5 | WWW.BENTLEY.COM

Legacy Data Migration

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed

6 | WWW.BENTLEY.COM


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed

7 | WWW.BENTLEY.COM

• Add a dataset extension folder to your workspacee.g. …\AECOsimBuildingDesignerV8i\WorkSpace\BuildingDatasets\DatasetExtensions

• Add your legacy folders to the dataset extension foldere.g. …\DatasetExtensions\MY_Dataset

• Add a configuration file to the dataset extension foldere.g. MY_Dataset.cfg

Add legacy dataset to workspace

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed

8 | WWW.BENTLEY.COM

• Add configuration variables to configuration file MY_Dataset.cfg to append or prepend sub folders in…\DatasetExtensions\MY_Dataset to workspace


#----------------------------------------------------------------------

# Add search paths for each subfolder in the ArchDatasetNcsUS dataset

# (Delete or comment out config. variable of subfolder that does not exist)

#----------------------------------------------------------------------

MS_BACKUP < $(MY_DATASET)bak/

TFDIR_CELL < $(MY_DATASET)cell/

ATFDIR_CELL < $(MY_DATASET)cell/

MS_CELLLIST < $(MY_DATASET)cell/*.cel

TFDIR_COMP < $(MY_DATASET)comp/

TFDIR_CPART < $(MY_DATASET)cpart/

DG_CATALOGS_PATH < $(MY_DATASET)datagroupcatalogs/

DG_SCHEDULE_LAYOUT_PATH < $(MY_DATASET)datagrouplayouts/

TFDIR_FRAME < $(MY_DATASET)frame/

ATFDIR_CASEWORK < $(MY_DATASET)frame/casework/

ATFDIR_CASEBASE < $(MY_DATASET)frame/casework/base/

ATFDIR_CASETALL < $(MY_DATASET)frame/casework/tall/

ATFDIR_CASEWALL < $(MY_DATASET)frame/casework/wall/

ATFDIR_DOOR < $(MY_DATASET)frame/doors/

ATFDIR_WINDOW < $(MY_DATASET)frame/windows/

TFDIR_PART < $(MY_DATASET)part/

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed

9 | WWW.BENTLEY.COM

• Define the configuration variable MY_DATASET in the Project Configuration file before the project directories are established, by adding the following text:


#========================================

# Add company dataset to workspace

#========================================

# Define path and folder name of company dataset

# (change path and folder name as necessary)

#----------------------------------------------------------------------

MY_DATASET = $(TF_DATASETS)DatasetExtensions\MY_Dataset/

#----------------------------------------------------------------------

# Read company cfg-file to add search paths to company dataset subfolders

#----------------------------------------------------------------------

%if exists ($(MY_DATASET)MY_Dataset.cfg)

%include $(MY_DATASET)MY_Dataset.cfg

%endif

Note: The configuration variable MY_DATASET can point to any valid folder location

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed

10 | WWW.BENTLEY.COM

• Start AECOsim Building Designer and open a model

• Verify that the folders in MY_DATASET are added to the workspace

• Open the Configuration dialog box


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Navigate to configuration variables set in MY_Dataset.cfg, e.g. DataGroup Catalog Files


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed



© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


Dataset Upgrade Utility

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• checks– prefixes of files

– prefixes used in strings inside files

– invalid DataGroup property definitions

– ‘casework’ subfolders ‘base’, ‘tall’ and ‘wall’

• upgrades

– removes prefixes from files and strings inside files

– rectifies invalid DataGroup property definitions

– moves files from the ‘casework’ subfolders ‘base’, ‘tall’ and ‘wall’ to ‘casework’


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Prefixes.set in the setting folder defines the prefixes to be checked (and subsequently removed);further prefixes can be added; this will increase processing time.

• SchemaMapping.set in the setting-folder includes a default mapping table from legacy to ABD properties. This xml-file can be edited or created with the DataGroup Transformation Utility.

Dataset Upgrade Utility - Notes

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed



© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Progress is displayed in the Message Field


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• If set in the options, SchemaUpgradeLog.txt opens


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


Part Rendering Upgrade Utility

FAECOsim Building Designer datasets no longer include palettes and materials,

but use those delivered with MicroStation in the ‘Bentley_Materials.dgnlib’ and

other DGN libraries, typically installed in …\WorkSpace\System\materials.

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• checks part-files for use of materials in .pal files

• maps materials in .pal files to DGNLIB palettes and materials

• updates part-files based on mapping table

Part Rendering Upgrade Utility

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Mapping file:…/setting/MaterialMapping.set

Part Mapping Upgrade Utility

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Compare original with upgraded part files using a file compare application, e.g.

Part Mapping Upgrade Utility

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Open the Dataset Explorer

• Open the ‘Render Properties’ view

• Select a Family or ‘All Parts’

• Sort the view by ‘Render Palette’ or ‘Render Material’

Part Mapping Upgrade Utility (Alternative)

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Left-click on a material to open the Material Picker

• Select a dgnlib palette

• Click on a material to assign it to the selected Part(s)

Part Mapping Upgrade Utility (Alternative)

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


Space Part Upgrade Utility

FIn AECOsim Building Designer, the Part name does not have to be identical to

the DataGroup catalog item name; Family and Part are set by the ObjectMaterial

property.

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• checks Space part-files for missing ObjectMaterialproperties (Family::Part)

• adds ObjectMaterial properties(Part name = Catalog item name)


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Compare the original with upgraded Space catalog file using a file compare application, e.g.


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• assign alternative Families and Parts to the catalog items using the DataGroup Catalog Editor

Space Part Upgrade Utility (Alternative)

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


PAZ Part Mapping Utility

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• replaces families & parts in PAZ(and BXC files)

• Navigate to the folder that contains the paz-file(s)

• Select the paz-file(s) to be re-mapped

• Click the 'Done' button to open the ‘Family/Part Search and Replace’ window


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Remap the first row– Click on the first row

– From the Family picklist, select the replacement Family

– From the Part picklist, select the replacement Part

– Click ‘Replace’Note: the entry is grayed out and can’t be changed anymore


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Remap the second row– Click on the next row

– From the Family picklist, select the replacement Family

– From the Part picklist, select the replacement Part

– Click ‘Replace’Note: the entry is grayed out and can’t be changed anymore


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Change units if necessary

• Click ‘Process’ to replace Families and Parts in all selected PAZ files


FFamilies and Parts in BXC files can be remapped in the same

way, but levels will not be changed.

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• replaces families & parts in PAZ(and BXC files)


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


BXC Mapping Utilityreplaces cell names, descriptions, levels, families and parts in BXC-file(s)

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• When Microsoft Excel opens, click the ‘Options…’ button of the Security Warning

• Select ‘Enable this content’ and click ‘OK’

BXC Mapping Utility

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Open the ‘Add-Ins’ tab and display the ‘BXC Utility’ drop-down list

• Click ‘Generate BXC Library Report…’

BXC Mapping Utility

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• From the list, select the bxc-file(s)

• Click ‘Continue’ to open the selected bxc-files

BXC Mapping Utility

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• replaces cell names, descriptions, levels, families and parts in BXC-file(s)

BXC Mapping Utility

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Edit spreadsheet– Open the tab (e.g. ‘MY_Watercoolers.bxc’)

– Highlight column ‘J’ (Level New)

– Open the ‘Find and Replace’ tool

– In the ‘Find what’ field, enter the current level

– In the ‘Replace with’ field, enter the replacement level

BXC Mapping Utility

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


– Click ‘Replace All’ to apply the chances to column ‘J’

• Repeat for other columns

BXC Mapping Utility

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Open the ‘Add-Ins’ tab and display the ‘BXC Utility’ drop-down list

• Click ‘Apply changes to BXC Library

• Note: only the active library (tab) is updated

• Optional: Deleted the tab of the updated library

BXC Mapping Utility

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• When all changes have been made and applied, exit Excel.

• When prompted to save the changes ‘you made to BXCUtil.xltm’, click ‘No’

DO NOT SAVE THE CHANGES MADE TO BXCUtil.xltm!!!

BXC Mapping Utility

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


Dataset Part Validation Utility

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Select the items to be validatedCompound Parts, Parametric Files, paz-Files, Cell Libraries


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Navigate to the text file in the ‘Temp’ folder and review the file(s)

• Fix the found issues

– add missing Family/Parts to the DataGroup system

– map valid/existing Family/Parts to paz and bxc files

– etc.


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed



© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


Cautionary Notes

F Backup your project models before using

the DataGroup Transformation Utility!

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


Compress design fileto purge empty and unused data resources as well as deleted elements from DGN files

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Open the ‘Compress Options’ dialog box via File > Compress > Options

• Check all actionsright-click in the ‘Select’ columnsto select ‘all’ or ‘none’

• Check ‘IncludeReferences’ ifreferences are attached

• Click ‘Compress’

• Click ‘OK’ when done

Compress DGN

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Open the ‘Key in’ dialog box

• Key in ‘compress design includerefs’

Compress DGN (Alternative)

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


dg upgradeto implement schema changes, e.g. new DataGroup definition files (property sets)

to add quantities to instance data of walls and slabs

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Open the ‘Key in’ dialog box

• Key in‘mdl load Bentley.Building.DataGroup.Upgrade.dll’

• Key in ‘dg upgrade’

• Note the progress bar while DGN is upgraded

dg upgrade

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


DataGroup Transformation Utilityupgrade existing model content from BA to ABD schema

transform existing DG catalog items to new DG catalog items

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Open the legacy design model, if necessary with references

• Open the DataGroup Transformation Utility

• Click the ‘Options’ button to review or change the options

DataGroup Transformation Utility –Standard schema

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• mapping file:\datagroupsystem\mapping\BA_to_ABD.xml


<Property>

<Source definition="swe_Door" name="swe_Door/Sort_typ/@Slagning" />

<Destination definition="SE_Doors_bas" name="SE_Doors_bas/@Slagning" />

<Action name="KeepOriginal" />

</Property>

<Property>

<Source definition="swe_Door" name="swe_Door/Sort_typ/@Brandklass" />

<Destination definition="SE_Doors_funktioner" name="SE_Door_funktioner/Krav/@Brandklass" />


</Property>

<Property>

<Source definition="swe_Door" name="swe_Door/Sort_typ/@Ventilation" />

<Destination definition="SE_Doors_funktioner" name="SE_Door_funktioner/Krav/@Ventilation" />


</Property>

<Property>

<Source definition="swe_Door" name="swe_Door/Sort_typ/@Ljudklass" />

<Destination definition="SE_Doors_funktioner" name="SE_Door_funktioner/Krav/@Ljudklass" />


</Property>

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Click ‘Process’ or ‘Process All References’ to upgrade the model(s)


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Open the legacy design model, if necessary with references

• Open the DataGroup Transformation Utility

• Click the ‘Options’ button to review or change the options

DataGroup Transformation Utility –Customized schema

© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Click the ‘Scan’ button to display the Source Catalog items and Source Catalog Instances, e.g.


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Remove all but one of the same Source Calalog types

• Select <Any> from the Source Catalog Instance picklist

• Select the corresponding Destination Catalogs from the Destination Catalog picklist; Note: these must be the same as the Source Catalogs, except for Base, Tall and Wall Casework, for which the Destination Catalogs is ‘Casework, e.g.


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Highlight each line in turn to display the Source Properties in the bottom window;Note: the ‘best match’ Destination Properties are displayed


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• Hover over entries with or to display the fly-over hint

• Check that ‘best fit’ property mappings are correct

• If a property mapping is incorrect, pick correct property from Destination Property picklistNote: used properties are no longer available in the picklist.

• For unmapped properties, select the corresponding property from the picklist

• Select the ‘Action’ from the picklist; in most cases ‘Keep original value’


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• When all properties have been correctly mapped, click ‘Save’ to save the mapping table (name as appropriate)Note: this file can be used for subsequent DataGroup transformations in the ‘standard source schema’ workflow

• Click ‘Process’ or ‘Process All References’ to upgrade the model(s)


© 2

012

Ben

tley

Sys

tem

s, In

corp

orat

ed


• transforms existing DG catalog items to new DG catalog items

DataGroup Transformation Utility –Catalog items

AECOsim Building Designer Dataset GB - Bentley · PDF filed AECOsim Building Designer -...

Documents

Transcript of AECOsim Building Designer Dataset GB - Bentley · PDF filed AECOsim Building Designer -...