AECOsim Building Designer Upgrading Legacy Data PDF

2012 Bentley Systems, Incorporated
AECOsim Building Designer

- Legacy Data Migration Utilities
Volker Thein, Dipl.-Ing. Arch. Product Director
schema changes
new 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 DataGroup types into one render support for materials in DGN library palettes only support of ObjectMaterial property for Spaces
2 | WWW.BENTLEY.COM
AECOsim Building Designer changes
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
3 | WWW.BENTLEY.COM
Legacy data migration tools
F F
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. Do not make changes to the AECOsim Building Designer dataset as they may be overridden when the new version is installed. Backup your workspace before using any of the Building Designer Utilities!
4 | WWW.BENTLEY.COM
Cautionary Notes
5 | WWW.BENTLEY.COM
Legacy Data Migration
6 | WWW.BENTLEY.COM
Add a dataset extension folder to your workspace

e.g. \AECOsimBuildingDesigner V8i\WorkSpace\BuildingDatasets\DatasetExtensions e.g. \DatasetExtensions\MY_Dataset e.g. MY_Dataset.cfg
Add your legacy folders to the dataset extension folder Add a configuration file to the dataset extension folder
7 | WWW.BENTLEY.COM
Add legacy dataset to workspace
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/
8 | 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
9 | 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
10 | WWW.BENTLEY.COM
Navigate to configuration variables set in MY_Dataset.cfg, e.g. DataGroup Catalog Files
Dataset Upgrade Utility
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
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
Progress is displayed in the Message Field
If set in the options, SchemaUpgradeLog.txt opens
19 | WWW.BENTLEY.COM 2012 Bentley Systems, Incorporated
Part Rendering Upgrade Utility

F
AECOsim 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.
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
Mapping file: /setting/MaterialMapping.set
Part Mapping Upgrade Utility
Compare original with upgraded part files using a file compare application, e.g.
Part Mapping Upgrade Utility
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)
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)
Space Part Upgrade Utility

F
In 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.
checks Space part-files for missing ObjectMaterial properties (Family::Part)
adds ObjectMaterial properties (Part name = Catalog item name)
Compare the original with upgraded Space catalog file using a file compare application, e.g.
assign alternative Families and Parts to the catalog items using the DataGroup Catalog Editor
Space Part Upgrade Utility (Alternative)
PAZ Part Mapping Utility
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
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 cant be changed anymore
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 cant be changed anymore
Change units if necessary
Click Process to replace Families and Parts in all selected PAZ files
F
Families and Parts in BXC files can be remapped in the same way, but levels will not be changed.
replaces families & parts in PAZ (and BXC files)
BXC Mapping Utility

replaces cell names, descriptions, levels, families and parts in BXC-file(s)
When Microsoft Excel opens, click the Options button of the Security Warning
Select Enable this content and click OK
BXC Mapping Utility
Open the Add-Ins tab and display the BXC Utility drop-down list
Click Generate BXC Library Report
BXC Mapping Utility
From the list, select the bxc-file(s)
Click Continue to open the selected bxc-files
BXC Mapping Utility
replaces cell names, descriptions, levels, families and parts in BXC-file(s)
BXC Mapping Utility
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
Click Replace All to apply the chances to column J
Repeat for other columns

BXC Mapping Utility
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
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
Dataset Part Validation Utility
Select the items to be validated
Compound Parts, Parametric Files, paz-Files, Cell Libraries
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.
Backup your project models before using the DataGroup Transformation Utility!
Cautionary Notes
Compress design file

to purge empty and unused data resources as well as deleted elements from DGN files
Open the Compress Options dialog box via File > Compress > Options
Check all actions
right-click in the Select columns to select all or none
Check Include References if references are attached Click Compress
Click OK when done

Compress DGN
Open the Key in dialog box Key in compress design includerefs
Compress DGN (Alternative)
dg upgrade
to implement schema changes, e.g. new DataGroup definition files (property sets) to add quantities to instance data of walls and slabs
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
DataGroup Transformation Utility

upgrade existing model content from BA to ABD schema transform existing DG catalog items to new DG catalog items
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
Click Load Select BA_to_ABD.xml in datagroupsystem/mapping
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" /> <Action name="KeepOriginal" /> </Property> <Property> <Source definition="swe_Door" name="swe_Door/Sort_typ/@Ventilation" /> <Destination definition="SE_Doors_funktioner" name="SE_Door_funktioner/Krav/@Ventilation" /> <Action name="KeepOriginal" /> </Property> <Property> <Source definition="swe_Door" name="swe_Door/Sort_typ/@Ljudklass" /> <Destination definition="SE_Doors_funktioner" name="SE_Door_funktioner/Krav/@Ljudklass" /> <Action name="KeepOriginal" /> </Property>
Click Process or Process All References to upgrade the model(s)
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
Click the Scan button to display the Source Catalog items and Source Catalog Instances, e.g.
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.
Highlight each line in turn to display the Source Properties in the bottom window; Note: the best match Destination Properties are displayed
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 picklist Note: 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
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)
transforms existing DG catalog items to new DG catalog items
DataGroup Transformation Utility Catalog items
Building Designer Migration Guide
Building Designer Migration Guide
AECOsim Building Designer

- Legacy Data Migration Utilities

AECOsim Building Designer Upgrading Legacy Data PDF

Uploaded by

Document Information

Original Description:

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

AECOsim Building Designer Upgrading Legacy Data PDF

Uploaded by

Copyright:

Available Formats

2012 Bentley Systems, Incorporated