Sync content using AEM

Use Adobe Experience Manager as your single source of truth for managing your valuable content. Our AEM connector automatically syncs documents, document properties, and permissions to Showpad and optimizes them for web and mobile usage.

By syncing content, you can rest assured that all content in Showpad is the most current and up-to-date without manually updating single assets at a time.

Key features

• Streamline your asset management in Showpad
• Use Adobe Experience Manager as your single source of truth
• Map certain asset properties to Showpad based on connector preferences 
• Continue to upload assets directly to the Content Library as needed

You need this to succeed

• Ultimate subscription for Showpad
• AEM familiarity  
• Content in AEM Folders 

The quick way to awesomeness

1. Install the AEM Connector via Cloud Version or On Premise 
2. Designate Showpad permissions on the asset level 
3. Understand the connector field functionality

Note: Please reach out to your Customer Success Manager to gain access to the AEM connector package.

Do this step by step

Installing the AEM connector on premise 

1. Install the provided Showpad AEM Connect on the AEM package manager.
2. Restart the AEM instance to make sure the listeners are registered to the Observation Manager.

Installing the AEM connector via the cloud 

1. Add local filesystem based maven repository to the AEM cloud service project root pom.xml:

   <repositories>
   
   ...
   
     <repository>
   
       <id>project.local</id>
   
       <name>project</name>
   
       <url>file:${maven.multiModuleProjectDirectory}/repository</url>
   
     </repository>
   
   ...
   
   <</repositories>

2. Add Showpad connector Plugin dependency to all/pom.xml:

   <dependency> 
   
   <groupId>com.showpad.adobe</groupId>
   
   <artifactId>showpad-connector.ui.apps</artifactId>
   
   <version>2.4.10</version>
   
   <type>zip</type>
   
   </dependency>

3. Add embedded block to all/pom.xml -> filevault-package-maven-plugin configuration:
   

   ...
   
   <plugin>
   
     <groupId>org.apache.jackrabbit</groupId>
   
     <artifactId>filevault-package-maven-plugin</artifactId>
   
     <extensions>true</extensions>
   
     <configuration>
   
     <group>my_packages</group>
   
     <embeddeds>
   
      <embedded>
   
        <groupId>com.showpad.adobe</groupId>
   
        <artifactId>showpad-connector.ui.apps</artifactId>
   
        <type>zip</type>
   
                    <target>/apps/showpad-example-packages/application/install</target>
   
     </embedded>
   
     …

4. Add the plugin to the local maven repository. Run the following command from AEM cloud service project root replacing {showpad-connector.plugin.path} placeholder with the path to the plugin (e.g. /tmp/ showpad-connector.ui.content-2.4.10.zip):

   mvn org.apache.maven.plugins:maven-install-plugin:2.5.2:install-file -Dfile={showpad-connector.plugin.path} -DlocalRepositoryPath=./repository/ -Dpackaging=zip

5. Set the correct plugin version in all/pom.xml (e.g. 2.4.10):
   

   <dependency>
   <groupId>com.memsource</groupId>
   <artifactId> showpad-connector.ui.apps</artifactId>
   <version>2.4.10</version>
   <type>zip</type>
   </dependency>

 Configuring the connection

1. In your AEM tools section, you will now find a new section called Showpad on the left side menu.
   
2. Click Showpad from the menu and you will see the configuration screens. There will be three configuration tabs: Authentication Configuration, Functional Configuration, and Connection Configuration.
3. First, authenticate the configuration by enter your Showpad admin username and password.
4. In the next configuration tab, fill in the following fields for the Functional Configuration.
   • Showpad Permissions default settings
     • Is sensitive
     • Can be shared
     • Can be downloaded internally
     • Can be downloaded externally 
     • Can be annotated
     • Only share entire document
     • Library shared
     • Remove ownership
     • Hide label
   • Asset configuration
     • Use asset title 
   • Automatic flow configuration
     • Enable automatic flow on publish/unpublish
     • Enable automatic flow on new version creation 
   • Sync mapping
     • Divisions
     • Folders
     • Sync tag
   • Tag sync configuration
     • Use tag title
     • Tag namespaces to sync
     • Flatten tags
     • Match tags 
   • Custom fields configuration
     
     • Custom expiration field 
     • Custom is Showpad asset field
     • Custom tag fieldnames
     • Custom author field
     • Default author 
5. Lastly is the Connection Configuration tab. Here you will fill in your:
   • Server URL
   • Client ID
   • Client Secret
   • Max connections per host
   • Connection timeout
   • Max connections
   • Socket timeout

Designate Showpad permissions on the asset level 

Within the Showpad tab in AEM, you will have the option to dedicate certain properties on the asset-level, regardless of the original configuration settings.

1. With a particular asset open, click Properties. Click the Showpad tab.
2. Select Yes from the Is Showpad Asset dropdown. This will push the asset to Showpad once you click Save.
3. Add any additional tags you wish to sync to Showpad.
4. You can now select various permission settings in the Showpad Security column which will transfer to Showpad. Learn more about these permissions below.
5. Click Save & Close once you're done, then click Quick Publish to push the asset to Showpad.

Connector field descriptions

Pushing assets to Showpad to be processed by the connector can be configured in three different ways. By Path, by tag, or by Metadata.

• To sync assets by path, paths need to be configured in AEM. All assets in a particular folder can be pushed to Showpad. For every folder, a Showpad division needs to be configured.
• To sync assets by Tag, a tag needs to be specified in the configuration. If this tag is set on the cq:tags property, the asset can be pushed to Showpad.
• To sync assets via metadata, the “Is Showpad Asset” flag needs to be set to yes. Then, the asset will be pushed to Showpad.