Navigating in the UP application

In UP, it's easy to get lost in the various windows and views. So here are a few tricks on how best to navigate.

Breadcrumb navigation

Using the breadcrumb navigation, you can see the nesting of the current object at first glance:

...

By clicking on one of the nesting levels, you can display the corresponding enveloping resource without leaving the actual resource focus:

...

Help, take me back to where I came from!

It can happen that you click on a resource without the intention of leaving the current focus.

ALT+LEFT brings you back step by step.

Open Diagrams

UP has various types of diagrams to better illustrate the application. There are several ways to open these diagrams.

Open Controller Tree Diagram

Method 1 (via context menu):

...

Method 2 (via diagram resource):

...

Open State Machine Diagram

Method 1 (via context menu):

...

Method 2 (via diagram resource):

...

Method 3 (double-click on the controller instance in the controller tree):

...

Perspectives

Reset Perspective

UPstudio has a standardised view setting (Perspective) for all windows. If a view is accidentally closed or moved, it can be reset to the original setting by right-click on the UP icon in the top right:

...

Save Perspective

You can also save your own settings via the above menu.

Project Explorer

When creating a new workspace, the standard view of the project packages is flat. To obtain a hierarchical view, this can be changed in the Project Explorer settings:

...

Search

Search for references

With the reference search, all uses of an object are listed in the search field. Double-clicking takes you to the relevant location.

...

Search and Replace

In UP, all resources are represented by a unique GUID. Wherever a resource is used (e.g., a local variable is placed in a code snippet), the respective GUID is referenced in the background.

The GUID of each resource can be read via contex menu:

...

For example, to replace one variable with another, the GUID of the old variable must be replaced with the new GUID at all uses. To do this, you first search for the location of the old variable using the 'File Search':

...

The usage windows appear in the search window. Double-click on the corresponding locations in the resource editor.

...

By selecting and using the right mouse button, the GUID can be replaced with the GUID of the new variable in the selection:

...