The register integration links features in Acquia DAM enables you to track where DAM assets are used throughout your Drupal website. When you register integration links, Acquia DAM displays all locations where each asset is referenced. This simplifies asset use management, helps to identify dependencies, and ensures content consistency.

Prerequisites

In your Drupal application:

• Confirm that the Acquia DAM module version 1.1.11+ is enabled.
• Confirm that you have administrative access to the Drupal site.
• Verify that your site is authenticated with Acquia DAM.
• (Optional) Enable the Acquia DAM - Enhanced integration links sub-module for enhanced tracking of content entity references.

Feature comparison: Standard versus enhanced tracking

The register integration links features in Acquia DAM enables you to track where DAM assets are used throughout your Drupal website. When you register integration links, Acquia DAM displays all locations where each asset is referenced. This simplifies asset use management, helps to identify dependencies, and ensures content consistency.

Prerequisites

In your Drupal application:

• Confirm that the Acquia DAM module version 1.1.11+ is enabled.
• Confirm that you have administrative access to the Drupal site.
• Verify that your site is authenticated with Acquia DAM.
• (Optional) Enable the Acquia DAM - Enhanced integration links sub-module for enhanced tracking of content entity references.

Feature comparison: Standard versus enhanced tracking

The level of tracking detail depends on your configuration. While the parent module enables the link, the Acquia DAM – Enhanced Integration Links submodule is required for deep-link visibility.

Register integration links

Through the admin user interface

1. In the administrative menu, select Configuration.
2. Select Acquia DAM under Media to open the Acquia DAM configuration page.
3. Select the Integration links tab.

4. Review the status dashboard to check total assets, registered links, and remaining assets by media type.

5. Select the Register Integration Links to start the batch process.
6. Monitor the progress bar as the system:
   1. Processes media entities
   2. Processes content entities (Enhanced mode only)
   3. Completes all registration operations

7. Review the completion summary to check media items queued, content entity references queued, and queue items processed.

Through the Command-Line interface (Drush)

The feature supports three Drush commands for different workflows:

1. Register integration links (All-in-One)

Performs the complete workflow: queues assets and processes them immediately.

Command syntax:

drush acquia-dam:register-integration-links [--batch-size=<number>] [--media-type=<type>] [--process-limit=<number>]

Options:
--batch-size: Number of assets to process per batch. Default: 50.
--media-type: Process only a specific media type.
--process-limit: Maximum queue items to process. Default: 0 (no limit).

Examples:
drush acquia-dam:register-integration-links
drush acquia-dam:register-integration-links --batch-size=100
drush acquia-dam:register-integration-links --media-type=acquia_dam_image_asset

Recommended Usage: 

Ideal for small to medium datasets or manual one-time operations.

2. Queue integration links

Discovers assets and adds them to the queue without processing. Useful for large datasets or decoupled workflows.

Command syntax:

drush acquia-dam:queue-integration-links [--batch-size=<number>] [--media-type=<type>]

Examples:
drush acquia-dam:queue-integration-links
drush acquia-dam:queue-integration-links --media-type=acquia_dam_video_asset

3. Process the integration links queue

Processes items already queued and provides controlled batch execution.

Command syntax:

drush acquia-dam:process-integration-links-queue [--process-limit=<number>]

Examples:
drush acquia-dam:process-integration-links-queue
drush acquia-dam:process-integration-links-queue --process-limit=100

Automated registration through Cron

Integration links are automatically registered when:

• A new DAM asset is added to Drupal
• An existing media entity is updated
• Content entities are saved with DAM references (Enhanced mode)

The registration happens through Drupal's queue system. Cron processes the queue automatically with no manual action required for ongoing maintenance.

To manually trigger queue processing:

drush cron

Or process the specific queue:

drush queue:run acquia_dam_integration_links

Re-registering integration links

You can re-run the registration process at any time. The system automatically skips assets that already have registered links, which prevents duplicates.

When to re-register:

• After you import new DAM assets in bulk.
• After you enable Enhanced mode.
• If you suspect tracking is incomplete.
• After major content migrations.

Troubleshooting

drush acquia-dam:register-integration-links

drush acquia-dam:register-integration-links --batch-size=10 --process-limit=100

drush cr

drush pm:list | grep integration. 

Important notes

Automatic maintenance:

Cron handles ongoing registration automatically. New or updated assets are queued and processed during scheduled Cron jobs without configuration changes.

Large sites:

For sites with many assets, use the decoupled workflow: queue assets first with queue-integration-links, then process in controlled batches with process-integration-links-queue. Schedule large operations during off-hours to minimize performance impact.

Enhanced mode:

Enable the Enhanced integration links sub-module early in your implementation for complete tracking. After you enable it, re-run the registration to catch existing content entity references.