Use Foundry DevOps to include your Workshop applications in Marketplace products for other users to install and reuse. Learn how to create a Marketplace product..
All generally available Workshop features are supported for packaging, with the exception of static/object-backed scenarios.
To add a Workshop application to a product, first create a product and then select the Workshop content type as below.
Once you select your application, if you receive any error messages, visit the packaging error linter for more information. We recommend enabling the linter before attempting to package your application.
If you have created a Workshop application that you would like to include as part of a Marketplace product, enable Installation configuration in the Workshop settings as below, which provides additional features for debugging packaging errors when creating your product and creating Installation parameters to expose during installation.
In order to successfully package a Workshop application, DevOps must be able to successfully identify all application dependencies, such as the object types that are used in the application. Once you’ve enabled Installation configuration, any errors will be surfaced in the top right corner of your application next to warnings.
Note that there may be some (~5-10 seconds) latency for errors to appear depending on the size of your application. If no errors are present, nothing will appear.
It is generally a best practice to enable the linter and check for errors before attempting to package your application in DevOps. If you attempt packaging before enabling the linter, you will be directed to use the linter if there are any unresolved issues.
Common errors that are surfaced by the linter include:
After enabling Installation configuration, a new panel will appear under Settings. Two types of installation parameters are configurable from this panel: string
and boolean
parameters.
Use string
parameters to allow for customization of content like application titles at installation time. For example, you can use a string
parameter to allow installers to customize the application with their organization’s name when installing your product.
Use boolean
parameters to show/hide content based on installer preferences. For example, you can use a boolean
parameter to allow installers to show a specific chart in the application when relevant.
Once you’ve created your installation parameters, you can connect the parameters to Workshop variables.
When other users install your product, these parameters will be surfaced as inputs.