Saturday, 4 February 2017

Adobe Experience Manager FAQs and other Tips

This post captures FAQs, and other tips for AEM that AEM Developers will find useful. We will update this list on an on-going basis.

How can i align fields in a Touch UI Dialog? 

See: https://forums.adobe.com/thread/2394012

How can I use Sling Queries?


Core Project has dependency on javax.inject [0,1) Bundles and imports not getting deployed 

You can add

<!-- Import any version of javax.inject, to allow running on multiple versions of AEM -->
<Import-Package>javax.inject;version=0.0.0,*</Import-Package>

to your bundles pom.xml. This should solve your issue. This says take any version from the felix console for this bundle.  Add it under maven-scr-plugin 

How can I get a reference to an AEM Service from a Sling Model

You cannot use @Reference to inject a service into a Sling Model. When attempting to get a service into an AEM Sling Model class - you can use @inject. See this thread:

https://forums.adobe.com/message/9864292#9864292

How can I limit the fields located in Multifield?

How can i change the Theme of a Touch UI Dialog? 


How can i modify the default text of a Parsys component? 

Where can I find good reference docs for Coral APIs

How do i use HTL syntax to include a Core Component in my static template?

You can use HTL syntax to include AEM Core components into a static template. For example, to include the List component into a template - specify this syntax: 

<div data-sly-resource="${'content' @ resourceType='core/wcm/components/list/v1/list'}">

Whats the difference between a static template and an editable template


In AEM 6.3 - I am getting osgi bundle whitelist error-osgi-service is NOT whitelisted to use SlingRepository.loginAdministrativeg 

You can either use a System user and the sling mapping service - see http://scottsdigitalcommunity.blogspot.ca/2014/12/querying-adobe-experience-manager-6.html.

Or configure AEM. See - https://forums.adobe.com/thread/2355506

How can i integrate AEM with Hybris? 


In HTL, how can i add the parsys component?

<sly data-sly-resource="${'content-par' @ resourceType='wcm/foundation/components/parsys'}"/>

I can use both JCR API and SLing API to work with the AEM JCR. Which one is better? 


I want to send a message to a users AEM inbox? 


When working with Sling Models, can I reference grandchildren nodes and work with Collections? 

Yes, when you work with Sling Models, you can work with Grandchildren nodes from the node that you adapt. For example, consider the following JCR structure. 


Assume you adapt NodeCollections in your Sling Model: 

Resource resource = resourceResolver.getResource("/content/NodeCollections");

You can get the grandchildren nodes using this syntax and return them to  a Java LIST object. 

@Model(adaptables = Resource.class)
public class UserInfo {
   
@Inject 
private List<Resource> Dad;


    public List getGrandChildren()
    {
    return Dad ; 
    }
    

}

In this example, the List Object would contain six items.  See more here:

https://sling.apache.org/documentation/bundles/models.html

I want to know the difference between Sling Models and WCMUsePojo

Can Forms interact with Workflows? 

I want to know more information about OSGi Declarative Services Annotations in AEM

Whats the difference between Foundation components and Core components? 

See this community article for an answer: http://adobeaemclub.com/aem63-core-components/

To learn to work with Core Components - see: https://helpx.adobe.com/experience-manager/using/aem63_components.html

A user does not have permission to modify Assets, can they execute a Workflow that modifies them? 


Any member of the workflow-users group can list and start workflows, irrespective of their permissions on the payload the selected to run the workflow.


Does AEM by default use J2EE Sessions and Cookies? 

Nothing in AEM uses JavaEE Sessions.  

Components cannot be moved. Why? 


f you want to move components upwards or downwards, you need to use copymove in cq:actions property.



Here it is!!



<jcr:root xmlns:cq="http://www.day.com/jcr/cq/1.0" xmlns:jcr="http://www.jcp.org/jcr/1.0"

    cq:actions="[text:My Component,-,edit,delete,insert,copymove]"

    cq:dialogMode="floating"

    cq:layout="editbar"

    jcr:primaryType="cq:EditConfig">

</jcr:root>

I  am using AEM Forms,not AEM Sites

See these docs: https://helpx.adobe.com/aem-forms/6-1/help-tutorials.html

Can I use @Reference in an HTL Class that extends WCMUsePojo

You cannot use the @Reference annotation from a HTL class that extends WCMUsePojo. This can be used from a Java class that uses @Service to reference another service known as dependency injection. To learn about Dependency Injection in AEM, see this article: 


Now to learn how to get a referenece to another AEM service from a class that extends WCMUsePojo, see this article: 

Can I use @Reference  from within a Sling Servlet

You can use Dependency Injection from within a Sling Servlet. See this community article/video. 

Can I manipulate the Touch UI Rich Text Editor using code

See this community article - http://experience-aem.blogspot.ca/2015/01/aem-6-sp1-touch-ui-rich-text-editor-plugin-to-upper-case.html

How can I programmatically retrieve HTML from an AEM page

See this great community article by Nolle Yolles: http://www.nateyolles.com/blog/2015/10/get-rendered-html-for-an-aem-resource-or-component

What is cq.editconfig and when should i use it

Where do Lucene, Solr, ElasticSearch fit in the AEM Platform? 

Can i view an asset's metadata in CRXDE lite? 

Assume you have added metadata to a digital asset, as shown in this illustration. 


You can view the assets metadata by viewing a node named metadata under the asset in the AEM dam (/content/dam). For example, the above image is located here:

/content/dam/geometrixx-instore/cover-images/seasonal.jpg

The metadata is stored as node properties as shown in this illustration.


