> ## Documentation Index
> Fetch the complete documentation index at: https://speckle-assistant.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Bentley (MicroStation, OpenRoads, OpenRail, and OpenBuildings)

export const connector_0 = "Bentley"

<div class="callout my-4 px-5 py-4 overflow-hidden rounded-2xl flex gap-3 border-2 border-red-600 bg-red-100/50 dark:border-red-600 dark:bg-red-400/20" data-callout-type="warning">
  <div class="mt-0.5 w-4" data-component-part="callout-icon">
    <svg class="flex-none w-5 h-5 text-red-700 dark:text-red-300" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2" aria-label="Warning">
      <path stroke-linecap="round" stroke-linejoin="round" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" />
    </svg>
  </div>

  <div class="text-sm prose min-w-0 w-full text-red-700 dark:text-red-300" data-component-part="callout-content">
    <b>Notice</b>: This user guide is based on the legacy {connector_0} connector.<br />
    We recommend using our new connectors instead, as they are easier to use and actively maintained. This legacy documentation may not be up to date.
  </div>
</div>

<Info>
  The Legacy Speckle connectors for Bentley software currently support:

  * MicroStation CONNECT
  * OpenRoads Designer CE
  * OpenRail Designer CE
  * OpenBuildings Designer CE
</Info>

<Note>
  The Speckle connectors for Bentley software were developed by Arup. Huge thanks to them for their contribution!
</Note>

## Getting started

To install this connector and add your Speckle account, follow the instructions in the [Speckle Manager](/legacy/user/manager) section.

Once installed, you can find the connector in the `Speckle 2` ribbon. Click on the connector button, and this will open a new pop-up window with the standard Desktop UI.

<Frame>
  <img src="https://mintcdn.com/speckle-assistant/LzEjPw7oADgMr4xu/images/legacy/bentley/speckle-ribbon.png?fit=max&auto=format&n=LzEjPw7oADgMr4xu&q=85&s=594fca3287e92977e089f56967816ec8" alt="Speckle ribbon" width="1067" height="121" data-path="images/legacy/bentley/speckle-ribbon.png" />
</Frame>

## User interface

Once the Speckle panel is open, go ahead and create a new project (or add an existing one) to the current file. Once the Microstation, OpenRoads, OpenRail, or OpenBuildings file is saved, the projects associated with that file will be saved too.

### Sending

To send objects to Speckle, you'll first need to specify which objects are to be sent.
This can be done in two ways:

* The simpler way involves manually selecting elements in Microstation, OpenRoads, OpenRail, or OpenBuildings.
* The more powerful way is to use filtering logic to select elements.

For the simpler selection method, follow the steps below:

1. First, ensure the project you want to send data to is in *Sender* mode.
2. Select the objects you want to send, and left-click the button that says `0 objects` in the Speckle Panel. A drop-down will appear; choose `Set Selection`.
3. The same button should now display the total count of objects that were selected.
4. You're ready to send! Press the `Send` button. You should see a progress bar and, once completed, a success message.

The following filters are also available depending on the Bentley application:

* `All` (all connectors): sends everything in the model that is supported
* `Level` (all connectors): sends everything on the selected levels
* `Element Type` (all connectors): sends all elements of the selected types
* `Civil Element Type` (OpenRoads, OpenRail): sends all elements of the selected civil types

All geometric elements are organized by `Level` when they are sent to Speckle: elements that do not have a level will be located in `Unknown`. For Civil elements from OpenRoads and OpenRail are organized by their element type, and in OpenBuildings, if you sent gridlines, they will be located in the `Grid Systems` container.

### Receiving

In order to receive data from a Speckle, you'll first need to create a project to your Speckle projects panel. If the project already exists on the server it will automatically be added in *Receiver* mode.

Once the project has been added, go ahead and hit the `Receive` button. This will display a progress bar (just like the sending operation) and, if successful, will add the received objects to the current document.