Quick Linker Definition Format

In order to replace or change the Quick Linker menus that are displayed when a user drags the Quick Linker arrow from one of your profile elements on a diagram, you can create or edit the corresponding Quick Linker definition. This is a Comma Separated Value (CSV) text file consisting of records (rows), each record consisting of 23 comma-separated fields as defined in the table below. Some of these fields define the menu command and some act as filters, with the entry being ignored if the filter condition isn't met. A Quick Linker definition can include comments: all lines in which // are the first two characters are ignored by Enterprise Architect. Quotes (" ") in the field values are not required.

Each record of the Quick Linker definition represents a single combination of entries on the Quick Linker menus; that is, for the selected source element, a specific connector type and specific target element type. A menu is populated from all rows that satisfy the filters; that is, the first menu lists all defined connectors that are legal and valid for the source element type, and the second menu lists all target elements that are legal and valid for the combination of source element and connector type.

Quick Linker Definition fields

Column

Title (enter as comment for guidance)

Description

A

Source Element Type

Identifies a valid source element in the Profile; if a connector is being dragged away from this type of element, the row is evaluated. Otherwise, the row is ignored.

 

B

Source Stereotype Filter

Identifies a stereotype of the source element base type (for example, an Event source element can be a normal Event, or a Start Event, Intermediate Event or End Event stereotyped element).

If set, and if a connector is being dragged away from an element of this stereotype, the row is evaluated. Otherwise, the row is ignored.

 

C

Target Element Type

Identifies a valid target element in the Profile.

If set, and if a connector is being dragged onto this type of element, the row is evaluated.

If blank, and if a connector is being dragged onto an empty space on the diagram, the row is evaluated.

Otherwise the row is ignored.

 

D

Target Stereotype Filter

Identifies a stereotype of the target element base type.

If set, if Target Element Type is also set, and if a connector is being dragged onto an element of this stereotype, the row is evaluated. Otherwise, the row is ignored.

 

E

Diagram Filter

Contains either an inclusive list or an exclusive list of built-in diagrams, which limits the diagrams the specified connector can be created on.

Each diagram name is terminated by a semi-colon; for example: Collaboration;Object;Custom;
Each excluded diagram name is preceded by an exclamation mark; for example: !Sequence;

 

F

New Element Type

Defines the type of element to be created if the connector is dragged into open space, provided that the Create Element field is set to TRUE.

 

G

New Element Stereotype

Defines the type of element stereotype to be created if the connector is dragged into open space, provided that the Create Element field is set to TRUE.

 

H

New Link Type

Defines the type of connector to create, if Create Link is also set to TRUE.

 

I

New Link Stereotype

Defines the type of connector stereotype to correct, if Create Link is also set to TRUE.

 

J

New Link Direction

Defines the connector direction, which can be:

directed (always creates an association from source to target)
from (always creates an association from target to source)
undirected (always creates an association with unspecified direction)
bidirectional (always creates a bi-directional association), or
to (creates either a directed or undirected association, depending on the value of the Association Direction field)

 

Not all of these work with all connector types; for example, you cannot create a bi-directional Generalization.

 

K

New Link Caption

Defines the text to display in the Quick Linker menu if a new connector is being created but not a new element.

 

L

New Link & Element Caption

Defines the text to display in the Quick Linker menu if a new connector AND a new element are being created.

 

M

Create Link

If set to TRUE, results in the creation of a new connector; leave blank to stop the creation of a connector.

 

N

Create Element

If set to TRUE and a connector is being dragged onto an empty space on the diagram,results in the creation of a new element.

Leave blank to stop the element from being created. This overrides the values of Target Element Type and Target Stereotype Filter.

 

O

Disallow Self connector

Set to TRUE if self connectors are invalid for this kind of connector; otherwise leave this field blank.

 

P

Exclusive to ST Filter +
No inherit from Metatype

Set to TRUE to indicate that elements of type Source Element Type with the stereotype Source Stereotype Filter do not display the Quick Linker definitions of the equivalent unstereotyped element.

 

Q

Menu Group

Indicates the name of the submenu in which a menu item is created.

 

R

Complexity Level

Not implemented, always set to 0.

 

S

Target Must Be Parent

Set to TRUE if the menu item should only appear when dragging from a child element to its parent; for example, from a Port to its containing Class. Otherwise leave this field blank.

 

T

Embed element

Set to TRUE to embed the element being created in the target element; otherwise  leave this field blank.

 

U

Precedes Separator LEAF

Set to TRUE to add a menu item separator to the Quick Linker menu, underneath this entry; otherwise leave this field blank.

 

V

Precedes Separator GROUP

Set to TRUE to add a menu item group separator to the Quick Linker sub-menu; otherwise leave this field blank.

 

W

Dummy Column

Depending on which spreadsheet application you use, this column might require a value in every cell to force a CSV export to work correctly with trailing blank values.

 

Learn more