DocumentationWorkfrontWorkfront Guide

Adobe Experience Manager Assets modules

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • User

With the Adobe Experience Manager Assets connector for Adobe Workfront Fusion, you can start a scenario based on events in your Adobe Experience Manager Assets account, create, upload, and update assets, and copy or move folders and assets.

For an introduction to the Adobe Experience Manager Assets connector, see:

Access requirements

You must have the following access to use the functionality in this article:

Adobe Workfront plan*
Pro or higher
Adobe Workfront license*
Plan, Work
Adobe Workfront Fusion license**

Current license requirement: No Workfront Fusion license requirement.

Or

Legacy license requirement: Workfront Fusion for Work Automation and Integration

Product

Current product requirement: If you have the Select or Prime Adobe Workfront plan, your organization must purchase Adobe Workfront Fusion as well as Adobe Workfront to use functionality described in this article. Workfront Fusion is included in the Ultimate Workfront plan.

Or

Legacy product requirement: Your organization must purchase Adobe Workfront Fusion as well as Adobe Workfront to use functionality described in this article.

To find out what plan, license type, or access you have, contact your Workfront administrator.

For information on Adobe Workfront Fusion licenses, see Adobe Workfront Fusion licenses.

Prerequisites

  • You must have an Adobe Experience Manager Assets account to use these modules.

  • You must set up Server-to-server flow in the Adobe Developer console.

    For instructions on setting up Server-to-server flow in the Adobe Developer console, see Generating Access Tokens for Server Side APIs.

  • Your Adobe Experience Manager technical account must have write permissions.

    For instructions on adding write permissions to your Adobe Experience Manager technical account, see Service credentials in the Adobe Experience Manager documentation.

Adobe Experience Manager Assets API information

The Adobe Experience Manager Assets connector uses the following:

API tag
v1.8.61

Connect Adobe Experience Manager Assets to Workfront Fusion connect-adobe-experience-manager-assets-to-workfront-fusion

To create a connection for your Adobe Experience Manager Assets modules:

  1. Click Add next to the Connection box.

  2. Select the type of connection that you are creating:

    • AEM Assets as a Cloud Service

      This configuration requires information from the Adobe Admin Console.

    • AEM Assets Basic (Adobe Managed Services)

      This configuration requires a username and password.

  3. Fill in the fields for the type of connection that you are creating.

    For AEM Assets as a Cloud Service, see Configure the connection for AEM Assets as a Cloud Service.

    For AEM Assets Basic (Adobe Managed Services), see Configure the connection for AEM Assets Basic.

  4. Click Continue to save the connection and return to the module.

Configure the connection for AEM Assets as a Cloud Service

NOTE

  • The information for these fields is generated as part of setting up Server-to-server flow on the Adobe Developer Console. You can find these values in the service credentials JSON file generated as part of that setup.

    For instructions on setting up Server-to-server flow on the Adobe Developer Console, see Generating Access Tokens for Server Side APIs.

  • Your Adobe Experience Manager technical account must have write permissions.

    For instructions on adding write permissions to your Adobe Experience Manager technical account, see Service credentials in the Adobe Experience Manager documentation.

Connection name
Enter a name for this connection
Instance URL without a trailing slash
Enter the URL for your Adobe Experience Manager instance. Do not include a slash / at the end of the URL.
Account details fill options
Select whether you want to provide JSON describing your account details, or if you want to enter details manually.
Technical account details in JSON format
If providing JSON, enter or paste the JSON describing your account details.
Client ID
If entering details manually, enter the Client ID generated in the Server-to-server setup.
Client Secret
If entering details manually, enter the Client Secret generated in the Server-to-server setup.
Technical account ID
If entering details manually, enter the ID of the technical account. This is the "id" field in the client credentials JSON file.
Org ID
If entering details manually, enter the ID of your organization. This is the "org" field in the client credentials JSON file.
Meta Scopes
Enter the Meta Scopes generated in the Server-to-server setup.
Private key
Enter the Private Key generated win the Server-to-server setup. To extract the private key, click Extract, then enter the file to extract and the password for the file.

Configure the connection for AEM Assets Basic (Adobe Managed Services)

Connection name
Enter a name for this connection
Instance URL without a trailing slash
Enter the URL for your Adobe Experience Manager instance. Do not include a slash / at the end of the URL.
Username
Enter the username for the AEM Assets account that this connection uses.
Password
Enter the password for the AEM Assets account that this connection uses.

Adobe Experience Manager Assets modules and their fields

When you configure Adobe Experience Manager Essentials modules, Workfront Fusion displays the fields listed below. Along with these, additional Adobe Experience Manager Essentials fields might display, depending on factors such as your access level in the app or service. A bolded title in a module indicates a required field.

If you see the map button above a field or function, you can use it to set variables and functions for that field. For more information, see Map information from one module to another in Adobe Workfront Fusion.

Copy a folder or asset

