Create an APP in AEM And Mapping with AEM Mobile On-Demand

Create an APP in AEM And Mapping with AEM Mobile On-Demand Portal

To work with AEM Mobile On-Demand Portal, we need an app created in AEM.
Mobile Apps dashboard(http://localhost:8080/libs/mobileapps/admin/content/dashboard.html) collectively holds all mobile apps in AEM. To publish or sync a content between AEM and AEM Mobile, an app is necessary at AEM and a mapped project in AEM Mobile. Consider we already have a project in AEM Mobile, and need to link it with AEM.

There are two steps required to sync AEM and AEM Mobile.

1) Creating an On-Demand app in AEM 6.2
2) Link the AEM 6.2 APP with AEM Mobile On-Demand Project

Steps
 
>>Creating an On-Demand app
In AEM 6.2, go the Mobile section as shown below.
Click Create > App. The select template "AEM Mobile runtime", click on 'Next'

Enter app properties such as Title, Name, Description.

Ensure the app properties are matching with the properties used in the AEM Mobile On-Demand Portal, and click Next.

>>Link the AEM 6.2 APP with AEM Mobile

Under 'Manage Connection', map the AEM APP from section 'Select an Experience Manager Mobile Config', with AEM Mobile project from section 'Select an existing Experience Manager Mobile Project' as shown below.

Once the connection is successful, the 'Manage Connection' section looks as below.

Now we will be able to sync data/content between AEM app and AEM Mobile On Demand Portal.

Test the configuration.

Assume we have some collection already created in AEM Mobile portal. Now Go to 'Manage Connection' > click on 'Import Collections', confirm the import pop up screen. You will be able to see the AEM Mobile On-Demand portal collections imported into AEM environment with a success message.

Read More:

1. AEM Mobile Overview

2. AEM Mobile Integration with third party application for authoring

3. AEMM: How to create custom authentication

4.  AEM Mobile(AEMM) Applications - FAQ

5. AEM Mobile Desktop Web Viewer

6. AEM Mobile Access Protections at collection , article levels

Integrate AEM with AEM Mobile

Integrate AEM with AEM Mobile

The article is based on AEM 6.2. You may need to refer the url(https://helpx.adobe.com/digital-publishing-solution/help/configure-aem.html) for AEM 6.1 version integration.

How do we get AEM 6.2 Jar?
You may need to raise a request with Adobe in AEM License section for the same mentioning the partnership of your organization with Adobe.

Integrate AEM with AEM Mobile

AEM Integration with AEM Mobile On-Demand portal helps organizations to manage mobile content easily and work in more distributed way. Once the integration is done, we will be able to add content (Article, collections, banners etc) through AEM for the Mobile Application. We also can import existing content available in AEM Mobile On-Demand portal to our AEM Development environment.

To complete the integration, we need API access of On-Demand portal, which requires additional license from Adobe. Below given the details required.

• API Key & Client Secret are credentials to access the API Gateway. (Refer Link and Raise a request for API Key from Adobe https://helpx.adobe.com/digital-publishing-solution/help/integrating-dps.html#apikey)

• Device ID and Device Token are credentials to identify the API user. (Generate the Device details using above API received from Adobe then from URL https://aex.aemmobile.adobe.com/)

Note: Ensure the 'Adobe ID' used to get API access should match the 'Device ID' generation.

Once both steps are done, you will have,

• API Key (IMS Client ID)
• Secret Key
• Device ID
• Device Token

Note: API Key Expiry Time automatically gets extended once in use and expiry date is reached.

Integrate AEM 6.2 to work with AEM Mobile.

Follow below steps to integrate the AEM with AEM Mobile On-Demand Portal

In AEM click Adobe Experience Manager, and then go to Tools > Operations > Web Console.

In the new window, search for 'Experience Manager Mobile On-demand Services Client' and click the edit icon.

Enter the API Key (IMS Client ID) and Client Secret in the "Client Id' and 'Client Secret' as shown below and save it.

Now go back to AEM page, Tools > Deployment > Cloud Services. Search for 'Adobe Experience Manager Mobile On-demand Services', and click 'Configure Now'.

In the 'Create Configuration' pop-up window, enter 'Title', 'Name', and click Create.

Enter the 'Device Id' and 'Device Token' which was generated using the 'IMS Device Token Generator' to the pop up window 'Adobe Experience Manager On-Demand Services Account Configuration'. Once the 'OK' button is clicked we will be able to see the configuration saved.

How to Test the connection/configuration?

On the service which we have created, click on configuration > 'Edit' , the pop up window will have previously saved 'Device ID' and 'Device Token' and 'Test Device Configuration' on bottom. Click on 'Test Device Configuration'. If the connection is proper, we will get a message 'Connection Successful'.

If the connection was not successful, ensure that 'Device ID' and 'Device Token' values are correct, have not expired and are copied properly (by copying on notepad and removing any white-spaces).

Click 'OK', and then navigate back to the AEM window. You can see the AEM On-Demoand Cloud Service is enabled and 'Green'.

Read More:

1. AEM Mobile Overview

2. AEM Mobile Integration with third party application for authoring

3. AEMM: How to create custom authentication

4.  AEM Mobile(AEMM) Applications - FAQ

5. AEM Mobile Desktop Web Viewer

6. AEM Mobile Access Protections at collection , article levels

Create Article/Banner from AEM and publish it to AEM Mobile

Create Article/Banner from AEM and publish it to AEM Mobile

AEM Version 6.2

Once the AEM is configured with AEM Mobile account as mentioned in page, we will be able to import articles, collections banners etc from AEM On-Demand Portal. We can also create an article, banner, collection from AEM and publish to AEM Mobile on-demand portal. The synch method is quite easy to follow.

Let us see how to create a banner in AEM and publish it to AEM Mobile. Creation / updation of article method remains same as in banners.

In section 'Manage Banners' , click on 'Create Banner' as shown below.
[Click on image to see it big]

Now go through the screens and fill out all mandatory fields as shown below. Ensure we are clicking on 'Next' to fill out various sections like 'Properties', 'Advertisement', 'Images', 'Collections'. In final screen select the collection where the article/banner to be linked with.

Once we click on 'Create'; on final screen we will get confirmation 'Banner Created' with option to view new banner.

We will have various options like publish, unpublish,Add to a collection, Unlink from collection, upload delete etc for an article.

Also we can view and change the properties further.

Now the Manage Banners section list out all the banners which are created using AEM or through AEM Mobile on demand portal. Section 'Source' specifies the source of content creation.
It also says the advertisement details, whether the article/banner is published etc.

Individual articles/banners can be published by selecting it as shown below below.

 

Read More:

1. AEM Mobile Overview

2. AEM Mobile Integration with third party application for authoring

3. AEMM: How to create custom authentication

4.  AEM Mobile(AEMM) Applications - FAQ

5. AEM Mobile Desktop Web Viewer

6. AEM Mobile Access Protections at collection , article levels