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 tagv1.8.61

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 nameEnter a name for this connection
Instance URL without a trailing slashEnter the URL for your Adobe Experience Manager instance. Do not include a slash / at the end of the URL.
Account details fill optionsSelect whether you want to provide JSON describing your account details, or if you want to enter details manually.
Technical account details in JSON formatIf providing JSON, enter or paste the JSON describing your account details.
Client IDIf entering details manually, enter the Client ID generated in the Server-to-server setup.
Client SecretIf entering details manually, enter the Client Secret generated in the Server-to-server setup.
Technical account IDIf entering details manually, enter the ID of the technical account. This is the "id" field in the client credentials JSON file.
Org IDIf entering details manually, enter the ID of your organization. This is the "org" field in the client credentials JSON file.
Meta ScopesEnter the Meta Scopes generated in the Server-to-server setup.
Private keyEnter 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.
Authentication URLEnter authentication URL for this account.

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

Connection nameEnter a name for this connection
Instance URL without a trailing slashEnter the URL for your Adobe Experience Manager instance. Do not include a slash / at the end of the URL.
UsernameEnter the username for the AEM Assets account that this connection uses.
PasswordEnter 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.

Map toggle

Copy a folder or asset

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

ConnectionFor 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 typeSelect whether you want to copy a folder or an asset.
Folder / AssetSelect or map the folder or asset that you want to copy.
Destination pathSelect or map the path to the location for the new folder or asset.
Name of copied folder / assetEnter 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 childrenIf copying a folder, enable this option to copy any subfolders or assets within the folder.
OverwriteEnable 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.

ConnectionFor 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.

ConnectionFor 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).

ConnectionFor instructions about connecting your Adobe Experience Manager Assets account to Workfront Fusion, see Connect Adobe Experience Manager Assets to Workfront Fusion in this article.
FolderSelect 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.

ConnectionFor instructions about connecting your Adobe Experience Manager Assets account to Workfront Fusion, see Connect Adobe Experience Manager Assets to Workfront Fusion in this article.
URLEnter a path relative to your Adobe Experience Manager base URL.
MethodSelect the HTTP request method you need to configure the API call. For more information, see HTTP request methods.
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 StringEnter 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.

ConnectionFor 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 typeSelect whether you want to move a folder or an asset.
Folder / AssetSelect or map the folder or asset that you want to move.
Destination pathSelect or map the path to the location that you want to move the folder or asset to.
Name of moved folder / assetEnter 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.
OverwriteEnable this option to overwrite any folder or asset in the destination location that has the same name as the folder or asset being moved.

Update a record

This action module updates an existing record.

ConnectionFor 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.