This action module copies a folder or asset to another location in your Adobe Experience Manager Assets account.

Connection
For instructions about connecting your Adobe Experience Manager Assets account to Workfront Fusion, see Connect Adobe Experience Manager Assets to Workfront Fusion in this article.
Record type
Select whether you want to copy a folder or an asset.
Folder / Asset selection
Select or map the folder or asset that you want to copy.
Destination path
Select or map the path to the location for the new folder or asset.
Name of copied folder / asset
Enter a name for the new folder or asset. The folder name that displays in Adobe Experience Manager Assets is the same as the original name. The name entered here appears in the URL of the new folder or asset.
Copy children
Enable this option to copy any subfolders or assets within the folder.
Overwrite
Enable this option to overwrite any folder or asset in the destination location that has the same name as the folder or asset being copied.

Create a record

This action module creates a folder or an asset comment.

Connection
For instructions about connecting your Adobe Experience Manager Assets account to Workfront Fusion, see Connect Adobe Experience Manager Assets to Workfront Fusion in this article.
Object type

Select whether you want to create a folder or a comment on an asset.

  • Folder

    Fill in the following fields:

    • Name

      Enter a name for the folder. This name will appear in the file path, so it must not include spaces or other characters.

    • Title

      Enter a title for the folder, which can be displayed instead of the name.

  • Asset comment

    Fill in the following fields:

    • Asset selection

      Select or map the ID of the asset you want to add a comment to.

    • Comment

      Enter the text of the comment.

Delete a folder, asset, or rendition

This action module deletes a folder, asset, or rendition.

Connection
For instructions about connecting your Adobe Experience Manager Assets account to Workfront Fusion, see Connect Adobe Experience Manager Assets to Workfront Fusion in this article.
Record type

Select whether you want to delete a folder, asset, or rendition.

  • Folder

    Select the folder to delete by selecting the folders in its path.

  • Asset

    Select the asset by selecting the folders in its path, then the asset you want to delete.

  • Rendition

    Select the rendition by selecting the folders in its path.

    Enter or map the name of the rendition.

Get a folder listing

This action module retrieves a representation of an existing folder and of its child entities (folders or assets).

Connection
For instructions about connecting your Adobe Experience Manager Assets account to Workfront Fusion, see Connect Adobe Experience Manager Assets to Workfront Fusion in this article.
Folder
Select or map the folder that you want to retrieve. To add subfolders to the path, click the plus icon and select the subfolder.

Make a custom API call

This action module makes a custom API call to the Adobe Experience Manager Assets API.

Connection
For instructions about connecting your Adobe Experience Manager Assets account to Workfront Fusion, see Connect Adobe Experience Manager Assets to Workfront Fusion in this article.
URL
Enter a path relative to your Adobe Experience Manager base URL.
Method
Select the HTTP request method you need to configure the API call. For more information, see HTTP request methods in Adobe Workfront Fusion.
Headers

Add the headers of the request in the form of a standard JSON object.

For example, {"Content-type":"application/json"}

Workfront Fusion adds authorization headers automatically.

Query String
Enter the request query string. For Each Key/Value pair, click Add item and enter the Key and Value.
Body

Add the body content for the API call in the form of a standard JSON object.

Note:

When using conditional statements such as if in your JSON, put the quotation marks outside of the conditional statement.

Move a folder or asset

This action module moves the asset or folder at the given path to a new location.

Connection
For instructions about connecting your Adobe Experience Manager Assets account to Workfront Fusion, see Connect Adobe Experience Manager Assets to Workfront Fusion in this article.
Record type
Select whether you want to move a folder or an asset.
Folder / Asset
Select or map the folder or asset that you want to move.
Destination path
Select or map the path to the location that you want to move the folder or asset to.
Name of moved folder / asset
Enter a new name for the moved folder or asset. The folder name that displays in Adobe Experience Manager Assets is the same as the original name. The name entered here appears in the URL of the moved folder or asset.
Overwrite
Enable this option to overwrite any folder or asset in the destination location that has the same name as the folder or asset being copied.

Update a record

This action module updates an existing record.

Connection
For instructions about connecting your Adobe Experience Manager Assets account to Workfront Fusion, see Connect Adobe Experience Manager Assets to Workfront Fusion in this article.
Record type

Select whether you want to delete asset metadata or an asset rendition.

  • Asset metadata

    • Select the asset that you want to update metadata for.

    • Enter the new title of the asset.

  • Asset rendition

    • Select the asset that you want to update the rendition for.

    • Select a source file from a previous module, or map the source file's name and data.

Upload an asset

This action module uploads an asset to your Adobe Experience Manager Assets account.

Connection
For instructions about connecting your Adobe Experience Manager Assets account to Workfront Fusion, see Connect Adobe Experience Manager Assets to Workfront Fusion in this article.
Destination
Select the folder where you want to upload an asset.
Source file
Enter or map the source file's name and data.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43