Skip to content

Home

Development

IDEs

API Explorer

Releases

Release notes

Martini Runtime

Martini Desktop

Martini Online

Feature requests

Bug reports

Importing Martini packages

Packages can be exported and imported in Martini. Files produced by the export process, which are plain ZIP files, can be used by other developers (or other Martini instances) in order to obtain copies of a package. These Zip files are simply your packages, as they were on the file system, but compressed. A single Zip file can also contain multiple packages, when exporting more than one at a time. There are a few ways in which a package can be imported to a Martini instance, which are described below.

From the file system

To import a package from an existing ZIP file, launch the package import wizard, and follow the steps below.

Importing a package

Importing a package

  1. Right click the instance which will be receiving the copy of the package. Select Import > Martini Package from the appearing context menu. This will make the wizard appear.
  2. Populate the following details in the wizard:
    • Martini Instance - the instance where the package will be copied to; this, by default, is the instance you right clicked on
    • File - the archive file of the package(s)
    • State on Import - the desired state of the package(s), upon successful import
    • Replace Existing - a checkbox indicating whether the package to be imported should replace an existing package of the same name
  3. Click Finish to begin the import process.

From the Marketplace

The TORO Marketplace is TORO's official platform for sharing applications, services, and APIs — Martini packages included. To import packages from the TORO Marketplace, do the following:

Steps on how to import packages from the Marketplace dialog

  1. To launch the Marketplace dialog, click the Marketplace icon from the toolbar. It's also possible to access the Marketplace dialog under the Help menu.
  2. Select Martini Package from the dropdown menu to show only Martini packages.
  3. Optionally, you can use the search bar to help you filter the packages shown in the window.
  4. Select the package(s) you want to import using checkboxes.
  5. Select the instance where you want the selected packages to be installed.
  6. Click the Install button at the bottom of the dialog. Another dialog for configuring your installation items will appear. Since only scripts and API schemas are configurable, we won't need to do anything; just click Finish.

Give Martini a good few seconds to install your packages. If all goes well, you should be able to see your newly imported package(s) in the Navigator view. However, it's also possible for your installation to fail. When this happens, a dialog will be shown to let you know what went wrong.

Steps on how to import packages from the Marketplace dialog

  1. To launch the Marketplace dialog, click the Marketplace icon from the toolbar.
  2. Select Martini Package from the dropdown menu to show only Martini packages.
  3. Optionally, you can use the search bar to help you filter the packages shown in the window.
  4. You can set the number of shown packages through the Limit dropdown menu.
  5. Select the package(s) you want to import using checkboxes.
  6. Click Install.
  7. In the appearing dialog, configure your package import settings and once done, click the Finish button.

Give Martini a good few seconds to install your packages. If all goes well, you should be able to see your newly imported package(s) in the Navigator view. However, it's also possible for your installation to fail. When this happens, a notification will be shown to let you know what went wrong.

A modal showing the TORO Marketplace items available for you to download

  1. Click the inbox icon located on the top-right side of the UI. This will launch a modal showing the extensions and plugins available for you to download.
  2. Select a package you want to install and click the Download button.

Namespace conflicts

Be wary of namespace conflicts. A namespace conflict occurs when two files (including those from different packages) have the same file extensions and namespace, regardless of character case.

If you try to import a package that will induce namespace conflicts, that package will be disabled and will remain disabled until the namespace conflicts have been resolved.

From your team workspace

You can share API schemas, scripts, and Martini packages across your organization through the team workspace. To import packages from your team workspace, do the following:

Importing packages from the team workspace

  1. Click the team workspace icon from the toolbar. This will launch the Team Workspace dialog. As an alternative, you can also access this dialog under the Help menu.
  2. Select Martini Package from the Type dropdown menu to show only Martini packages.
  3. Optionally, you can use the search bar to help you filter the packages shown in the dialog.
  4. Select the package(s) you want to import using checkboxes.
  5. Select the instance where you want the selected package(s) to be installed.
  6. Click Install. Another dialog for configuring your installation items will appear. Since only scripts and API schemas are configurable, we won't need to do anything; just click Finish.

Importing packages from the team workspace

  1. Click the team workspace icon from the toolbar. This will launch the Team Workspace dialog.
  2. Select Martini Package from the Type dropdown menu to show only Martini packages.
  3. Optionally, you can use the search bar to help you filter the packages shown in the dialog.
  4. Select the package(s) you want to import using checkboxes.
  5. Click Install.

Give Martini a good few seconds to install your packages. If all goes well, you should be able to see your newly imported package(s) in the Navigator view. However, it's also possible for your installation to fail. When this happens, a notification will be shown to let you know what went wrong.