en:tast_canvas_2.0 [TAST DokuWiki ]

User Tools

Site Tools


Sidebar

First steps in TAST

What is UML

Computer setup for TAST use

FAQ

Recognized Issues

TAST tool Menu

TAST Adaptors

Adaptors examples

TAST Integrations

Interesting features

Documentation of technical administration

Modeling recommendations

Training in the TAST tool

en:tast_canvas_2.0

This is an old revision of the document!


TAST Canvas 2.0

TAST has an important feature: the Canvas, which is a place where the user can paint the UML diagrams.

Actually, the Using TAST workflow starts from its Canvas.

Currently Canvas/Modeling 2.0 does not support Internet Explorer due to IE is a discontinued product. Other Web browsers; Chrome, Edge and Firefox are compatible with Canvas 2.0.

You can launch the Canvas from several places:

  • Creation of a new UML Diagram.
  • Editing an existing Diagram.
  • Navigation from several places of TAST to consult a diagram.



Top toolbox

The image above shows (highlighted in red), the top toolbox with the following options:

  • Create a New Diagram: for creating a UML diagram.
  • Import a Selenium IDE Record: for importing an IDE record from Selenium.
  • Import a Diagram: for importing an existing diagram, but from another environment to our current environment.
  • Export a Diagram: for exporting a diagram to be used on another environment, but also into TAST.
  • Lock/unlock a diagram.
  • Save a diagram.

Bottom toolbox

Once a diagram has been edited, a second toolbar will be displayed to facilitate interaction with the diagram.


Design Tools

It contains the different objects that can be drawn in the Canvas 2.0.


Each time an option is selected, the Cursor changes according to the type of object to be drawn. Instead of selecting the tools from here, you can also use the respective keyboard shortcuts (see help screen on the “Show canvas help” button).
Note about drawing cursors: All cursors have an active “hotspot” (point where the cursor acts). In the case of message drawing cursors, the hotspot is the tip of the arrow.

Delete Elements

Allows you to delete the object or objects of the diagram that have been selected.


You have 2 possible options: Delete elements, and Delete elements and variables. Items can also be deleted using the “Delete” option from the contextual menu.
Note: This action can be reversed using the “Undo” option from the contextual menu.

Diagram Actions

Groups a series of actions that can be performed at the diagram level.

  • Move to superior position: Moves the diagram to the top position of the canvas and restores the initial zoom (scale to 1:1).
  • Move to inferior position: Moves the diagram to its position at the bottom and restores the initial zoom (scale to 1:1).
  • Redistribute auto ítems: Allows you to redistribute the objects of a diagram so that there is an equidistant space between them (only vertically).
    Note: This action can be reversed using the “Undo” option from the contextual menu.

Assistants

Shows available assistants:

View Diagram Map

By clicking this button, it displays a thumbnail of the current diagram (at a scale of 4:1) which will appear in a box at the top right corner of the Canvas.


This thumbnail display is especially useful with large diagrams. It contains a “magnifying glass” (represented by the blue rectangle that appears above the thumbnail), and its size is proportional to the Canvas of our monitor in each case. Moving said “magnifying glass” allows us to “focus” on the area of the diagram that we want to visualize, and the real diagram will move accordingly, showing the area highlighted by the magnifying glass.

Any movement or change in the actual diagram is reflected in the thumbnail and vice versa.

While we have the diagram map visible, the zoom in/zoom out of the real diagram will be inoperative, so that the aspect ratio of both diagrams -real and thumbnail- is not affected.

If we want to hide the diagram map, just press the button again.

Magnifying glass

It allows you to carry out free text searches in all the elements of the diagram, and it also allows you to limit the searches on those elements that interest you at a given moment.

When you press the Magnifying glasss button, a small search form appears at the top of the canvas, consisting of the following elements:


  • An editable field where to enter the string to search for. In this field we can also include directives to narrow the search (explained later).
  • Button to clear the search string.
  • “Magnifying glass” button to start the search.
    Note: You can also press the Enter key in the editable field to start the search.
  • Field where the number of elements found is displayed. The current element is also shown in this field once we go through the elements with the “up” and “down” buttons.
  • “up” and “down” buttons, which allow us to browse, display and position ourselves in the diagram within the search result elements.
  • Button to close the search form.