Can I programmatically work with Coral UI object such as checkboxes?

Yes you can. It involves creating a JS script in an AEM Clientlib and then coding. See the reference documentation here:


Given this setup in CRXDE Lite: 



You can get a reference to this checkbox object in a clientlibs folder. The name of the clientlibs folder for Touch UI dialogs is cq.authoring.dialog ( this is talked about here.  http://scottsdigitalcommunity.blogspot.ca/2015/05/using-event-handlers-in-adobe.html).

Code: 

(function ($, $document) {
    "use strict";

   

    $document.on("dialog-ready", function() {


        $('#kitten').attr('checked', true);     

        });


})(jQuery, jQuery(document));

The result is the checkbox is checked via code: 




Note - we are planning on conducting a full session of AEM Ask the Community Experts on AEM Developing with the Coral API April 2017. 

Can i use OAuth in AEM? 

Need to search for special characters when searching JCR via JCR SQL2

Read this topic -- https://wiki.apache.org/jackrabbit/EncodingAndEscaping. YOU  need to escape illegal JCR characters.

How can i work with custom JARs that are not in the Maven repository

You can place the JAR in your local Maven Repository and then reference it in your POM file. For example, to resolve myCustomJAR_1.0.0.jar within an AEM service, the myCustomJAR_1.0.0.jar file must be located in the Maven repository. You can upload the myCustomJAR_1.0.0.jar to Maven by using this Maven command: 

mvn install:install-file -Dfile=C:/plugins/myCustomJAR_1.0.0.jar -DgroupId=com.foo.reports -DartifactId=jrurbersrt1.0 -Dversion=1.0 -Dpackaging=jar -DgeneratePom=true

Notice that you must specify the location of the myCustomJAR file in the -Dfile argument. Also notice that you specify the Dgroup and DartifactID values. Once you upload the JAR to Maven using this command, you can reference this JAR file using this Dependency.

<groupId>com.foo.reports</groupId>
<artifactId>jrurbersrt1.0</artifactId>
<version>1.0</version>
<scope>system</scope>
<systemPath>C:\Users\scottm\.m2\repository\com\foo\reports\jrurbersrt1.0\1.0\myCustomJAR_1.0.0.jar</systemPath>
</dependency>

Notice that scope element is system and systemPath references the location of the JAR file in the repository. (This dependency is used later in this article to build the AEM service) 

How can i work with 3rd party JARs when i create an OSGi bundle

When working with OSGi bundles that use 3rd party JARs (that are located in the Maven Repository), you can embed the 3rd party JAR (for example, Simple JSON JAR) into a separate bundle and deploy to AEM. See this community article/video for details.


http://scottsdigitalcommunity.blogspot.ca/2013/06/posting-form-data-to-adobe-cq-using.html

Enable CORS Access-Control-Allow-Origin in AEM

If you use the default AEM JQuery, it has a token that lets you perform AJAX operations to AEM. 

AEM is experiencing slow page loading

How does Dispatcher Caching work

The dispatcher caches only files which have an extension; and the extensions which should be considered for caching can be configured in the dispatcher config as part of the caching rules.

So you need to add an extension to your service request (e.g. ".json"), and configure the dispatcher accordingly, then the caching will work.



 Capturing comments in a default email template used by an AEM 6.2 workflow

You can write a custom workflow step and inject values you want to populate into a email template with Java logic. For example: 

//Populate the MAP with the values 
 myMap.put("topic.subject",TopicSubject); 
 myMap.put("time",timeStamp); 
 myMap.put("host.prefix",hostPrefix); 
 myMap.put("forum.url",forumUrl); 
                     
 //Declare a MessageGateway service
 MessageGateway<HtmlEmail> messageGateway; 
                        
 //Specify the EMail template 
 String template ="/etc/notification/email/html/com.day.cq.collab.forum/en.txt";
              
 Resource templateRsrc = request.getResourceResolver().getResource(template);
               
 MailTemplate mailTemplate = MailTemplate.create(templateRsrc.getPath(), templateRsrc.getResourceResolver().adaptTo(Session.class));
                      
 HtmlEmail email = mailTemplate.getEmail(StrLookup.mapLookup(myMap), HtmlEmail.class);

A solution without coding is to use the variable ${item.data.comment} in the default en.txt. To see other variables that can be used, see https://docs.adobe.com/docs/en/aem/6-2/administer/operations/notification.html#Configuring the Workflow Email Notification Service.

Join the Adobe Experience Cloud Community 

Join the Adobe Experience Cloud Community by clicking this banner




I (Scott Macdonald) am a Senior Digital Marketing Community Manager at Adobe Systems with 20 years in the high tech industry. I am also a programmer with knowledge in Java, JavaScript, C#,C++, HTML, XML and ActionScript. If  you would like to see more CQ or other Adobe Digital Marketing end to end articles like this, then leave a comment and let me know what content you would like to see.


TwitterFollow the Digital Marketing Customer Care team on Twitter @AdobeExpCare.

YouTube: Subscribe to the AEM Community Channel

4 comments:

  1. This comment has been removed by a blog administrator.

    ReplyDelete
  2. Regarding CORS, how AEM jQuery can help if the content hosted on AEM needs to be accessed by non AEM third-party?

    ReplyDelete
    Replies
    1. In this use case - we are assuming everything is in AEM - ie code in a component is making an AJAX request to a Sling Servlet

      Delete
    2. This might not be the best solution but you can enable cors by following https://enable-cors.org and use jsoup on your 3rd party application. Else you can expose your content as JSON in a content-as-a-service way

      Delete