사용자 지정 클라우드 서비스 만들기

기본 Cloud Services 세트는 사용자 지정 Cloud Service 유형으로 확장할 수 있습니다. 이렇게 하면 구조화된 방식으로 페이지에 사용자 지정 마크업을 삽입할 수 있습니다. 주로 타사 분석 공급자(예: Google Analytics, Chartbeat 등)에 사용됩니다. Cloud Services은 상위 페이지에서 하위 페이지로 상속되며, 특정 수준에서 상속을 분류할 수 있습니다.

노트

새 Cloud Service을 만들기 위한 이 단계별 안내서는 Google Analytics을 사용하는 예제입니다. 모든 것이 사용 사례에 적용되지 않을 수 있습니다.

  1. CRXDE Lite에서 /apps 아래에 새 노드를 만듭니다.

    • 이름: acs
    • 유형: nt:folder
  2. /apps/acs 아래에 새 노드를 만듭니다.

    • 이름: analytics
    • 유형: sling:Folder
  3. /apps/acs/analytics 아래에 새 노드 2개를 만듭니다.

    • 이름:구성 요소
    • 유형: sling:Folder

    • 이름:템플릿
    • 유형: sling:Folder
  4. /apps/acs/analytics/components을 마우스 오른쪽 단추로 클릭합니다. 만들기… 를 선택합니다. 다음에 구성 요소 만들기… 대화 상자가 열리면 다음을 지정할 수 있습니다.

    • 레이블: googleanalyticspage
    • 제목: Google Analytics Page
    • Super Type: cq/cloudserviceconfigs/components/configpage
    • 그룹: .hidden
  5. 다음​을 두 번 클릭하고 다음을 지정합니다.

    • 허용된 상위: acs/analytics/templates/googleanalytics

    다음​을 두 번 클릭하고 확인​을 클릭합니다.

  6. googleanalyticspage에 속성 추가:

    • 이름: cq:defaultView
    • 값: html
  7. /apps/acs/analytics/components/googleanalyticspage 아래에 content.jsp 라는 새 파일을 만들고 다음 내용을 사용합니다.

    <%@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>
    
  8. /apps/acs/analytics/components/googleanalyticspage/ 아래에 새 노드를 만듭니다.

    • 이름: dialog

    • 유형: cq:Dialog

    • 속성:

      • 이름: title
      • 유형: String
      • : Google Analytics Config
      • 이름: xtype
      • 유형: String
      • : dialog
  9. /apps/acs/analytics/components/googleanalyticspage/dialog 아래에 새 노드를 만듭니다.

    • 이름: items

    • 유형: cq:Widget

    • 속성:

      • 이름: xtype
      • 유형: String
      • : tabpanel
  10. /apps/acs/analytics/components/googleanalyticspage/dialog/items 아래에 새 노드를 만듭니다.

    • 이름: items
    • 유형: cq:WidgetCollection
  11. /apps/acs/analytics/components/googleanalyticspage/dialog/items/items 아래에 새 노드를 만듭니다.

    • 이름:tab1

    • 유형: cq:Panel

    • 속성:

      • 이름: title
      • 유형: String
      • : Config
  12. /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

  13. /libs/cq/cloudserviceconfigs/components/configpage/body.jsp/apps/acs/analytics/components/googleanalyticspage/body.jsp에 복사하고 34번에 libsapps로 변경하고 79줄에 있는 스크립트 참조를 정규화된 경로로 만듭니다.

  14. /apps/acs/analytics/templates/ 아래에 새 템플릿을 만듭니다.

    • 리소스 유형 = acs/analytics/components/googleanalyticspage 사용
    • Label = googleanalytics 사용
    • Title= Google Analytics Configuration 사용
    • allowedPath = /etc/cloudservices/googleanalytics(/.*)? 사용
    • allowedChildren = /apps/acs/analytics/templates/googleanalytics 사용
    • sling:resourceSuperType = cq/cloudserviceconfigs/templates/configpage (템플릿 노드에서 jcr:content 노드가 아님)을 사용하여
    • cq:designPath = /etc/designs/cloudservices/googleanalytics 사용(jcr:content에서)
  15. 새 구성 요소 만들기:/apps/acs/analytics/components/googleanalytics

    다음 컨텐츠를 googleanalytics.jsp에 추가합니다.

    <%@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><%
        }
    }
    %>
    

    이렇게 하면 구성 속성을 기반으로 사용자 지정 마크업이 출력됩니다.

  16. http://localhost:4502/miscadmin#/etc/cloudservices 로 이동하여 새 페이지를 만듭니다.

    • 제목: Google Analytics
    • 이름: googleanalytics

    CRXDE Lite으로 돌아가서 /etc/cloudservices/googleanalytics 아래에서 jcr:content에 다음 속성을 추가합니다.

    • 이름: componentReference
    • 유형: String
    • : acs/analytics/components/googleanalytics
  17. 새로 만든 서비스 페이지( http://localhost:4502/etc/cloudservices/googleanalytics.html)로 이동하고 +​를 클릭하여 새 구성을 만듭니다.

    • 상위 구성: /etc/cloudservices/googleanalytics
    • 제목: My First GA Config

    Google Analytics 구성​을 선택하고 만들기​를 클릭합니다.

  18. 계정 ID​를 입력합니다(예: AA-11111111-1). 확인​을 클릭합니다.

  19. 페이지로 이동하여 Cloud Services 탭 아래의 페이지 속성에 새로 만든 구성을 추가합니다.

  20. 페이지에 사용자 지정 마크업이 추가됩니다.

이 페이지에서는