Media Connector for Acquia DAM

	Connector type
	Built-in
	Built by CHILI publish
	Third party

See Connector types

Installation

See installation through Connector Hub

Configuration

Base Configuration

Your instance of the Connector needs to know which Acquia DAM instance it should communicate with and how to authenticate.

Once installed, navigate to the Connector overview, and select Acquia DAM. Start with Configuration.

Consult your Acquia System Admin to get the correct values for the fields.

Authentication

An important part of managing digital assets is governance—determining when and where assets can be used, and who has access to them.

You will need specific credentials from your Acquia DAM installation to set up the connector:

• Client ID and Client Secret: These are customer-specific credentials provided by the Acquia Admin when creating integrations within Acquia.
• Token URL and Authorization URL: These are more developer-oriented settings but can also be retrieved from Acquia documentation. While they are publicly available, they are generic for all Acquia clients.

You can set the authentication for machine-to-machine and browser separately or use the same setup for both.

Consult your Acquia System Admin to get the correct values for the fields.

Browser Authentication

GraFx Studio consumes assets available in the DAM. Therefore, the user impersonating access to the DAM system will dictate which assets are available in the template.

Server Authentication

The credentials used to set up machine-to-machine authentication will determine the governance on the assets in the automation setup.

This means if the credentials only allow access to certain assets, only those assets will be available when batch processing requests access to place assets in the output.

Using Assets from Your Acquia DAM System

Place Assets in Your Template

• Select the Acquia DAM Connector.
• Double-click the asset to assign it to the image frame.

Image Variables

When using image variables, you will get the same list of assets when you select an image.

DAM Queries & Variables

Introduction

You may want to filter the assets suggested to the template user by using categories, keywords, etc.

In the Acquia DAM solution, you can use a query language.

By using the query language, you can filter down to the right selection of assets.

Category

Use cat:{wine} to filter down to only wines.

Description

Add cat:{wine} des:{white} to further filter to only wines with the word "white" in the description.

How To

DAM queries are set at the connector level for a specific frame.

Set the value of the query in the connector settings.

If a fixed query is not sufficient, you can use a variable.

To further automate, you can use Actions to influence and set the query according to other variables or inputs the Smart Template receives.

In the image above, the action sets the DamSearchString to have different DAM queries depending on a chosen category. That text variable is then used in the image variable (see image above).