Onshape provides a mechanism for graphically aiding repair of broken references at any history point: View in repair. In most cases, View in repair is initiated after editing a Derived or Import feature to a new base part, causing broken references in the Part Studio. This opens a repair panel to the right of the Part Studio to help guide you to where repairs are needed.

Though View in repair is usually used after editing an existing Derive or Import feature to a new base part, it can be used after any change to the Part Studio causes features to fail further down in the Features list.

Onshape’s Repair visually helps users resolve missing references. In a Part Studio, open the Versions and history panel. Click the Repair icon and select a history entry, or right-click a history entry and select View in repair. Select an entry that shows the Part Studio prior to the missing reference.

The Repair panel displays the view-only history entry for visual reference. To switch the selected entry, click the Repair icon again and make a different selection. By default, the Part Studio and Repair panel update in tandem. When Synchronize view is not selected, the views are independent.

Edit the broken feature in the Part Studio. Hover over the missing reference to highlight it in the Repair panel, showing where the reference pointed previously. Select the two new references. Delete the missing references from the field and any other missing references if needed.

Right-click in the Repair panel for a context menu. Zoom to fit brings the entire model into view. Isometric returns the model to an angled isometric view.

To use View in repair:

  1. Open the Part Studio that has the Derived feature reference, or any other broken reference.

  2. Click the Versions and history icon (Versions and history icon) to open the Versions and history panel.

  3. Right-click on the change where you want the repair to occur, and select View in Repair from the context menu.

    Alternately, click the Repair icon () on the Versions and history panel toolbar, then select the history entry. This must be a point in history where no references were broken (the last known good state). Usually this is the history point immediately before the references broke.

    Selecing View in Repair in the context menu

  4. The Repair panel opens side by side with the current Part Studio on the left and the base reference in the Repair panel on the right:

    Repair panel open on right

  5. Open and repair each feature one at a time. As you repair in the Part Studio (left side), both the Part Studio and Repair panel (right side) are synchronized and updated in tandem. Hovering over a broken reference in the Part Studio also highlights it in the Repair panel (where the reference pointed to prior to it breaking).

    Opening a feature to repair

  6. Make the repairs in the Part Studio until there are no more broken references.

    Fixed feature

  7. Click the Repair panel icon () to close the Repair panel.

Right-click on an empty space in the Repair panel to display a context menu with the following options:

  • Zoom to fit (shortcut: f, double-click scroll wheel) - Select this command or use the shortcut key to zoom the entire model into view. Zooming is synchronized between the Part Studio and the Repair panel; both views are zoomed in tandem.

  • Isometric (shortcut: shift+7) - Displays the model in an angled isometric view. Isometric is synchronized between the Part Studio and the Repair panel; both views are moved in tandem.

  • View in repair can be accessed from any point in history. If using View in repair from one history point does not produce the results you want, try accessing View in repair from an alternate point in the version's history.

  • Using the rollback bar in the Part Studio also rolls back the Repair panel in tandem.

  • Switching configurations is supported. Changing a configuration in the Part Studio updates the Repair manager panel to match the newly selected configuration.

  • To un-sync the View orientation, scaling, and panning between the Repair manager panel and the Part Studio, click the Synchronize view toggle (). View adjustments are now independent in each panel. Click the toggle again to synchronize both panel views.

    • Whether synced or un-synced, adjustments to the rollback bar remain synchronized between both panels.

  • If you delete the active branch while viewing in repair, the Repair panel automatically closes.

  • If you have a part excluded in a section view, the Repair panel does not display the exclusion. All parts sectioned in the Part Studio are sectioned in the Repair panel, even ones that are excluded.

  • Measurements, Analysis tools, Mass properties, and tagged comments are not visible in the Repair panel.

  • The selection color highlight in the Versions and history panel displays in a different color to indicate you are viewing in repair.

  • Reopening the Repair panel opens it to the last remembered state (when it was last opened), unless you access View in repair from the Versions and history panel at a new history point, which overrides the remembered state.