Installing the IntelligenceBank Connector for Adobe Experience Manager

Deploying to AEM 6.5 (on-prem or AMS)

AEM 6.5 installation is performed via Package Manager. The following packages should be installed:

• aem-connector.all-2.X.X.zip - main package, contains connector code and cofiguration

• aem-connector.ui.content65-2.X.X.zip - system user and permissions (required only for AEM 6.5.x installations)

Latest versions of this content packages can be found in a public Bitbucket repository: https://bitbucket.org/IB-IntelligenceBank/intelligencebank-connector-for-adobe-experience-manager-public/src/master/

If an older 1.X IntelligenceBank Connector was previously installed, it should be uninstalled/removed before installing the 2.X release (both content and OSGi bundle).

Deploying to AEM Cloud

The recommended process is to have the released Connector package available in a Public/Password-protected Maven repository. IntelligenceBank uses a public Bitbucket repository: https://bitbucket.org/IB-IntelligenceBank/intelligencebank-connector-for-adobe-experience-manager-public/src/master/.

In order to deploy the Connector to your AEM as a Cloud Service instance, the following modifications should be applied to your pom.xml file:

1. Define IntelligenceBank Maven repository:

    <repositories>
           //...
           <repository>
               <snapshots>
                   <enabled>false</enabled>
               </snapshots>
               <id>central</id>
               <name>default-maven-virtual</name>
               <url>https://bitbucket.org/IB-IntelligenceBank/intelligencebank-connector-for-adobe-experience-manager-public/raw/master/releases</url>
           </repository>
           <repository>
               <snapshots/>
               <id>snapshots</id>
               <name>default-maven-virtual</name>
               <url>https://bitbucket.org/IB-IntelligenceBank/intelligencebank-connector-for-adobe-experience-manager-public/raw/master/releases</url>
           </repository>
       </repositories>

2. Specify IntelligenceBank Connector dependency:

    <dependencies>
             // ...
             <dependency>
               <groupId>com.intelligencebank.aem</groupId>
               <artifactId>aem-connector.all</artifactId>
               <version>2.X.Y</version>
               <type>zip</type>
           </dependency>
       </dependencies>

3. Configure filevault-package-maven-plugin to embed aem-connector.all into the deployment package ,e.g.:

       <build>
           <plugins>
               <plugin>
                   <groupId>org.apache.jackrabbit</groupId>
                   <artifactId>filevault-package-maven-plugin</artifactId>
                   <extensions>true</extensions>
                   <configuration>
                       // ...
                       <embeddeds>
                           // ...
                           <embedded>
                               <groupId>com.intelligencebank.aem</groupId>
                               <artifactId>aem-connector.all</artifactId>
                               <type>content-package</type>
                               <target>/apps/<...>/install</target>
                           </embedded>
                       </embeddeds>
                   </configuration>
               </plugin>
           </plugins>
         // ....
       </build>

Once the above configuration is performed, a regular CloudManager deployment will fetch the Connector dependency from IntelligenceBank Artifactory and embed it into your deployment package.

Connector Configuration

Click here for configuration instructions.

Release Notes

Version 2.1.4 (6 October 2022)

• Remove the mandatory validation on the "value" field in wrapped conditions, since there are scenarios where value is not needed for the query
• Update re-login logic: react only to 401 status, verify the login status by presence of apiUrlV3 and sid fields, remove unused APIv2 fields
• Filename may contain forbidden characters, e.g. asterisk, so should be sanitized before attempting to create an asset
• Allow sync http client to follow the redirects, because downloadFile API is responding with 302 redirect to S3 location now
• Add error handling to avoid uncaught exceptions during the page rendering

Version 2.1.2 (7 August 2021)

• [Asset Sync Mode] Conditional Destination Folders support

• [Asset Sync Mode] Dynamic Destination Folders support

• [Asset Sync Mode] Automatic assignment / unassignment of IB Metadata Schema

• [Sites Mode] Add “Store assets locally” configuration option

• [Sites Mode] Add opacity to items which are not public

• General Stability improvements

Version 2.1.1

• Custom Form Fields metadata mapping support

Version 2.0.3

• Support for AEM Sites Connector mode in AEM as a Cloud Service

• Support for AEM 6.5

Version 2.0.1 

• Support AEM Cloud version 2020.11+

Version 2.0 (30 April 2021)

• Beta Version of the Adobe Assets Cloud Sync Connector Mode option, which supports:

  • Adobe Assets Cloud Sync as a new Connector mode

  • Single user credentials for authenticating to the IntelligenceBank platform instance

  • Selection of a single destination folder for all synced assets in AEM Assets

  • Search query scope parameters including:

    • Folder source(s)

    • Extensions

    • Search Keywords

    • Advanced Filtering Conditions

  • Metadata mapping options including:

    • Automatic IntelligenceBank Scheme with IntelligenceBank standard and custom filter fields.

    • Custom Mapping of IntelligenceBank standard and custom filter fields to select AEM Assets metadata fields / properties.