File Explorer for Multi-Page Assets

Overview

The File Explorer for Multi-Page Assets plugin is a file explorer plugin that imports folders from an AWS S3 storage integration as multi-page assets.

Use this plugin when each asset should be built from the files inside one S3 folder. The folder name becomes the asset external ID, and the files inside that folder become the pages of the imported asset.

File Explorer for Multi-Page Assets

Plugin Functionality

The plugin lets you browse an AWS S3 bucket connected to Ango Hub through a storage integration. When you run the import, the plugin looks for subfolders in the selected folder and creates one multi-page asset per subfolder.

For example, if your selected folder contains:

case-001/page-1.png
case-001/page-2.png
case-002/page-1.png
case-002/page-2.png

the plugin imports two assets:

• case-001, with page-1.png and page-2.png as pages

• case-002, with page-1.png and page-2.png as pages

Each subfolder must contain at least one file and no more than the maximum page limit supported by the plugin. Folders outside that range are skipped.

Using the File Explorer for Multi-Page Assets Plugin

First, ensure you have created a storage integration between Ango Hub and the private bucket where the files you wish to import are stored. More information on how to do so can be found here.

Then, navigate to the project where you'd like to import the assets.

Enter the Settings tab, then the Plugins section.

Find the File Explorer for Multi-Page Assets plugin and click Open. From the plugin dialog, select the storage, bucket, and folder to import from.

In Batch, you may pick one or more batches to which assets imported in this session will be assigned.

In the Config JSON area, you can tweak a number of settings. By default, they are:

{
  "prevent_duplicates": false,
  "accepted_extensions": [],
  "ignored_extensions": [],
  "start_index": null,
  "end_index": null
}

• "prevent_duplicates": When true, the plugin skips folders whose folder name already exists as an external ID in the project.

  • Example:

    • "prevent_duplicates": true

    • "prevent_duplicates": false

• "accepted_extensions": Imports only files with the listed extensions. Leave the list empty to accept all extensions.

  • Example:

    • "accepted_extensions": ["jpg", "png"]

• "ignored_extensions": Skips files with the listed extensions.

  • Example:

    • "ignored_extensions": ["txt"]

• "start_index" and "end_index": Import only a slice of the discovered folders. Index values start at 0. Setting a value to null means the plugin uses the beginning or end of the list.

  • Example:

    • "start_index": 0

    • "end_index": 100