建立自訂Cloud Service creating-a-custom-cloud-service

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

主題：
開發

建立對象：

開發人員

CAUTION

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

預設Cloud Services集可以使用自訂Cloud Service類型進行擴充。這可讓您以結構化方式將自訂標籤插入頁面。這將主要用於第三方分析提供者，例如Google Analytics、Chartbeat等。 Cloud Services會從上層頁面繼承至下層頁面，且能夠在任何層級中斷繼承。

NOTE

此建立新Cloud Service的逐步指南是使用Google Analytics的範例。所有內容皆可能不適用於您的使用案例。

在CRXDE Lite中，在 /apps:
- 名稱: acs
- 類型: nt:folder
在下建立新節點 /apps/acs:
- 名稱: analytics
- 類型: sling:Folder
在下建立2個新節點 /apps/acs/analytics:
- 名稱:元件
- 類型: sling:Folder
和
- 名稱:範本
- 類型: sling:Folder
按一下右鍵 /apps/acs/analytics/components. 選擇 建立…… 後跟 建立元件…… 開啟的對話方塊可讓您指定：
- 標籤: googleanalyticspage
- 標題: Google Analytics Page
- 超級類型: cq/cloudserviceconfigs/components/configpage
- 群組: .hidden
按一下 下一個 兩次，然後指定：
- 允許的父項: acs/analytics/templates/googleanalytics
按一下 下一個 按兩下確定.
新增屬性至 googleanalyticspage:
- 名稱: cq:defaultView
- 值: html

建立名為 content.jsp 在 /apps/acs/analytics/components/googleanalyticspage，包含下列內容：

code language-xml

code language-xml
`<%@page contentType="text/html" pageEncoding="utf-8"%><% %><%@include file="/libs/foundation/global.jsp"%><div> <div> <h3>Google Analytics Settings</h3> <ul> <li><div class="li-bullet"><strong>accountID: </strong><br><%= xssAPI.encodeForHTML(properties.get("accountID", "")) %></div></li> </ul> </div>`

<%@page contentType="text/html"
            pageEncoding="utf-8"%><%
%><%@include file="/libs/foundation/global.jsp"%><div>

<div>
    <h3>Google Analytics Settings</h3>
    <ul>
        <li><div class="li-bullet"><strong>accountID: </strong><br><%= xssAPI.encodeForHTML(properties.get("accountID", "")) %></div></li>
    </ul>
</div>

在下建立新節點 /apps/acs/analytics/components/googleanalyticspage/:
- 名稱: dialog
- 類型: cq:Dialog
- 屬性:
  - 名稱: title
  - 類型: String
  - 值: Google Analytics Config
  - 名稱: xtype
  - 類型: String
  - 值: dialog
在下建立新節點 /apps/acs/analytics/components/googleanalyticspage/dialog:
- 名稱: items
- 類型: cq:Widget
- 屬性:
  - 名稱: xtype
  - 類型: String
  - 值: tabpanel
在下建立新節點 /apps/acs/analytics/components/googleanalyticspage/dialog/items:
- 名稱: items
- 類型: cq:WidgetCollection
在下建立新節點 /apps/acs/analytics/components/googleanalyticspage/dialog/items/items:
- 名稱:tab1
- 類型: cq:Panel
- 屬性:
  - 名稱: title
  - 類型: String
  - 值: Config
在下建立新節點 /apps/acs/analytics/components/googleanalyticspage/dialog/items/items/tab1:
- 名稱:項目
- 類型: nt:unstructured
- 屬性:
  - 名稱: fieldLabel
  - 類型:字串
  - 值:帳戶ID
  - 名稱: fieldDescription
  - 類型: String
  - 值: The account ID assigned by Google. Usually in the form UA-NNNNNN-N
  - 名稱: name
  - 類型: String
  - 值: ./accountID
  - 名稱: validateOnBlur
  - 類型: String
  - 值: true
  - 名稱: xtype
  - 類型: String
  - 值: textfield
