创建自定义扩展 creating-custom-extensions

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
Developing

创建对象：

Developer

CAUTION

AEM 6.4已结束扩展支持，本文档将不再更新。有关更多详细信息，请参阅技术支助期. 查找支持的版本此处.

通常，在实施项目时，您在AEM和Adobe Campaign中都具有自定义代码。通过使用现有API，您可以在Adobe Campaign中从AEM或从AEM调用Adobe Campaign的自定义代码。本文档介绍如何执行此操作。

前提条件 prerequisites

您需要安装以下组件：

Adobe Experience Manager
Adobe Campaign 6.1

请参阅将AEM与Adobe Campaign 6.1集成以了解更多信息。

示例1:AEM到Adobe Campaign example-aem-to-adobe-campaign

AEM与Campaign之间的标准集成基于JSON和JSSP（JavaScript服务器页面）。这些JSSP文件可在Campaign控制台中找到，所有以 amc (Adobe Marketing Cloud)。

chlimage_1-15

NOTE

对于此示例，请参阅Geometrixx，可从包共享中获取。

在本例中，我们将创建一个新的自定义JSSP文件，并从AEM端调用该文件以检索结果。例如，可用于从Adobe Campaign检索数据或将数据保存到Adobe Campaign中。

在Adobe Campaign中，要创建新的JSSP文件，请单击新建图标。
输入此JSSP文件的名称。在本例中，我们使用 cus:custom.jssp (表示它将位于木槿命名空间)。

将以下代码置于jssp-file中：

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

保存您的工作。其余工作在AEM中。

在AEM端创建一个简单的Servlet以调用此JSSP。在本例中，我们假定：

您在AEM和Campaign之间的连接工作正常
campaign cloudservice配置在 /content/geometrixx-outdoors

此示例中最重要的对象是 GenericCampaignConnector，用于在Adobe Campaign端调用（获取和发布）jssp文件。

以下是一个小代码片段：

code language-none

code language-none
`@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();`

@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();

如本例所示，您需要将凭据传递到调用。您可以通过getCredentials()方法获取此信息，在该方法中，您可以在已配置Campaign云服务的页面中传递。

code language-xml

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

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

完整代码如下：

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;

 }

}

示例2:Adobe Campaign到AEM example-adobe-campaign-to-aem

AEM提供开箱即用的API，用于在siteadmin explorer视图的任意位置检索可用的对象。

chlimage_1-17

NOTE

对于此示例，请参阅Geometrixx，可从包共享中获取。

对于资源管理器中的每个节点，都有一个与之链接的API。例如，对于节点：

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

API是：

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

URL的结尾 .1.json 可由 .2.json, .3.json，根据您希望获得的子级别数， To obtain all thee key 无限可用：

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

现在，要使用API，我们必须知道，默认情况下，AEM使用基本身份验证。

名为 amcIntegration.js 在6.1.1（版本8624及更高版本）中提供，用于实施该逻辑与多个其他逻辑。

AEM API调用 aem-api-call

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;

recommendation-more-help

2315f3f5-cb4a-4530-9999-30c8319c520e