Perform free text searches

Once we enter the string to search for, and pressing the Enter key or the Magnifying glass button on the form, all the elements of the diagram that contain said string will be searched for, in any of its fields.
The search is “case insensitive” (It doesn't matter if uppercase or lowercase).
If elements containing the string have been found, they will initially all appear highlighted in orange in the diagram.
To move between the different elements found in the diagram, we can use the “up” and “down” buttons.

Note: If we also have the properties form open, we will see the properties of each element as we scroll through them.

Narrow the search by element types

If instead of searching globally in all the elements of the diagram, we want to limit the search by restricting it to one or more types of elements, we can do it using the following nomenclature, which consists of putting one or more keywords (separated by the comma character ', ') and then the text to search for (separated by the colon character “:”), such that:

Key1, key2, key3: text_to_find

For example, if we want to search for the string “pdf” only in messages, we will write the keyword “message”, then “:”, and followed by the text to search for:


Or if we want to search for text “OUTPUT” only in messages and in adapters:


The list of keywords to narrow searches by item type is:

  • adaptor
  • message
  • gate
  • fragment
  • subtestcase

Narrow the search by content type

Likewise, we can limit searches, depending on whether we want to search in the properties of the elements or in their mapping. They can be combined with the previous dimensions.
For example, if we want to search for the text “pdf” only in the mapping of adapters and messages, the string to enter in the search field will be:


The list of keywords to narrow searches by content type is:

  • properties, props
  • mapping

Reload repositories

It allows to reload YML TXT files, which contain a series of keys that can be used in the diagrams.

Download diagram image

In this case, the image is generated “on the fly” just as the current diagram is, that is, a preview of the diagram is created and downloaded to a .png file.

Validate mapping

It works the same way as in the previous canvas.

Launch validation

It works the same way as in the previous canvas.

Show canvas help

Selecting this last option:
a model with 3 tabs appears, where the basic canvas help is displayed:

  • “Keyboard shortcuts” Tab.
    It shows all the keyboard shortcuts that are equivalent to actions carried out either through menu options or buttons.
  • “Global variables” Tab.
    Shows the standard global variables available in any diagram.
  • “Color Guide” Tab.
    It refers to the different colors that we can now find in the objects of the diagram.



Canvas functionality

When we move the mouse across the canvas, the cursor changes to the “hand” icon when hovering over some of the Canvas objects.
The Canvas moves freely in all directions. By clicking and dragging the mouse, over any “empty” place on the canvas (that is, across any area that does not have an object) we will move the canvas in the desired direction.
The diagram can be moved whether the diagram is locked (cannot edit, padlock “closed”) or unlocked (it can be edited, padlock “open”).

Zoom in/Zoom out

The zoom of the diagram is free. It is done by sliding the “Wheel” of the mouse. It also works in this way when using a laptop trackpad:

  • Wheel forward: zoom in (distance, smaller diagram).
  • Wheel back: zoom out ( bring closer, larger diagram).

Also, the zoom is now relative to the point where the cursor is (scrolling the wheel forwards or backwards will make the diagram bigger or smaller in the direction of the point where the cursor is).
The zoom is no longer a relevant fact when saving or opening the diagram: when opening the diagram, the zoom (or rather, the scale) is always 1:1, that is, initially it is always displayed as real size.
You can use the zoom whether the diagram is locked (cannot edit, padlock “closed”) or unlocked (it can be edited, padlock “open”).

Selection of objects in the Canvas

By Selecting an object, we can then perform other actions with it (eg delete it, etc.)

Simple selection

To select an object in the canvas, just click on the object (in any of its parts, including the text). To deselect it, just click on an “empty” area of the canvas.

Multiple selection

To select several objects in the canvas, we will press shift-click on the different objects that we want to select.
This allows us to perform actions on that group of selected objects (eg delete them, move them, copy them, etc.)
To deselect them, just click on an “empty” area of the canvas. In multiple selection there is no limitation regarding the type of selected objects. All types of objects can be selected at the same time (messages, gates, fragments…).

en/tast_canvas_2.0.1649343295.txt.gz · Last modified: 2022/04/07 14:54 by montse