複製 /libs/cq/cloudserviceconfigs/components/configpage/body.jsp to /apps/acs/analytics/components/googleanalyticspage/body.jsp 變更 libs to apps 在第34行上，並將第79行上的指令碼引用設為完全限定的路徑。
在下建立新範本 /apps/acs/analytics/templates/:
- with 資源類型 = acs/analytics/components/googleanalyticspage
- with 標籤 = googleanalytics
- with 標題= Google Analytics Configuration
- with allowedPath = /etc/cloudservices/googleanalytics(/.*)?
- with allowedChildren = /apps/acs/analytics/templates/googleanalytics
- with sling:resourceSuperType = cq/cloudserviceconfigs/templates/configpage （在範本節點上，而非jcr:content節點）
- with cq:designPath = /etc/designs/cloudservices/googleanalytics （在jcr:content上）

建立新元件： /apps/acs/analytics/components/googleanalytics.

將下列內容新增至 googleanalytics.jsp:

code language-xml

code language-xml
<%@page import="org.apache.sling.api.resource.Resource, org.apache.sling.api.resource.ValueMap, org.apache.sling.api.resource.ResourceUtil, com.day.cq.wcm.webservicesupport.Configuration, com.day.cq.wcm.webservicesupport.ConfigurationManager" %> <%@include file="/libs/foundation/global.jsp" %><% String[] services = pageProperties.getInherited("cq:cloudserviceconfigs", new String[]{}); ConfigurationManager cfgMgr = resource.getResourceResolver().adaptTo(ConfigurationManager.class); if(cfgMgr != null) { String accountID = null; Configuration cfg = cfgMgr.getConfiguration("googleanalytics", services); if(cfg != null) { accountID = cfg.get("accountID", null); } if(accountID != null) { %> <script type="text/javascript"> var _gaq = _gaq \|\| []; _gaq.push(['_setAccount', '<%= accountID %>']); _gaq.push(['_trackPageview']); (function() { var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'https://www') + '.google-analytics.com/ga.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); })(); </script><% } } %>

<%@page import="org.apache.sling.api.resource.Resource,
                org.apache.sling.api.resource.ValueMap,
                org.apache.sling.api.resource.ResourceUtil,
                com.day.cq.wcm.webservicesupport.Configuration,
                com.day.cq.wcm.webservicesupport.ConfigurationManager" %>
<%@include file="/libs/foundation/global.jsp" %><%

String[] services = pageProperties.getInherited("cq:cloudserviceconfigs", new String[]{});
ConfigurationManager cfgMgr = resource.getResourceResolver().adaptTo(ConfigurationManager.class);
if(cfgMgr != null) {
    String accountID = null;
    Configuration cfg = cfgMgr.getConfiguration("googleanalytics", services);
    if(cfg != null) {
        accountID = cfg.get("accountID", null);
    }

    if(accountID != null) {
    %>
<script type="text/javascript">

  var _gaq = _gaq || [];
  _gaq.push(['_setAccount', '<%= accountID %>']);
  _gaq.push(['_trackPageview']);

  (function() {
    var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
    ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'https://www') + '.google-analytics.com/ga.js';
    var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
  })();

</script><%
    }
}
%>

這應該會根據設定屬性輸出自訂標籤。

導覽至 http://localhost:4502/miscadmin#/etc/cloudservices 並建立新頁面：
- 標題: Google Analytics
- 名稱: googleanalytics
返回CRXDE Lite，然後 /etc/cloudservices/googleanalytics，將下列屬性新增至 jcr:content:
- 名稱: componentReference
- 類型: String
- 值: acs/analytics/components/googleanalytics
導覽至新建立的服務頁面( http://localhost:4502/etc/cloudservices/googleanalytics.html)，然後按一下 + 要建立新配置：
- 父設定: /etc/cloudservices/googleanalytics
- 標題: My First GA Config
選擇 Google Analytics設定 按一下建立.
輸入 帳戶ID，例如 AA-11111111-1. 按一下 「確定」。
導覽至頁面，並在頁面屬性中新增新建立的設定，位於 Cloud Services 標籤。
頁面會新增自訂標籤。

recommendation-more-help

2315f3f5-cb4a-4530-9999-30c8319c520e