Quick Linker Definition Format

A Quick Linker definition is a text file consisting of records terminated by new-line characters. Each record must consist of 23 comma-separated fields, as defined by the table below. The values of each field must not be in quotes (" "). A Quick Linker definition can include comments: all lines that begin with // are ignored by Enterprise Architect.

Each record of the Quick Linker definition represents a single entry on the Quick Linker menu. Some fields define the menu command; some fields can be thought of as filters, with the entry being ignored if the filter condition isn't met.

A Quick Linker definition has the following fields.

Column

Field

Description

A

Source Element Type

The row is ignored unless a connector is being dragged away from this type of element.

B

Source Stereotype Filter

If set, the row is ignored unless a connector is being dragged away from an element with this stereotype.

C

Target Element Type

If set, the row is ignored unless a connector is being dragged onto this type of element.

If blank, the row is ignored unless a connector is being dragged onto an empty piece of diagram.

D

Target Stereotype Filter

If set and Target Element Type also set, the row is ignored unless a connector is being dragged onto an element with this stereotype.

E

Diagram Filter

Contains either an inclusive or exclusive list of diagrams, which limits the diagrams the given kind of connector can be included on.

Each diagram name is terminated by a semi-colon. Excluded diagram names are preceded by an exclamation mark.

Example of an inclusive list: Collaboration;Object;Custom;

Example of an Exclusive list: !Sequence;

F

New Element Type

If set and Create Element also set, results in the creation of an element of this type.

G

New Element Stereotype

If set and Create Element also set, results in the creation of an element with this stereotype.

H

New Link Type

If set and Create Link also set, results in the creation of a connector of this type.

I

New Link Stereotype

If set and Create Link also set, results in the creation of a connector with this stereotype.

J

New Link Direction

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 option).

Note:

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

K

New Link Caption

If a new connector is being created but not a new element, then this is the text that appears on the context menu.

L

New Link & Element Caption

If a new connector AND a new element are being created, then this is the text that appears on the context menu.

M

Create Link

If set to TRUE, results in creation of a new connector; otherwise should be left blank.

N

Create Element

If set to TRUE the row is ignored unless a connector is being dragged onto an empty piece of diagram and results in creation of a new element; otherwise should be left blank.

This overrides the values of Target Element Type and Target Stereotype Filter.

O

Disallow Self connector

Should be set to TRUE if self connectors are invalid for this kind of connector; otherwise should be left blank.

P

Exclusive to ST Filter +No inherit from Metatype

If set to TRUE, indicates that elements of type Source Element Type with the stereotype Source StereotypeFilter do not display the Quick Linker definitions of the equivalent unstereotyped element.

Q

Menu Group

If set, indicates the name of a sub-menu in which a menu item is created.

R

Complexity Level

Not implemented, always set to 0.

S

Target Must Be Parent

If set to TRUE this menu item only appears when dragging from a child element to its parent; for example from a port to its containing Class.

T

Embed element

If set to TRUE the element being created is embedded in the target element; otherwise should be left blank.

U

Precedes Separator LEAF

If set to TRUE results in a menu separator being added to the Quick Linker menu; otherwise should be left blank.

V

Precedes Separator GROUP

If set to TRUE results in a menu separator being added to the Quick Linker sub-menu; otherwise should be left blank.

W

Dummy Column

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

The material ("material" includes all pages, documents and on-line graphics) on this web site is protected by copyright law. (C) 1998-2010 Sparx Systems Pty Ltd.