建立自訂擴充功能 creating-custom-extensions

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

主題：
開發

建立對象：

開發人員

CAUTION

AEM 6.4已結束延伸支援，本檔案不再更新。如需詳細資訊，請參閱技術支援期. 尋找支援的版本此處.

通常當您實作專案時，AEM和Adobe Campaign中都有自訂程式碼。使用現有API後，您就可以從AEM或從AEM呼叫Adobe Campaign中的自訂程式碼至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伺服器頁面」）為基礎。您可以在Campaign主控台中找到這些JSSP檔案，所有開頭皆為 amc (Adobe Marketing Cloud)。

chlimage_1-15

NOTE

如需此範例，請參閱Geometrixx，可從「封裝共用」取得。

在此範例中，我們會建立新的自訂JSSP檔案，並從AEM端呼叫該檔案以擷取結果。例如，這可用來從Adobe Campaign擷取資料，或將資料儲存至Adobe Campaign。

在Adobe Campaign中，若要建立新的JSSP檔案，請按一下新增表徵圖。
輸入此JSSP檔案的名稱。在此範例中，我們使用 cus:custom.jssp (這表示它會在 cus 命名空間)。

將下列程式碼放入jssp-file中：

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

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

在AEM端建立簡單的servlet以呼叫此JSSP。在此範例中，我們假設如下：

您的連線可在AEM和Campaign之間運作
促銷活動雲端服務已設定於 /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，可擷取網站管理員檔案總管檢視中任何位置可用的物件。

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，根據您想要取得的子層級數，以取得所有子層級的關鍵字無窮可使用：

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

現在，若要使用API，我們必須知道AEM依預設會使用基本驗證。

名為的JS程式庫 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