Skip to main content

How to create a reference by drawing between components in a viewpoint

Create a reference in a viewpoint by drawing a line from one component to another.

J
Written by Jonas Laberg

This guide shows you how to create a reference in a viewpoint by drawing a line from one component to another.

Prerequisites

  • You are working in a viewpoint. This isn't available in workspaces or in the presentation viewer.

Steps

1. Start the gesture

Right-click the component you want to connect from, and select Draw reference.

2. Drag to the target

Drag from the source component to a component on the canvas or in the navigator tree. A curved line follows your pointer. Components you can connect to stay bright while the rest of the view dims. The cursor changes over a valid target. Over an invalid one, a tooltip says No reference types available between these components.

3. Choose the reference type

Release on the target. A list of reference types opens. Each option reads
​Source component → Reference type → Target component.

  • Types used in the current viewpoint come first. Other types are listed under Reference types not in the view.

  • References that already exist are greyed out and marked Exists.

  • The arrow always points left to right. If you dragged against the direction of the reference, the component names swap places.

  • If the two components share a name, their component types are added so you can tell them apart.

4. Confirm

Select an option. The reference is created immediately, with no confirmation step.

(Closed beta) Search for a component not in the view

If your organization is in the beta, selecting Draw reference also opens a search box in a panel on the right side of the screen. If you want to create a reference to a component not currently loaded in the view, start typing a component name. You don't need to click the search box first. Matching components are listed under their parents, so you can see where each one sits. The results cover your whole organization, not just the current view. While you search,

the line to your source component turns grey and stays attached.

You can also select a parent component from the results. Selecting a result opens the same list of reference types as in step 3. If the component you searched for gives no reference type options, your metamodel doesn't allow a reference from this source to that component.

Want to try it? Contact customer support.

Verify it worked

A confirmation message appears. The new reference shows in the viewpoint along with the components that are linked to.

Things to know

  • The reference is saved in the workspace that holds the source component. You need edit permission there, and it must define the reference type.

  • Only reference types allowed by your metamodel are offered.

  • You can only drag to components on the canvas or in the navigator. To connect to a component that isn't there, use the Create references panel.

  • The gesture starts from the right-click menu, so it isn't keyboard accessible. Use the Create references panel for keyboard-only creation.

Common issues

  • "No reference types available between these components." No allowed reference type connects these two component types, or you can't edit the owning workspace.

  • A reference type is greyed out with "Exists". That reference is already there, including ones outside the current view.

  • Draw reference isn't in my right-click menu. The feature may not be enabled for your organization. Contact support.

Related articles

Did this answer your question?