Bentley Communities
Bentley Communities
  • Site
  • User
  • Site
  • Search
  • User
OpenBuildings | AECOsim | Speedikon
  • Product Communities
  • Building
  • OpenBuildings | AECOsim | Speedikon
  • Cancel
OpenBuildings | AECOsim | Speedikon
OpenBuildings | AECOsim | Speedikon Wiki Upgrade existing elements and their properties to the current Catalog Schema
    • Building Design - Wiki
    • -OpenBuildings Designer
      • +What's New
      • FAQ - OpenBuildings Designer CONNECT Edition
      • Released Versions - OpenBuildings Designer
      • IFC4 Self-certification
      • +Installation - OpenBuildings Designer
      • +Migration - Upgrading from earlier versions
      • +Configuration - OpenBuildings Designer
      • +General - OpenBuildings Designer
      • +User Interface - OpenBuildings Designer
      • +Architectural Design - OpenBuildings Designer
      • +Structural Design - OpenBuildings Designer
      • +ProStructures Interoperability - OpenBuildings Designer
      • +Electrical Annotation and Design - OpenBuildings Designer
      • -Datasets and Content - OpenBuildings Designer
        • Available Regional Datasets
        • Dataset installation options
        • Dataset Strategies - Local or Network
        • New and modified files in OpenBuildings Designer Update 7 datasets
        • Upgrade existing elements and their properties to the current Catalog Schema
        • Dataset changes in the latest version of OpenBuildings Designer
        • Catalog Item Manager - Moving DataGroup content
        • Creating new Catalog Sub Group Catalog in OpenBuildings Designer
        • Dataset files needed to support custom Spaces
        • Enabling and configuring the Standardized File Naming Utility for WorkSets
        • Family/Part Editor, storing column display settings
        • How can I add / modify a new / existing Definition in a Catalog?
        • How to create custom compound wall
        • How to create wiremesh fence
        • Scheduling Element Coordinates - Structural Steel or Concrete Piles Example
        • UK Dataset - Changed Files in Update 5
        • Unwanted Levels in OpenBuildings Designer DGN Files
        • A series of ATF***FAMILY errors are generated and the Family/Part drop-down lists are empty
        • Add instance data to a graphic element
        • Existing element is not accepting new definition value
        • Hiding the Catalog Items in OBD
        • How to create a custom wall or barrier *.cel file
        • Report Component Formulas for Quantify Reports
        • Resolving the BB_PROGRAMMANAGER_DATA error for a newly created WorkSpace
        • Simplest way to create a new cell in OpenBuildings Designer
      • +DataGroup System - OpenBuildings Designer
      • +Floor Management - OpenBuildings Designer
      • +Grid Systems - OpenBuildings Designer
      • +Drawing Views - OpenBuildings Designer
      • +Annotation - OpenBuildings Designer
      • +Import/Export- OpenBuildings Designer
      • +ProjectWise Integration - OpenBuildings Designer
      • +Customization - OpenBuildings
      • +Platform Tools - OpenBuildings Designer
      • +Plumbing Design
      • Electrical Designer
      • +Learning Tips
      • +HVAC Design - OpenBuildings Designer
      • +Bentley i-model Composition Server
      • +iTwin Synchronizer
      • +OpenBuildings Designer - Support for IFC Singapore
      • +OpenBuildings Designer Accreditation Program
    • +OpenBuildings Energy Simulator
    • +GenerativeComponents
    • OpenBuildings Station Designer
    • +OpenBuildings Speedikon
    • +OpenBuildings Speedikon + Bentley Speedikon V8i
    • +Bentley Facilities Space Planner CONNECT Edition
    • +AECOsim Building Designer
    • +iModel Plugin for Revit
    • +Social Distance Assessments
    • Working from home with OpenBuildings products
    • Working from home with Speedikon
    • +Special Interest Group (SIG) FAQs
    • +Structural Modeler_PS
    • +Configuration Explorer
    • +Legacy Products
    • Learning Content for OpenBuildings Designer

     
     Questions about this article, topic, or product? Click here. 

    Upgrade existing elements and their properties to the current Catalog Schema

      Product(s): OpenBuildings Designer
      Version(s): CONNECT Edition, V8i
      Area: Dataset
      Subarea: Upgrade/Migration

    As OpenBuildings Designer datasets are updated with new versions, the Catalog schema (known as the DataGroup Schema in V8i) is modified to support new/changed features and content.

    When files are migrated forward to a newer version of the application and datasets existing building elements in DGN file may be out of synchronization with the active dataset schema. An upgrade process is required to synchronize such files with the active dataset. This can also be required when custom Catalog content is created/modified or if additional IFC Property Sets are added to a project.

    Another scenario is if models created with one regional dataset have to be used with another, say US to CN. The same synchronization would be required to ensure correct behaviour and display of building elements.

    The Schema Transformation Utility is the only tool provided to update existing project content from one schema to another. It only works on complete files, if it were able to operate on selection sets discrepancies between the elements and the active schema could persist resulting in errors in presentation or reporting.

    Scope

    This solution only needs to be applied to DGN files that contain elements that carry DataGroup data, e.g. Walls, Slabs, Mechanical components, Spaces, etc., and standard MicroStation elements that have had DataGroup Instance Data attached to them.

    In addition to these design files, the BB_FloorMaster.dgnlib for the project will need to be upgraded, the elements contained within this file that stored the floor and other reference plane properties must also be synchronised with the dataset schema.

    Files that do not contain any DataGroup carrying elements do not contain anything that needs to be upgraded.

    Typically this utility would be used after:

    • adding or changing custom Catalog Properties
    • upgrading a project from a previous version of a dataset (whether a newer regional dataset or a customized dataset)
    • additional IFC Property Sets are added to a project.
    • if other dataset extensions, either customized or from Bentley are added to a project.

    It is highly recommended that this utility and any other related processes are run after backups have been taken; either just after a regular scheduled backup or after an unscheduled backup of the specific files involved.

    Solution

    CONNECT Edition - File > Utilities > Data Utilities > Upgrade (Schema Upgrade Utility) 

    V8i - Utilities menu > Building Designer Utilities > DataGroup Upgrade Utility > Upgrade.

    Important: note that if properties exist on existing elements that are no longer defined in the schema, running this utility permanently deletes those properties and their corresponding values from the elements. If you wish to keep those properties, you must map them to another remaining property with the DataGroup Transformation Utility, before running the DataGroup Upgrade Utility.

    The utility is also available via key-in:

    mdl load Bentley.Building.Datagroup.Upgrade; dg upgrade

    Batch Process

    These key-ins can be applied by a batch process with the additional command 'dg processfile'.

    The command file to use would contain the lines:

    mdl load Bentley.Building.DataGroup.Upgrade; dg upgrade

    dg processfile

    Quick Tip

    The following sequence should ideally be used when none of the referenced files are in use so all files can be processed. File that are not processed will be listed so can be upgraded individually or by a repeat run.

    • Create a new file
    • reference attach all of the files that you need to upgrade
    • then use the 'Upgrade All References' option.

    This will process all of the attached files. The time required for this to complete will vary according to project size and complexity. For larger projects it may be appropriate to work with sequential groups of files rather than attaching all files.

    • CONNECT Edition
    • AECOsim Building Designer V8i
    • datagroup
    • OpenBuildings Designer
    • Migration
    • Schema Migration
    • Share
    • History
    • More
    • Cancel
    • Elisabeth Pry Created by Bentley Colleague Elisabeth Pry
    • When: Wed, Nov 20 2013 2:34 PM
    • Marc Thomas Last revision by Bentley Colleague Marc Thomas
    • When: Fri, Oct 22 2021 11:14 AM
    • Revisions: 18
    • Comments: 0
    Recommended
    Related
    Communities
    • Home
    • Getting Started
    • Community Central
    • Products
    • Support
    • Secure File Upload
    • Feedback
    Support and Services
    • Home
    • Product Support
    • Downloads
    • Subscription Services Portal
    Training and Learning
    • Home
    • About Bentley Institute
    • My Learning History
    • Reference Books
    Social Media
    •    LinkedIn
    •    Facebook
    •    Twitter
    •    YouTube
    •    RSS Feed
    •    Email

    © 2023 Bentley Systems, Incorporated  |  Contact Us  |  Privacy |  Terms of Use  |  Cookies