Skip to main content
Feedback

Custom file actions

You can perform several actions on the custom JAR files used in your integration processes, such as uploading, displaying the contents, and displaying the deployments the file references.

note

You must have the Build Read and Write Access privilege and the Developer privilege to upload custom JAR files.

Each Boomi account has access to 100 MB of space for uploaded files.

Uploading a custom file

You can upload custom JAR files for use with your integration processes.

Details

  1. On the Manage Account Libraries page, click Upload a File.

    The Upload a File dialog opens.

  2. Click Choose a File and locate the JAR file that you want to upload.

  3. Upload the hash file that is produced by executing the SHA256 cryptographic hash function of the uploaded JAR file.

  4. Click Upload to complete the upload process.

    Only JAR files can be uploaded. If you select a file with an extension other than .jar, an error message is displayed.

    note

    Uploaded or imported files pass through a virus scanner first. If the scan detects a virus, you receive an error message, and the scan rejects the file. If an error persists, contact Boomi Support.

    An error message is also displayed if:

    • Uploading the selected file would exceed the account limit of 100 MB.

    • A file with the same name already exists in the account library.

    The uploaded file appears in the list in alphabetical order by name. Optionally, you can sort the list by date uploaded or by size.

    note

    If the name of the uploaded file contains any special characters, those characters are replaced by underscores. For example, a file called connectorjar\(2\).jar is uploaded as connectorjar\_2\_.jar.

Next steps

After you upload custom JAR files, you can include them in a Custom Library component and deploy that component to any basic runtime, runtime cluster, runtime cloud, or environment.

Display contents

You can display the contents of a custom JAR file that you uploaded.

Details

JAR files typically contain Java class files and related resources.

  1. On the Manage Account Libraries page, select the JAR file whose contents you want to display.

  2. Click the gear icon to open the action menu for JAR files. Select View Contents.

    The Custom File Contents panel is displayed.

    Example showing a Custom File Contents

    You can switch between the following views:

    • Folder view groups the files by folder. The Name column can contain either a file name or a folder name.

    • Flat view shows all files in a single, combined list. The Folder column indicates where each file resides.

    You can sort the list by file name, folder name, date modified, or size.

    You can search for files by typing in the Search by name field. As you type, the list is filtered to include only files whose names match the typed characters partially or completely. Pressing Esc or clicking the grey 'X' icon clears the field and stops filtering.

Display referenced components

You can display a list of Custom Library components that reference a given custom JAR file.

Details

  1. On the Manage Account Libraries page, select the JAR file whose usage you want to display.

  2. Click the gear icon to open the action menu for JAR files. Select View Usage in Custom Library Components.

    The Custom Library Component Usage panel is displayed. Custom Library components that reference the JAR file appear in alphabetical order by name.

    Custom Library Component Usage dialog

  3. Optional: Click a Custom Library component name to open that component in the Build page.

Display referenced deployments

You can display a list of Custom Library deployments that reference a given custom JAR file.

Details

  1. On the Manage Account Libraries page, select the JAR file whose deployments you want to display.

  2. Click the gear icon to open the action menu for JAR files. Select View Deployments.

    The Custom Library Component Deployments panel is displayed. Custom Library components that reference the JAR file and which are currently deployed appear in alphabetical order by name.

    Custom Library Components Deployments panel

  3. Optional Click a Custom Library component name to open that component in the Build page.

  4. Optional: Click View Deployment for a Custom Library component to view the deployment that contains the selected JAR file.

    The Deployments page is displayed.

Delete

You can delete JAR files you've uploaded if it is not referenced in any deployed components.

Details

  1. On the Manage Account Libraries page, select the JAR file that you want to delete.

  2. Click the gear icon to open the action menu for JAR files.Select Delete.

    If the JAR file is referenced in a Custom Library component that is not yet deployed, a warning message is displayed. Deleting the file could cause problems with the component. You can cancel the delete request or click Delete to continue.

    If the JAR file is referenced in a Custom Library component that is deployed, an error message is displayed. You cannot delete a JAR file while any components that reference the file are deployed.

  3. In the confirmation dialog, click OK to confirm the deletion.

    The JAR file is removed from your account library and the space that it occupied is released.

On this Page