Using Extensions
You can create extensions for Flogo Enterprise or you can upload a Project Flogo extension into Flogo Enterprise.
You can create and contribute extensions for the following:
- activities
- triggers (you can define custom triggers that you can upload and use to create a flow)
- connectors (a connector provides configuration details to connect external apps, for example, Salesforce)
- functions (to be used inside the mapper when mapping elements)
- custom category extensions
After creating your extension, you upload its
.zip
file using the upload dialog box.
The extension you upload must follow the guidelines found on the GitHub page, Building Extensions.
Important Considerations
Keep the following in mind before you upload your extension:
- A read-only user cannot upload an extension.
- When uploading your Activity or trigger extension, by default
Flogo Enterprise compiles your extension before uploading it. If you would like to skip the compilation process, make sure to compile all the
*.ts
files in your extension and generate a.js
file for each.ts
file. The.js
file must have an identical name as its corresponding.ts
file. - You are responsible for the life cycle (uploading, updating, deleting) of the extension that you contribute. Any extension that you contribute is visible and available for use only to you.
- When creating your Activity or trigger extension, if you did not specify a category for the extension, the extension is placed in the Default category.
- The category name for an extension must be unique. If a category by the name already exists, the upload completely overwrites the category. Out-of-the-box contributions cannot be overwritten.
- Special characters are not supported in Activity and trigger names. A validation error is displayed while uploading if any names contain special characters.
- Uploading new extension(s) to an existing category overwrites the entire category and all its contents. So, to add a new extension to an existing category while keeping the extension(s) that already exist in that category, be sure to include the existing extension(s) along with the new Activity, connection, or trigger when creating the
.zip
file to be uploaded. - You cannot delete a single extension from any category other than the Default category. To delete a single trigger, Activity, or connector from a category, you must re-upload the whole category which includes all the extensions you want to keep minus the extension you want to delete. The same applies when editing an extension within a category - after editing an extension on your local machine, make sure to re-upload the whole category, the edited extension plus all the existing extensions in the category. Uploading only the edited extension overwrites the category causing you to lose the other extensions in the category.
An extension that you upload to Flogo Enterprise is available for use in any flow that currently exists in your app or any flow that you create later.
Subtopics