Skip to content

Home

Development

IDEs

API Explorer

Releases

Release notes

Martini Runtime

Martini Desktop

Martini Online

Feature requests

Bug reports

Familiarizing with the user interface

There are three user interfaces you can use to interact with Martini. These are the Runtime Admin, Martini Online, and Martini Desktop interfaces.

The Martini Runtime Admin interface is a web-based interface typically used by system administrators to configure the behavior of Martini instances. Meanwhile, Martini Desktop and Martini Online are used by developers to create and manage their organization's services, APIs, and other applications1.

Below are screenshots of the commonly seen parts these interfaces, annotated and described so that you can easily identify specific sections and their purpose.

User interface

  • 1 Navigator view

    Displays connected instances2, their packages, existing database connections, and reports. Right clicking on any of the items in the tree shows the list of possible actions which can be executed based on the current context. Double clicking, on the other hand, opens the editor for the selected file so that it can be modified using its corresponding editor.

  • 2 Toolbar

Contains a variety of tools that help trigger actions such as, but not limited to:

1
2
3
4
5
6
7
- Opening a wizard
- Running or debugging the service in focus
- Opening the [Martini service manager][service-manager]
- Opening the Marketplace dialog, which can be used to download items from the [TORO Marketplace][marketplace]
- Opening the team workspace
- Opening the [Tracker][tracker] view
- Opening the [HTTP Client][http-client]
  • 3 Editor

The editor allows you to view and modify the contents of the opened file. Which editor gets displayed depends on the type of file opened. For example, opening a Gloop service will open the Gloop service editor; a Flux file, the Flux service editor, etc. Every time you open a file, a new tab for the file will be added, making it easier to switch between opened files.

1
2
3
4
5
In most cases, a mini toolbar will also be visible; the tools available in this mini toolbar are intended to
help you build the service, API, endpoint, etc.

At the bottom of the editor, sometimes another set of tabs will be visible. These tabs help you switch between
the available presentation views for the file.
  • 4 Properties view

The Properties view will be populated when certain items in the user interface are clicked or are in focus. For example, when a property is clicked (either from the Input/Output view or the Mapper view), the properties of that variable will appear on a table in the Properties view. When a service is in focus, the general properties of that service will appear in the Properties view.

  • 5 Input/Ouput view

The Input/Output view, like its name implies, shows the inputs and outputs of a service. In Gloop or Flux, these inputs or outputs can be strings, integers, models, and other Gloop data types.

  • 6 Mapper view

The Mapper view is typically used in Gloop and Flux services to view and configure mappings. A mapping, simply put, is the setting of a variable or property's value. If you're viewing a Gloop service, click on any of its map steps or invoke steps and then switch to the Mapper view to see that particular step's mappings.

  • 7 Console view

    The Console view shows the latest stream of logs from a Martini Runtime.

  • 8 Perspectives

Perspectives are an arrangement of views and editors. You can switch between perspectives but only one perspective is active at any point in time. The active perspective also controls what appears in some menus.

  • 9 Quick Access

    Allows you to search and access various application functionalities like opening views or wizards, execute actions or even search for help. Can be also triggered via shortcut.

I messed up Martini's layout. How do I reset it?

Missing views and menus, jumbled layout - has this ever happened to you? Fortunately, Martini Desktop makes it easy to go back to the default perspective. At the top right hand side of Martini Desktop's window:

  1. Right click on the active perspective icon.
  2. From the appearing context menu, select Reset.
  3. A dialog will appear to confirm your action; choose Reset Perspective.

Resetting Martini's current perspective

User interface

  • 1 Navigator view

    Displays the connected instance,

their packages, existing database connections, and reports. Right clicking on any of the items in the tree shows the list of possible actions which can be executed based on the current context. Double clicking, on the other hand, opens the editor for the selected file so that it can be modified using its corresponding editor.

1
- **2** Toolbar

Contains a variety of tools that help trigger actions such as, but not limited to:

