Uploading Extensions

Before you beginWhen uploading an extension, you can see the logs on the screen. You can change the log levels at runtime by setting the 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:

Note: This procedure assumes that you have the .zip file for your extension available for upload.

    Procedure
  1. Click the Extensions tab.
  2. 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.

  3. 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.
  4. 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.
  5. 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.

  6. 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, the icon 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.