Technical Session:Tau Power Tricks

Greg GormanTau Semi-Guru

With apologies to non-dog-lovers….

a© Telelogic AB

Agenda

• Simple Tricks

– Keyboard shortcuts

– Startup flags

– URN’s

• Medium Tricks

– Drawing shortcuts

– Auto-completion

– Auto-placement

• Advanced Tricks

– Stereotypes and tagged values

– Scripting

– FI Debugger

Simple Tricks

a© Telelogic AB

Workspace Operations

Keyboard shortcutDescription

CTRL + NThen CTRL + TAB to Workspaces tab

Create a new workspace

CTRL + O Open an existing workspace.

MINUS SIGN (-) on the numeric keypad

Contracts the tree of a selected entity.

MULTIPLICATION SIGN (*) on the numeric keypad

Expands the model tree one level below the selec tion. Can be used repeatedly to expand deeper.

PLUS SIGN (+) on the numeric keypad

Expands the selection.

Right/Left Arrow Expand/Contract selection

ALT + 4 Reconfigure Model View, selection of model filter

a© Telelogic AB

Editor Shortcuts (1/2)Arrow key Selects the symbol in the direction of the arrow, re quires current selection

CTRL + <click when placing symbols in di agram>

Allows you to place a number of symbols of the same type. Requires that you first select a symbol from the symbol toolbar.

CTRL + <click when placing symbols in state machine flow>

Allows you to insert a symbol in the flow. Requires that you first select the preceding symbol or flow line in the flow.

CTRL + <click word in diagram> Navigates to definition. If no diagrams contain the definition, the Model Navigator opens.

CTRL + <double-click with a symbol selected in state machine flow>

Selects the entire flow from the selected symbol and downward. Selection will be done on branched flows (multiple signals, decision etc.).

CTRL + <Rotate the wheel button> Scroll the diagram horizontally (requires an Intelli Mouse pointing device)

CTRL + ALT + END Diagram navigation, go down in diagram scope

CTRL + ALT + Page DownCTRL + ALT + TAB

Diagram navigation, navigate to next diagram in di agram scope

CTRL + Arrow key Moves the selected symbol 5 grid steps in the direc tion of the arrow.

CTRL + DELETE Delete from Model, deletes the presentation ele ment and its corresponding model element. If other presentation elements are connected to this model element, they will also be deleted.

CTRL + DIVISION SIGN (/) on the nu meric keypad

Hide all operations. (Valid for signature symbols: class, timer, signal, interface, operation, state ma chine, datatype, enumeration...)

CTRL + F3 Jumps to the next presentation element of the same model element

CTRL + SHIFT + F3 Jumps to the previous presentation element of the same model element

CTRL + MINUS SIGN (-) on the nu meric keypad

Hide all attributes, parameters. (Valid for signature symbols: class, timer, signal, interface, operation, state machine, datatype, enumeration...)

CTRL + MULTIPLICATION SIGN (*) on the numeric keypad

Show operations. (Valid for signature symbols: class, timer, signal, interface, operation, state ma chine, datatype, enumeration...)

CTRL + PLUS SIGN (+) on the numeric keypad

Show attributes, parameters. (Valid for signature symbols: class, timer, signal, interface, operation, state machine, datatype, enumeration...)

CTRL + SHIFT + <click symbol in toolbar> Interaction overview and Activity diagram: Append a symbol and toggle orientation. Symbol posi tion will be in the currently not selected orientation. (Append requires that a symbol is selected.)

a© Telelogic AB

Editor Shortcuts (2/2)CTRL + SHIFT + Arrow key Moves the selected symbol 1 grid step in the direc tion of the arrow.

CTRL + SHIFT + M Open Create Presentation dialog

CTRL + TAB Switches to the next open diagrams

CTRL + U Update Model (requires Active Modeler add-in)

CTRL+ALT + HOME Diagram navigation, go up in diagram scope

CTRL + ALT + Page UpCTRL + ALT + SHIFT + TAB

Diagram navigation, navigate to previous diagram in diagram scope

ESC, DELETE<Right-click canvas>

Aborts line creation

F2 Enters the edit mode on a selected symbol

F4 Moves to the next selection in the Output window

SHIFT + <click symbol in toolbar> Create and append a symbol in the diagram. Sym bols that cannot be auto-created appear dimmed. (Append requires that a symbol is selected.)

SHIFT + Arrow key Selects the symbol in the direction of the arrow and adds it to the selection. (requires current selection)

SHIFT + F4 Moves to the previous selection in the Output window

ALT + UP ARROW Moves a selected node up in the Model View.

ALT + DOWN ARROW Moves a selected node down in the Model View.