1
2
3
4
5
6
7
8
    - Opening a wizard
    - Running or debugging the service in focus
    - Opening the [Martini service manager][service-manager]
    - Opening the Marketplace dialog, which can be used to download items from the [TORO Marketplace][marketplace]
    - Opening the team workspace
    - Opening the [Tracker][tracker] view

- **3** Editor

The editor allows you to view and modify the contents of the opened file. Which editor gets displayed depends on the type of file opened. For example, opening a Gloop service will open the Gloop service editor; a Flux file, the Flux service editor, etc. Every time you open a file, a new tab for the file will be added, making it easier to switch between opened files.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
    In most cases, a mini toolbar will also be visible; the tools available in this mini toolbar are intended to
    help you build the service, API, endpoint, etc.

    At the bottom of the editor, sometimes another set of tabs will be visible. These tabs help you switch between
    the available presentation views for the file.

    ??? tip "Working with multiple tabs"
        Organize your editor tabs easily by dragging a tab to any side of the current editor.
        Once your tab is docked, you can also resize it and switch its layout direction.

        ![Martini's Splitting Tabs][coder-splitting-tabs]

- **4** Properties view

The Properties view will be populated when certain items in the user interface are clicked or are in focus. For example, when a property is clicked (either from the Input/Output view or the Mapper view), the properties of that variable will appear on a table in the Properties view. When a service is in focus, the general properties of that service will appear in the Properties view.

1
- **5** Input/Ouput view

The Input/Output view, like its name implies, shows the inputs and outputs of a service. In Gloop or Flux, these inputs or outputs can be strings, integers, models, and other Gloop data types.

1
- **6** Mapper view

The Mapper view is typically used in Gloop and Flux services to view and configure mappings. A mapping, simply put, is the setting of a variable or property's value. If you're viewing a Gloop service, click on any of its map steps or invoke steps and then switch to the Mapper view to see that particular step's mappings.

1
2
3
4
5
- **7** Console view

    The Console view shows the latest [stream of logs][application-logs] from the Martini Runtime.

- **8** Perspectives

Perspectives are an arrangement of views and editors. You can switch between perspectives but only one perspective is active at any point in time. The active perspective also controls what appears in some menus.

1
2
3
4
5
6
7
8
9
??? tip "Familiarize yourself with the interface faster using Martini Online's guided tours"
    There are four tours you can take:

      - User interface tour; 
      - Flux tour; 
      - Gloop tour; and 
      - Groovy tour.

    ![Martini's guided tours][coder-guided-tour-user-interface]

User interface

  • 1 Main navigation menu

    This menu allows you to visit the different pages of the Server Admin interface. It can be collapsed or uncollapsed using the menu icon at the top and on the left of the Tracker search bar.

  • 2 Tracker/Monitor search bar

    You can use this text-field to find Tracker or Monitor documents. You can either use just the text-field, or the advanced search form (opened by clicking on the inverse arrow at the right-hand side of the text-field) to enter your query. Submitting your query will redirect you to the Tracker or Monitor documents page where any matching documents will appear. An empty query will show all documents. You can select whether to query the Tracker search index or Monitor search index by clicking on the Tracker or Monitor label on the left-hand side of the search text-field.

  • 3 Notifications

    Shows the notifications sent to your account; these notifications are typically from the TORO Marketplace and display your account or organization's most recent activities.

  • 4 Extensions and plugins

    Shows the TORO Marketplace items you can download or install.

  • 5 Restart or shutdown

    A menu for restarting or shutting down your Martini instance. This button is not visible on instances running on TORO Cloud.

  • 6 Account information

    A menu item showing the status of the currently logged in user. A green circle indicates that you are authenticated with the TORO Marketplace, whilst red indicates that you are only authenticated locally.

  • 7 Page content

    Shows the content of the Server Admin page you are visiting.

Tip of the day

Martini Desktop and Martini Online both have a 'tip of the day' feature which presents useful tips and tricks so you can develop your applications faster.

Tip of the day

Tip of the day


  1. Although Martini Online and Desktop can also be used to perform certain configuration and administrative changes. 

  2. Martini Desktop allows developers to connect to multiple Martini instances; contrary to Martini Online which only displays the details of the instance it is coupled to.