Criação de extensões personalizadas

Geralmente, ao implementar um projeto, você tem um código personalizado no AEM e no Adobe Campaign. Com o uso da API existente, você pode chamar seu código personalizado no Adobe Campaign de AEM ou do AEM para o Adobe Campaign. Este documento descreve como fazer isso.

Pré-requisitos

Você deve ter o seguinte instalado:

• Adobe Experience Manager
• Adobe Campaign 6.1

Consulte Integração do AEM ao Adobe Campaign 6.1 para obter mais informações.

Exemplo 1: AEM para Adobe Campaign

A integração padrão entre o AEM e o Campaign é baseada em JSON e JSSP (JavaScript Server Page). Esses arquivos JSSP podem ser encontrados no console do Campaign e todos começam com aec (Adobe Experience Cloud)

Neste exemplo, um novo arquivo JSSP personalizado foi criado e o chama do lado do AEM para recuperar o resultado. Ela pode ser usada, por exemplo, para recuperar dados do Adobe Campaign ou para salvar dados no Adobe Campaign.

1. No Adobe Campaign, para criar um arquivo JSSP, clique no link Novo ícone.

   

2. Insira o nome deste arquivo JSSP. Neste exemplo, cus:custom.jssp é usado (o que significa que está na cus namespace).

   

3. Coloque o seguinte código dentro do arquivo jssp:

   <%
   var origin = request.getParameter("origin");
   document.write("Hello from Adobe Campaign, origin : " + origin);
   %>
   

4. Salve o trabalho. O trabalho restante é no AEM.

5. Crie um servlet simples no lado do AEM para que você possa chamar esse JSSP. Neste exemplo, você pode assumir o seguinte:

   • Você tem a conexão entre AEM e Campaign
   • O serviço de nuvem do Campaign está configurado em /content/geometrixx-outdoors

   O objeto mais importante neste exemplo é o GenericCampaignConnector, que permite chamar (obter e publicar) arquivos jssp no Adobe Campaign.

   Este é um pequeno trecho de código:

   @Reference
   private GenericCampaignConnector campaignConnector;
   ...
   Map<String, String> params = new HashMap<String, String>();
   params.put("origin", "AEM");
   CallResults results = campaignConnector.callGeneric("/jssp/cus/custom.jssp", params, credentials);
   return results.bodyAsString();
   

6. Neste exemplo, você deve passar as credenciais para a chamada do. É possível obtê-los por meio do método getCredentials(), onde você passa em uma página que tem o serviço de nuvem do Campaign configurado.

   // page containing the cloudservice for Adobe Campaign
   Configuration config = campaignConnector.getWebserviceConfig(page.getContentResource().getParent());
   CampaignCredentials credentials = campaignConnector.retrieveCredentials(config);
   

O código completo é o seguinte:

import java.io.IOException;
import java.io.PrintWriter;
import java.util.HashMap;
import java.util.Map;

import javax.servlet.ServletException;

import org.apache.felix.scr.annotations.Reference;
import org.apache.felix.scr.annotations.sling.SlingServlet;
import org.apache.sling.api.SlingHttpServletRequest;
import org.apache.sling.api.SlingHttpServletResponse;
import org.apache.sling.api.servlets.SlingSafeMethodsServlet;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import com.day.cq.mcm.campaign.CallResults;
import com.day.cq.mcm.campaign.CampaignCredentials;
import com.day.cq.mcm.campaign.GenericCampaignConnector;
import com.day.cq.wcm.api.Page;
import com.day.cq.wcm.api.PageManager;
import com.day.cq.wcm.api.PageManagerFactory;
import com.day.cq.wcm.webservicesupport.Configuration;

@SlingServlet(paths="/bin/campaign", methods="GET")
public class CustomServlet extends SlingSafeMethodsServlet {

 private final Logger log = LoggerFactory.getLogger(this.getClass());

 @Reference
 private GenericCampaignConnector campaignConnector;

 @Reference
 private PageManagerFactory pageManagerFactory;

 @Override
 protected void doGet(SlingHttpServletRequest request,
   SlingHttpServletResponse response) throws ServletException,
   IOException {

  PageManager pm = pageManagerFactory.getPageManager(request.getResourceResolver());

  Page page = pm.getPage("/content/geometrixx-outdoors");

  String result = null;
  if ( page != null) {
   result = callCustomFunction(page);
  }
  if ( result != null ) {
   PrintWriter pw = response.getWriter();
   pw.print(result);
  }
 }

 private String callCustomFunction(Page page ) {
  try {
   Configuration config = campaignConnector.getWebserviceConfig(page.getContentResource().getParent());
   CampaignCredentials credentials = campaignConnector.retrieveCredentials(config);

   Map<String, String> params = new HashMap<String, String>();
   params.put("origin", "AEM");
   CallResults results = campaignConnector.callGeneric("/jssp/cus/custom.jssp", params, credentials);
   return results.bodyAsString();
  } catch (Exception e ) {
   log.error("Something went wrong during the connection", e);
  }
  return null;

 }

}

Exemplo 2: Adobe Campaign para AEM

O AEM oferece APIs prontas para recuperar os objetos disponíveis em qualquer lugar na visualização do explorador do siteadmin.

Para cada nó no explorador, há uma API vinculada a ele. Por exemplo, para o nó :

• http://localhost:4502/siteadmin#/content/campaigns/geometrixx/scott-recommends

A API é:

• http://localhost:4502/content/campaigns/geometrixx/scott-recommends.1.json

O fim do URL .1.json pode ser substituído por .2.json, .3.json, de acordo com o número de subníveis que você está interessado em obter. Para obter a palavra-chave de todos eles, infinito pode ser usado:

• http://localhost:4502/content/campaigns/geometrixx/scott-recommends.infinity.json

Para consumir a API, o AEM, por padrão, usa autenticação básica.

Uma biblioteca JS chamada amcIntegration.js O está disponível na versão 6.1.1 (build 8624 e superior) que implementa essa lógica, entre várias outras.

Chamada de API AEM

loadLibrary("nms:amcIntegration.js");

var cmsAccountId = sqlGetInt("select iExtAccountId from NmsExtAccount where sName=$(sz)","aemInstance")
var cmsAccount = nms.extAccount.load(String(cmsAccountId));
var cmsServer = cmsAccount.server;

var request = new HttpClientRequest(cmsServer+"/content/campaigns/geometrixx.infinity.json")
aemAddBasicAuthentication(cmsAccount, request);
request.method = "GET"
request.header["Content-Type"] = "application/json; charset=UTF-8";
request.execute();
var response = request.response;