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 Client’s Cloud Instance

The following article describes the process of exposing a partner integration to AEM Cloud customers: https://adobeexchangeec.zendesk.com/hc/en-us/articles/360051620771-Partner-integrations-with-AEM-as-a-Cloud-Service

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

• [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

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