SHIFT + ENTER Shows the model element of the selected diagram element in the Model View.

F8 Check the current selection.

CTRL + F8 Do a check of the entire model.

SHIFT + SPACEBAR Auto creation. All elements that can be auto created on the current selection will be displayed. See Auto placement.

CTRL + SPACEBAR Auto insertion. All elements that can be auto in serted after the current selection will be displayed. See Auto placement.

CTRL + R Route selected lines and assign new endpoints.

a© Telelogic AB

Keyboard shortcutDescription

CTRL + SCROLL LOCK

Stops the build process

F5 Launch the current configuration

SHIFT + F7 Generate current configuration

F7 Build the current configuration

SHIFT + F5 Stops the execution

CTRL + F7 Update configuration

Application Builder Shortcuts

a© Telelogic AB

Model Verifier Shortcuts

Keyboard shortcutDescription

ALT + PAUSE Break

ALT + F10 Step local

CTRL + SHIFT + F5 Restart the debug session from the beginning

F5 Go

F9 Inserts/removes a selected breakpoint

F10 Step over

F11 Step into

SHIFT + F10 Next transition

SHIFT + F11 Step out

a© Telelogic AB

Startup Flags

•VCS.EXE (Windows) or tau (Unix)[–Script ScriptName]

[-SuppressSplashScreen]

[ProjectName]

a© Telelogic AB

URN’s

• There are five predefined names, “u2”, “u2user”, “u2useraddins”, “u2teamaddins” and “u2companyaddins”.

– u2 maps to the Tau installation directory

– u2user maps to the user directory

– u2useraddins maps to where user add-ins are located

– u2teamaddins maps to where the team add-ins are located

– u2companyaddins maps to where the company add-ins are located

Medium Tricks

a© Telelogic AB

Drawing Shortcuts

• Varies slightly by editor

– Hold down Ctrl, pallette shows you what symbols are valid in the selected context

– Ctrl-Space is very helpful!

• Class Diagram

• Activity Diagram

• Statemachine Diagram

• Sequence Diagram

– D&D of a signal

a© Telelogic AB

Auto-completion (Intellisense)

• Ctrl-Space pops up a list of elements that are valid in the current context

– Very useful for signals on SD, Class names, etc.

a© Telelogic AB

Reference Existing

• Useful when you want to place a new symbol that references an existing model element

– Remember, using the tool bar and putting in the same name creates a new, distinct element!

– Alternative to drag/drop from Model View

– Activated via right-clickSequence Diagram

Class Diagram

a© Telelogic AB

Auto-Placement

• Available on Statemachine Diagram and Activity Diagram

• Shift-Space activates

• If you have a symbol selected, then press Shift-Space, you are presented with a list of “valid” next symbols. Use the Up/Down Arrows to pick and press Enter. Symbol is placed in line and connected. Next time you press Shift -Space, if it’s valid, the same symbol is pre-selected.

• A super-fast way to block out a diagram!

Advanced Tricks

a© Telelogic AB

Stereotypes and Tagged Values

• Sometimes you want to capture some additional information about elements in the model.

• Example “Review Status” for a Diagram

Create this in your model, drag/drop the ‘Diagram’ element from TTDMetamodel

Apply the stereotype to any diagram

Now you can Query for all Diagrams that are in a certain state!

<<stereotype>>

ReviewStatus

ReviewState:reviewType = "Unreviewed"

<<enumeration>>

reviewType

UnreviewedPeerReviewedApproved

<<metaclass>>

Diagram

0..10..1

/ /Defines the review state of a Diagram

a© Telelogic AB

Scripting

• Create a simple Agent script to print the GUID of any element on demand

<<operation,agent>>

ShowGUID

<<metaclass>>

Element

<<'agent command'>><<'agent command'>>

/ /This agent shows on the "Utilities>" menu when the user right-clicks on a Model Element (not a diagram).

[[proc ShowGUID { triggeredBy timing context server agentParameters } { upvar 1 $agentParameters ap set sel [std::GetSelection] if {$sel == ""} {return} set guid [u2::GetValue $sel guid] std::Output "Name: [u2::GetValue $sel Name], Guid:$guid, Kind:[u2::GetMetaClassName $sel]\n"}]]

a© Telelogic AB

FI Debugger

• Used to examine the detailed metamodel and interconnections between UML elements

• Extremely useful when writing advanced Agents and scripts

• DO NOT use on a daily or “normal” basis

– Very resource-intensive!

• Part of the “SDK” add-in (a separate download)

– Telelogic Support Web>Tau>“Tau Addins” page.

a© Telelogic AB

Questions and Thank You!