DocumentationAEM 6.5User Guide

Install Workfront for Experience Manager enhanced connector assets-integration-overview

Last update: Tue Mar 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Admin
Version
Article link
AEM as a Cloud Service
Click here
AEM 6.5
This article

A user with administrator access in Adobe Experience Manager installs the enhanced connector. Before you install, review the platform support and other prerequisites for the connector.

IMPORTANT

  • Adobe requires deployment and configuration of the Adobe Workfront for Experience Manager enhanced connector only via certified partners or Adobe Professional Services. If deployed and configured without a certified partner or Adobe Professional Services, it is not supported by Adobe.

  • Adobe may release updates to Adobe Workfront and Adobe Experience Manager that make this connector redundant; if this occurs, customers may be required to transition from the use of this connector.

  • Adobe supports enhanced connector versions 1.7.4 and higher. Previous prerelease and custom versions are not supported. To check the enhanced connector version, navigate to the digital.hoodoo group available in the left pane in Package Manager.

  • See Partner certification exam for Workfront for Experience Manager Assets enhanced connector. For information about the exam, see Exam Guide.

To install the connector, follow these steps:

  1. Download the connector from Software Distribution link.

  2. Configure the firewall.

  3. On the Dispatcher, allow HTTP headers named authorization, username, and apikey. Allow GET, POST, and PUT requests to /bin/workfront-tools.

  4. Ensure that the following paths do not exist in Experience Manager repository:

    • /apps/dam/gui/coral/components/admin/schemaforms/formbuilder
    • /apps/dam/gui/coral/components/admin/folderschemaforms/formbuilder
    • /apps/dam/gui/content/foldermetadataschemaeditor
    • /apps/dam/cfm/models/editor/components/datatypeproperties
    • /apps/settings/dam/cfm/models/formbuilderconfig

  5. Install the package using Package Manager. To know how to install packages, see Package Manager documentation.

  6. Create wf-workfront-users in Experience Manager User Group and assign the permission jcr:all to /content/dam.

  7. Add a custom property to the out of the box index definition for ntFolderDamLucene(/oak:index/ntFolderDamLucene). Execute the below steps:

    • Add an nt:unstructured property named wfReferenceNumber to:
      /oak:index/ntFolderDamLucene/indexRules/nt:folder/properties/wfReferenceNumber.
    • Reindex the index /oak:index/ntFolderDamLucene by flipping the reindex flag to true.

A system user workfront-tools is automatically created and the required permissions are managed automatically. All users from Workfront who use the connector are automatically added as a part of this group.

Configure the connection between Experience Manager and Workfront configure-connection

To create a connection with Workfront, follow these steps:

  1. In Experience Manager, select Tools > Cloud Services > Workfront Tools Configuration.

  2. Select workfront-tools in the left panel and select Create option in the upper-right area of the page.

  3. In the Workfront Connection dialog, provide the required details of your Workfront deployment, and select Connect to Workfront option. Once successfully connected, the Workfront document custom integration is auto-created in the Workfront environment.

    Connect Experience Manager and Workfront

  4. To verify the connection, access it in Workfront and verify that the API key is the same and that the connection is Enabled. To do so, select Setup > Documents > Custom Integrations in Workfront.

Update Workfront for Experience Manager enhanced connector update-enhanced-connector-for-workfront

Experience Manager Assets enables you to update the Workfront for Experience Manager enhanced connector from a previous version to the latest version.

To update the Workfront for Experience Manager enhanced connector to the latest version:

  1. Download the latest version of the enhanced connector from Software Distribution link.
  2. Install the package using Package Manager. To know how to install packages, see Package Manager documentation.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2