The Bulk Import feature in Acquia DAM version 1.1.x lets you transfer multiple assets, such as images, videos, and documents, from Acquia DAM to your Drupal web application. This feature imports assets efficiently and provides access within your Drupal application

Prerequisites¶

In your Drupal application:

• Confirm that the Acquia DAM module version 1.1.x is enabled.
• Confirm that the Acquia DAM Bulk Asset Import sub-module is enabled.
• Access the Bulk Import configuration page.

Steps to use the Bulk Import feature¶

1. In the administrative menu, select Configuration.
2. Select Acquia DAM under Media to open the Acquia DAM configuration page.
3. Select the Bulk Import tab.
4. In the Assets to import from section, select a source type:
   • Categories
   • Asset Groups
5. Select the source category or asset group from the dropdown. These values are defined in Acquia DAM.
   • If you select Categories:
     • Select a category and, as needed, a sub-category.
   • If you select Asset Groups:
     • Select an asset group to import.
6. Optionally, filter categories or asset groups based on specific media types.
   • Filter assets:
     • To limit which assets to import, select the Filter Assets option.
     • Select Filter by Media Type, then choose media types.
     • Select Add to include selected media types.
     • The application lists your selections below the source.
   • Add all assets:
     • Leave filters cleared.
     • Select Add to include all assets from the selected source.
   • Filtering will let you import specific media types from a category or group. If you do not set any filters, all assets from the source are imported.
7. Select +Add to add additional mappings if you want to import content such as PDFs from Manuals and generic types from Packaging.
8. When ready, select Save to store the configuration and prepare the assets for import.

Import assets¶

Through the admin user interface¶

• Cron imports assets in batches to prevent system overload. If assets remain, cron imports them at the next scheduled run.
• To start the import immediately, trigger a manual cron run.

Through Command-line interface¶

It supports both quick all-in-one imports for small number of assets and queued import flows suitable for large volume of assets. Click the save button to be able to perform an assets import with the Drush command:

1. Command: drush acquia-dam:import-assets

Performs a full end-to-end import workflow: queues all available DAM assets and processes them immediately in batches.

Command Syntax:

drush acquia-dam:import-assets [--batch-size=<number>] [--limit=<number>]
Options:
--batch-size: Number of assets to process per batch. Default: 10.
--limit: Max number of assets to import. Default: 0 (no limit).
Examples:
drush acquia-dam:import-assets
drush acquia-dam:import-assets --batch-size=50
drush acquia-dam:import-assets --limit=25
drush acquia-dam:import-assets --limit=100 --batch-size=20

Recommended Usage:
Ideal for scenarios with fewer assets or when resource limits are not a concern.

Behavior:

1. Queues all available assets from Acquia DAM.
2. Processes the queue immediately.
3. Displays a summary of results.

2. Command: drush acquia-dam:queue-import-assets

Discovers available assets from Acquia DAM and adds them to the import queue. No importing is performed, assets are just queued.

Command Syntax:

drush acquia-dam:queue-import-assets

Recommended Usage:
Use this command to deal with large volumes of assets or for decoupled import workflows.

3. Command: drush acquia-dam:process-import-queue

Processes assets already queued by queue-import-assets. Handles import in controlled batches and provides robust failure handling.

Command Syntax:

drush acquia-dam:process-import-queue [--batch-size=<number>] [--limit=<number>]
Options:
--batch-size: Number of items to process per batch. Default: 10.
--limit: Max number of items to process. Default: 0 (no limit).
Examples:
drush acquia-dam:process-import-queue
drush acquia-dam:process-import-queue --batch-size=50
drush acquia-dam:process-import-queue --limit=100

Ideal Use Cases:¶

• Controlled processing to avoid memory/timeouts.
• Chunked imports (for example, --batch-size=10 --limit=100, execute 10 batches to import 100 assets).

Manage Bulk Import configurations¶

Edit a configuration¶

• Select a category or asset group to modify its configuration.
• View and update selected media types as needed.
  • Choose new media types to add.
  • Clear any you no longer want for import.
  • Select Update to apply your changes.
• After you update, select Save to store the new configuration.

Delete a configuration¶

• Select Remove next to the category or asset group you want to exclude.
• Select Save to finalize removal.

You may modify or remove categories or asset groups any time after you schedule imports by editing or deleting the configuration.

Summary of actions¶

• Add: Include selected media types or all assets from a category or asset group in the import list.
• Save: Store the selected configuration.
• Update: Change settings for assets within a source.
• Remove: Exclude an asset from the import list to prevent import.
• Cron job: The scheduled job imports assets automatically. To import immediately, trigger the cron job manually.

Important notes¶

Cron job behavior:
The cron job runs continuously. Whenever a new asset is added to Acquia DAM, the scheduled cron job incorporates the asset automatically without any changes to the configuration.

Asset filtering:
Filtering options let you import specific media types within a category or asset group. If you do not apply any filters, the system imports all assets from the selected category or asset group.

Manual configuration updates:
Modify or remove categories or asset groups at any time after scheduling assets for import by editing or deleting the configuration.