Uploading Extensions
FLOGO_LOG_LEVEL
engine variable. Be sure to do so
before you begin uploading your extension.
For details on the
FLOGO_LOG_LEVEL
engine variable, see the
Environment Variables section. For more details on the environment and engine variables, see the
Configuring App Properties section. To upload an extension:
.zip
file for your extension available for upload.
- Procedure
- Click the Extensions tab.
- If this is the first extension, click
Upload an extension.
If there are existing extensions, click the Upload in the upper-right corner:
The Upload an extension dialog box opens. If you want to upload from the Git repository select From Git repository. See the section, Pulling Extensions from an Open Source Public Git Repository for more details on this.
To upload an extension residing in a
.zip
file locally, click From a Zip file. - Click the
browse to upload link and navigate to your extension
.zip
file. Alternatively, drag the.zip
file from your local machine to the area defined by a dotted line in the Upload an extension dialog box. - If you would like to skip the compilation process, select the
Skip Compilation check box. If the check box is selected,
Flogo Enterprise performs a check before uploading to make sure that every
.ts
file has a corresponding.js
file present. If a .ts file does not have a .js file, the validation fails, and your extension does not upload. - Click
Upload and compile.
Flogo Enterprise validates the contents in the
.zip
file. If the.zip
file contains a valid folder structure, it compiles the extension code. Once the code is compiled successfully, it uploads the extension to Flogo Enterprise. You can view the progress of the upload or any errors that occur in the logs:A Complete message is displayed after the extension is successfully uploaded. If there were any compilation errors during the upload, you see an error message and the upload exits. You can copy-paste the error message if required.
- Click
Done to close the dialog box.
You can view your extension on the Extensions page. The newly added extension appears under the category that you specified. If you had not specified a category for the extension, it appears in the Default category. Connectors are denoted by the
symbol, triggers are denoted by the
symbol, activities are denoted by the
symbol, and functions have the
symbol next to them.
The new extension displays the following:
- timestamp when the extension was loaded
- name of the extension contributor
- version of the extension
Note: While creating a flow, theicon is shown on activities that are present on the Extensions tab.
The Search field that appears above the category searches within the categories for the Activity, trigger, or connector you specified in the search text box. You can filter the displayed extensions by clicking the Triggers, Connectors, or Activities buttons.
The extension is now available for you to use. If you uploaded an Activity, the Activity is available for use when creating a flow or editing an existing flow. The Activity appears under the category you defined for it when creating the extension. The output of the Activity is available in the mapper just as it is for any default activities that come with the Flogo Enterprise.
If you uploaded a connector, the connector is available for creating new connections on the Add Connections > Select connection type dialog box.
If you uploaded a trigger, the trigger is available for you to select in the Create a Flow dialog box. If you select the trigger, it creates the flow with your trigger.
If you uploaded a function, it is available to be used inside the mapper when mapping elements.
If you uploaded a category, it is available to use when adding any new activities while designing a flow. Triggers and connections in the category can be used as mentioned above.