Importing Integrate Packages
Packages can be exported in TORO Integrate. The ZIP archive produced by the export process can be used by other developers in order to gain a copy of the package in another instance. This makes it easy to build your integrations on top of what others have already done. These ZIP files 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, follow the steps below.
- Right click on the instance which will be receiving the copy of the package, select Import from the appearing context menu > Integrate Package. This will make the wizard pop out.
- Fill out the following details in the wizard:
- Integrate Instance - the instance where the package will be copied to; this, by default, is the instance you did a right click on
- File - the archive file of the package
- Start on import - a checkbox indicating whether the package, if successfully imported, should immediately start up or not.
- Click Finish to begin the import process.
- From the main navigation menu, select Import File.
- Browse or drop your package's ZIP archive.
- Tick Start on Import if you want your package(s) to start after the import process is finished.
- Click Import to begin copying the package.
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:
- 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.
- Select Integrate Package from the dropdown menu to show only Integrate packages.
- Optionally, you can use the search bar to help you filter the packages shown in the window.
- Select the package(s) you want to import.
- Select the instance where you want the selected packages to be installed.
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.
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.
- 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.
- Select a package you want to install and simply hit the Download button.
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.