Skip to content

Importing Integrate Packages

Packages can be shared in TORO Integrate. This gives you the ability to build your integrations on top of what others have already made. As of the moment, TORO Integrate can only extract packages from ZIP files. These are simply your packages, as they were in the file system, but compressed. A single ZIP file can contain multiple packages.

From the File System

To import a package, you must have the ZIP file for it. This guide assumes that you already do. In order to launch the Package Import wizard, simply follow the steps below.

  1. Go to the Coder Navigator view.
  2. Right click your target instance.
  3. Select Import and then click on Integrate Package. This will launch the Package Import wizard. Calling the *Package Import* wizard
  4. Select the instance where you want to install the packages, if not it's not pre-selected or if you wish to change the pre-selected instance.
  5. Browse or drop your zip file.
  6. Tick Start on Import if you want your packages to start after the import process is finished.
  7. Click Finish. The *Package Import* wizard
  1. Click Import File from the navigation bar. Calling the *Package Import* wizard
  2. Browse or drop your zip file.
  3. Tick Start on Import if you want your packages to start after the import process is finished.
  4. Click Import. The *Package Import* wizard

From the Marketplace

The TORO Marketplace is TORO's official platform for sharing integrations and the like — packages included. To import packages from the TORO Marketplace, simply 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 the fifth icon from the left. It's also possible to access the Marketplace dialog under the Help menu.
  2. Select Integrate Package from the dropdown menu to show only TORO Integrate 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.
  5. Select the instance where you want the selected packages to be installed.
  6. Click Install. Another dialog for configuring your installation items will pop-up. Since only scripts and API schemas are configurable, we're not going to do anything special – simply click Finish and give TORO Integrate a good few seconds to install your packages. Packages cannot be configured, as seen in the configuration dialog for Marketplace items If all goes well, you should be able to see your newly imported package(s) in the Coder Navigator view. However, it's also possible for your installation to fail. When this happens, a pop-up dialog will be shown to indicate the error.
  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 simply hit the Download button. A modal showing the TORO Marketplace items available for you to download

Warning

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.