Bentley Communities
Bentley Communities
  • Site
  • User
  • Site
  • Search
  • User
OpenUtilities
  • Product Communities
OpenUtilities
OpenUtilities Wiki Customizing the Interface - CONNECT Edition
    • Sign In
    • +OpenUtilities
    • Access Service Request Manager
    • +Bentley sisHYD Multi Utility
    • Design Features - promis.e Functionality - Promis.e Standard
    • +OpenUtilities sisNET - English
    • +OpenUtilities Substation
    • Promis.e Paths
    • -Promis.e Wiki
      • +CONNECT Edition - Promis.e
      • About Promis.e
      • +Administration Features - Promis.e
      • +APIs_VBA - Promis.e
      • +Automation Features - Promis.e
      • +Component Features - Promis.e
      • +Component Management - Promis.e
      • +CONNECT Services - Promis.e
      • +Data Manager - Promis.e
      • +Database Platform Support - Promis.e
      • +Display - Promis.e
      • +Drawing Management - Promis.e
      • +Engineering Design Considerations - Promis.e
      • Error - Object reference...General
      • +Find_Replace - Promis.e
      • Finding the Tutorial
      • +Installation_Configuration - Promis.e
      • +Interoperability - Promis.e
      • +Licensing - Promis.e
      • +Maintenance Features - Promis.e
      • +Migration - Promis.e
      • +OS Support - Promis.e
      • +Panel Layout - Promis.e
      • +Performance - Promis.e
      • -PowerPlatform Support - Promis.e
        • Area inside the sheet border is filled white
        • Assign actions to function keys
        • Attaching References (Auxiliary Views)
        • Blank, gray project pages
        • Customizing the Interface - CONNECT Edition
        • Customizing the Interface - V8i
        • Elements missing from published or plotted output
        • Empty box is stuck on the screen
        • Error - Format version not supported, not recognized file format
        • Error - Unable load/create dialog item of type 'HTML', id=41510001
        • Inserting Drawings
        • Inserting Elements By Coordinates
        • Inserting Raster Images
        • Inserting Tables
        • Make custom styles available for all pages, symbols
        • +Manipulate Tools - PowerPlatform Support - Promis.e
        • Masking Elements
        • MicroStation Help file
        • Off-grid wires and symbols
        • Pasted elements rotated or scaled
        • Platform Fundamentals for Promis.e Standalone Users
        • promis.e is read-only
        • Restore Platform Defaults - Promis.e
        • Run key-ins when a page is opened
        • Set DGN files to update fields automatically
        • Symbols jump when moved or placed
        • Tools Are Missing From Tasks Menu
        • Turn the Task Bar Menu Back On
        • Unreadable or disappearing elements upon selection
        • View is rotated
      • +Print_Publish Features - Promis.e
      • +ProjectWise Integration - Promis.e
      • Promis.e Help file
      • +Reports_Output Features - Promis.e
      • +Template Management - Promis.e
      • +Text Tools - Promis.e
      • Training FAQs
      • +Wire Numbering - Promis.e
      • +Wiring Features - Promis.e
      • +Project Management - Promis.e
      • Promis.e Title
      • Working from home with Promise.e
    • Replace Family - Find_Replace - Promis.e
    • SQL Server Login

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

    Customizing the Interface - CONNECT Edition

      Product(s): Bentley Substation
      Version(s): 10.00.00.232
      Environment: N/A
      Area: PowerPlatform Support
      Subarea: N/A

    Background

    If using a V8i (08.11.xx.xx) version of the software, see the Customizing the Interface - V8i article.

    This article explains how the user interface in Bentley Substation CONNECT Edition can be customized.

    To demonstrate the techniques, this document describes how to create custom buttons for grid spacing. These techniques can be extended to create other tools and customize other tool boxes and tasks, see the Other Customizations section below.

    Steps to Accomplish

    Create a new button

    1. Select File > Settings > Customize Ribbon or right-click the ribbon and select Customize Ribbon.
    2. In the Customize the Ribbon pane on the right side of the resulting dialog, find the group to which the new button will be added. For this example, drill down into the Electrical workflow, then into the View ribbon tab, then into the Display group. Note that the Grid Snap split button where default grid spacing buttons are found is locked, so a new tool cannot be added to the Grid Snap area.
    3. Right-click Display and select Add New Panel. Name the panel "Custom". This name is not displayed and does not have to be "Custom". Adding a new panel allows for better control of where the custom grid spacing button will appear.
    4. At this point, any existing tool could be dragged from the Choose Components From pane on the left into the new "Custom" panel.  For this example, right-click Display and select Add New Button.
      Optionally, if there were more than one custom grid spacing to add, a split button could be added and the grid spacing buttons added to the split button.
    5. In the Properties pane for the new button, set the properties as follows:

      Label: 0.0625
      Description: Grid 0.0625
      Key-in: active gridunit 0.0625
      Show label only: set this check box
    6. Drag the "Custom" panel item so that it is between the Grid Snap item and the Electrical.View.Display.LeftGP item.
    7. Click Apply on the Customize Ribbon dialog. Note that the new "0.0265" tool created by the above procedure is now listed in the Choose Components From pane on the Customize Ribbon dialog, so it could easily be dragged into other areas of the ribbon.
    8. Click OK.

    Distributing the customization

    The changes made to the ribbon interface using the procedure above are stored in the file specified by the MS_PERSONALDGNLIB configuration variable. This file is typically:

    C:\Users\[user]\AppData\Local\Bentley\Substation\10.0.0\prefs\Personal.Substation.dgnlib

    Select File > Settings > Configuration > Configuration Variables and Edit the MS_PERSONALDGNLIB variable (make no changes) to confirm the path and name of the file to which the customizations have been added.

    This file could be copied to other users' workstations, replacing their Personal.Substation.dgnlib, as a means of distributing the customizations.

    Other Customizations

    The techniques described in this document can be extended to create other customizations as well.

    • Tools can be created that perform multiple commands by stringing commands together in the Key-In field of the tool. Commands are separated with semicolons.  For example, a tool can be created to select a certain Wire Use and then invoke a "draw wire" type of command.  Wire Uses are also known as Wire Layers.  The Key-In for such a tool would be:

    ECAD COMBOWIRELAYERS combosetinx <Wire Use>; ECAD EXEC DRAWWIRE

    Substitute the desired wire use, such as 3Phase  for <Wire Use>.  Be aware that the wire use name is case-sensitive.  Substitute the desired wire command, such as ECAD EXEC THREEPHASELINE, for ECAD EXE DRAWWIRE.  Use Workspace > Customize to look at the tools in the Wiring toolbox in the .DGNLIB file supplied with the software to see their Key-in commands.

    • A tool could be created to turn on or off a level or group of levels.  For example, show or hide the display of device IDs by turning on and off the ECT_DGRM_TAGS level.  To turn off the level the key-in would be:

    level set display off ECT_DGRM_TAGS

    To turn the level on:

    level set display on ECT_DGRM_TAGS

    To toggle the level:

    level set display toggle ECT_DGRM_TAGS

    • A tool could be created to set certain active element properties and then initiate a drawing tool.  An example of this would be a tool that sets the active color to 2 (green), sets the active line style to 3 (dashed), sets the active line weight to 5, then initiates the Draw Wire tool.  The key-in for this tool would be:

    active color 2; active style 3;active weight 5; ECAD EXEC DRAWWIRE

    • A tool to complement the custom Draw Wire tool in the previous example would be one that sets the active element properties back to "normal".  The following Key-in sets the active color to ByLevel, and the line style and weight to 0.  Your "normal" may differ.

    active color bylevel; active style 0;active weight 0

    • DGNLIB files are cumulative. To remove an item from the interface it must be removed from all DGNLIB files the software is using. In other words, to remove an unwanted interface item supplied with the software, remove it from the DGNLIB file supplied with the software. Merely leaving the unwanted item out of a custom.dgnlib file does not remove it from the interface. Backup the supplied DGNLIB file before modifying it.

    • A tool to hide elements not in the current selection set can be handy, especially for 3D design work. The key-in for this is

      displayset set selection

      Another tool could be created to re-display the hidden elements. The key-in for this is

      displayset clear

    See Also

    Customizing the Interface - V8i

    Creating Tool Icons

    AskInga - Export MicroStations icons from the open DGN library

    AskInga - What command was that?

    AskInga - Combine your keyins

    AskInga - How to extract keyins for the tool settings in MicroStation V8i

    External Links

    YouTube - How to Customize the Ribbon

      Original Author: Matt_P
    • CONNECT Edition
    • PowerPlatform Support
    • how to
    • Customization
    • Menu
    • Bentley Substation
    • en
    • Share
    • History
    • More
    • Cancel
    • Matt_P Created by Communities MVP Matt_P
    • When: Wed, Jul 18 2018 5:33 PM
    • Siddharaj Talawar Last revision by Bentley Colleague Siddharaj Talawar
    • When: Mon, Apr 13 2020 9:40 AM
    • Revisions: 3
    • 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