AECOsim Building Designer V8i Migration Guide: · PDF fileAECOsim Building Designer V8i...

Click here to load reader

  • date post

    11-Feb-2018
  • Category

    Documents

  • view

    224
  • download

    1

Embed Size (px)

Transcript of AECOsim Building Designer V8i Migration Guide: · PDF fileAECOsim Building Designer V8i...

  • AECOsim Building Designer V8i Migration Guide Dataset & Project Migration Guide

    Copyright @ 2012 Bentley Systems Incorporated| AECOsim Building Designer Technote 1

    AECOsim Building Designer V8i Migration Guide: Dataset & Project Migration

    Version 1.0 March 2012 AECOsim Building Designer V8i (SELECTseries 3)

    Introduction

    AECOsim Building Designer is the result of merging Bentley Architecture, Bentley Structural Modeller, Bentley Building Mechanical Systems, and Bentley Building Electrical Systems (the legacy products) into an interdisciplinary Building Information Modelling (BIM) application.

    The separate datasets from each program are now unified into a single workspace comprised of the application and the project dataset. Company content, IFC property sets, etc. can be added to this workspace.

    AECOsim Building Designer allows the user to migrate legacy dataset content and project models to AECOsim Building Designer. In order to do so, a few tasks need to be performed:

    Update the schema, i.e. new and changed DataGroup property names, especially in the architectural portion Revise dataset file names and content Merge tools that have been combined Add support for materials in DGN library palettes only Add support of an ObjectMaterial property for Spaces

    AECOsim Building Designer includes utilities that automate the dataset upgrade process as much as possible. Some manual changes may be required, considering how widely customized datasets and workspace configurations differ from user to user.

    AECOsim Building Designer also provides utilities that automate certain dataset creation or customization tasks.

    Backup your workspace before using any of the Building Designer Utilities.

    Projects should be completed with the application(s) and workspaces in which they were started. If you must upgrade them to AECOsim Building Designer, dataset migration must be completed prior to the project migration.

  • AECOsim Building Designer V8i Migration Guide Dataset & Project Migration Guide

    Copyright @ 2012 Bentley Systems Incorporated| AECOsim Building Designer Technote 2

    Bentley Professional Services is available to assist with upgrading legacy datasets and project data.

    Typical workflow

    The migration from the legacy applications to AECOsim Building Designer looks like this:

    This document will cover these steps in greater detail.

    Upgrading Legacy datasets

    In order to use legacy datasets from the stand-alone applications, they must be upgraded to match the AECOsim Building Designer schema.

    Add legacy dataset folders and files of company- or project-specific dataset content to the AECOsim Building Designer workspace in a separate top folder, for example \WorkSpace\BuildingDatasets\DatasetExtensions\CompanyDataset, before upgrading them to AECOsim Building Designer. Files and folders that are not customized should be deleted.

    Modifications to the AECOsim Building Designer dataset may be overridden when a new version is installed in the future. Keep your custom catalogs separate. If projects created with the legacy products are migrated to AECOsim Building Designer, their project-specific content should be added to the project dataset, typically located in \AECOsimBuildingDesigner V8i\WorkSpace\Projects\BuildingExamples\\support\dataset.

  • AECOsim Building Designer V8i Migration Guide Dataset & Project Migration Guide

    Copyright @ 2012 Bentley Systems Incorporated| AECOsim Building Designer Technote 3

    Company dataset extensions A configuration file, for example Company_Dataset.cfg, should be placed in the top folder of the company dataset, for example, in the $(TF_DATASETS)DatasetExtensions/CompanyDataset folder. It must include configuration variables for each included company dataset subfolder:

    #---------------------------------------------------------------------- # Add search paths for each subfolder in the company dataset # (Delete or comment out config. variable of subfolder that does not exist) #---------------------------------------------------------------------- MS_BACKUP < $(COMP_DATASET)Bak/ TFDIR_CELL < $(COMP_DATASET)cell/ ATFDIR_CELL < $(COMP_DATASET)cell/ MS_CELLLIST < $(COMP_DATASET)cell/*.* TFDIR_COMP < $(COMP_DATASET)comp/ TFDIR_CPART < $(COMP_DATASET)cpart/ DG_CATALOGS_PATH < $(COMP_DATASET)datagroupcatalogs/ DG_SCHEDULE_LAYOUT_PATH < $(COMP_DATASET)datagrouplayouts/ DG_PATH > $(COMP_DATASET)datagroupsystem/ TFDIR_FRAME < $(COMP_DATASET)frame/ ATFDIR_CASEBASE < $(COMP_DATASET)frame/casework/base/ ATFDIR_CASETALL < $(COMP_DATASET)frame/casework/tall/ ATFDIR_CASEWALL < $(COMP_DATASET)frame/casework/wall/ ATFDIR_DOOR < $(COMP_DATASET)frame/doors/ ATFDIR_WINDOW < $(COMP_DATASET)frame/windows/ TFDIR_GUIDE = $(COMP_DATASET)guide/ # default folder for column grid tool MS_MATERIAL < $(COMP_DATASET)materials/ MS_PATTERN < $(COMP_DATASET)materials/pattern/ MS_BUMP < $(COMP_DATASET)materials/bump/ TFDIR_PART < $(COMP_DATASET)part/

  • AECOsim Building Designer V8i Migration Guide Dataset & Project Migration Guide

    Copyright @ 2012 Bentley Systems Incorporated| AECOsim Building Designer Technote 4

    Project Datasets For every project that uses the Company Dataset, add the following entry to the project configuration file (.pcf) in front of the project-level configuration variables, for example:

    #---------------------------------------------------------------------- # Define path and folder name of company dataset # (change path and folder name as necessary) #---------------------------------------------------------------------- COMP_DATASET = $(TF_DATASETS)DatasetExtensions/CompanyDataset/ #---------------------------------------------------------------------- # Read company cfg file to add search paths to company dataset subfolders #---------------------------------------------------------------------- %if exists ($(COMP_DATASET)CompanyDataset.cfg) %include $(COMP_DATASET)CompanyDataset.cfg %endif #---------------------------------------------------------------------- # Enable display of duplicate families (1=yes; 0=no) #---------------------------------------------------------------------- TFDATASET_SHOWDUPLICATEFAMILIES = 1

    Suggestions:

    Consider prefixing customized company dataset files that have the same name as application dataset files with a c or some other letter, to make it easier to distinguish them from application dataset files. For example, cCurtainWall.xml or cCatalogTypeExtensions.xml.

    Consider doing the same for customized project dataset files that have the same name as application dataset, to make it easier to distinguish them from the delivered project dataset files.

    Careful consideration must be given to determine whether to append () or override (=) a configuration variable. Notes:

    TFDIR_SETTING must only override (=) the application configuration variable BB_ANNOTATION_CELLLIB must only override (=) the application configuration variable. Appending or

    prepending a search path to more than one annotation cell library will cause an error condition and none of the annotation cells will be available.

  • AECOsim Building Designer V8i Migration Guide Dataset & Project Migration Guide

    Copyright @ 2012 Bentley Systems Incorporated| AECOsim Building Designer Technote 5

    Dataset Migration Utilities

    Dataset Migration Utilities facilitate the migration of legacy dataset content as automated as possible to make them compliant with the schema and requirements of AECOsim Building Designer.

    They are started from the Utilities > Building Designer Utilities drop-down menu

    Backup your workspace before using any of the Building Designer Utilities.

    DataGroup Catalog Upgrade Utility Upgrading Part Rendering to accommodate DGNlib material palettes

    The DataGroup Catalog Upgrade Utility can be used to create DataGroup catalog items from PAZ and BXF files for doors, windows and casework.

    1. Open the DataGroup Catalog Upgrade Utility (Utilities > Building Designer Utilities > DataGroup Catalog Upgrade Utility)

    2. Place a check-mark in the Active column for the catalog type(s) to be created

    3. If the default file name displayed in the Catalog File Name column is not correct, highlight the row, click File. and navigate to the catalog file

  • AECOsim Building Designer V8i Migration Guide Dataset & Project Migration Guide

    Copyright @ 2012 Bentley Systems Incorporated| AECOsim Building Designer Technote 6

    4. To create a new empty catalog file, open the DataGroup Catalog editor (Building Designer > DataGroup Building Components > EditCatalogs)

    5. Right-click the catalog type (for example, Door) and select New Catalog Item

    6. In the New Catalog Item dialog box, click on the Create a new DataGroup file icon

    7. In the New File dialog box, navigate to the target directory and enter a file name, for example, MyDoors

    8. Click OK

    9. Put any name into the Name field (otherwise the file will not be created). This will create a temporary catalog item that you will delete shortly.

    10. Close the DataGroup Catalog Editor

    11. When asked, do not save changes

    12. In the Upgrade Catalog Files dialog box, click File and navigate to the newly created catalog file, for example, cDoors.xml

    13. Click OK to add the PAZ and/or BXF files in the workspace to the selected catalog files

    14. Delete the temporary DataGroup catalog item from step #9.

  • AECOsim Building Designer V8i Migration Guide Dataset & Project Migration Guide

    Copyright @ 2012 Bentley Syste