Integrate package metadata
Integrate packages were designed to be customizable in order to suit any organization's integration needs. A package has 'meta-fields' that help identify, document, and configure the package's behavior during runtime.
This is used to identify a package within an instance. It must be unique (within the instance) and is required. Only alphanumeric characters, dashes, and underscores are allowed. This property cannot be changed once set.
It's possible to upload a package to the TORO Marketplace to make it publicly available. The TORO Marketplace is TORO Integrate's official platform for sharing integrations, API specifications, individual services, and more. This key will be used to uniquely identify the package there.
This is used to identify your package from its other variants.
Some packages call third-party services that require authentication. This field should be used to indicate where to get the required credentials for those services.
The URL of the documentation page of a package.
The packages that are required for a package to run. A package cannot start when its dependencies are not present. A package is also not allowed to have cyclic dependencies.
Enable Auto Start
A boolean property indicating if a package should automatically be called to start during instance startup.
If this meta-field is set to
true, the package will be available for use during runtime. However, if it is set to
- The package will be stopped and will remain in that state until you enable it. A package cannot be run when it is disabled.
- The package's classloader will not load the Java classes defined in the package.
- The package's services will not be available for use in other packages.
The services that are called when a package is started. Note that when TORO Integrate is starting up, all enabled packages will be started and thus, these services will be called.
The services that are called when a package is stopped. Note that when TORO Integrate is shutting down, all enabled packages will be stopped and thus, these services will be called.
The majority of these meta-fields can be configured via the Package configuration editor, using the following steps:
- Stop the Integrate package you want to configure if it has not been stopped yet.
- In the Coder Navigator view, right click on said Integrate package and click Configure from the context menu. This will launch the Package configuration editor.
- Edit properties as you wish.
- Save your changes by pressing (Coder Studio) or clicking the Save button (Coder Cloud).