설명서AEM 6.5사용 안내서

클라우드 서비스 구성 cloud-service-configurations

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 개발자

실시예들은 서비스 구성들을 저장하기 위한 로직 및 구조를 제공하도록 설계된다.

기존 인스턴스를 확장하여 자체 구성을 만들 수 있습니다.

개념 concepts

구성 개발에 사용된 원칙은 다음 개념을 기반으로 합니다.

  • 서비스/어댑터는 구성을 검색하는 데 사용됩니다.
  • 구성(예: 속성/단락)은 상위 항목에서 상속됩니다.
  • 경로로 분석 노드에서 참조됩니다.
  • 쉽게 확장 가능.
  • Adobe Analytics과 같이 보다 복잡한 구성을 제공할 수 있는 유연성이 있습니다.
  • 종속성 지원(예: Adobe Analytics 플러그인에는 Adobe Analytics 구성이 필요함).

구조 structure

구성의 기본 경로는 다음과 같습니다.

/etc/cloudservices

각 구성 유형에 대해 템플릿과 구성 요소가 제공됩니다. 이를 통해 맞춤화된 후 대부분의 요구 사항을 충족할 수 있는 구성 템플릿을 가질 수 있습니다.

새 서비스에 대한 구성을 제공하려면 다음 작업을 수행하십시오.

  • 에서 서비스 페이지 만들기

    /etc/cloudservices

  • 이 아래에는 다음 항목이 있습니다.

    • 구성 템플릿
    • 구성 구성 요소

템플릿 및 구성 요소는 기본 템플릿에서 sling:resourceSuperType을(를) 상속해야 합니다.

cq/cloudserviceconfigs/templates/configpage

또는 베이스 컴포넌트 각각

cq/cloudserviceconfigs/components/configpage

또한 서비스 제공업체는 서비스 페이지를 제공해야 합니다.

/etc/cloudservices/<service-name>

템플릿 template

템플릿이 기본 템플릿을 확장합니다.

cq/cloudserviceconfigs/templates/configpage

사용자 지정 구성 요소를 가리키는 resourceType을(를) 정의합니다.

/libs/cq/analytics/templates/sitecatalyst
sling:resourceSuperType = cq/cloudserviceconfigs/templates/configpage
allowedChildren = /libs/cq/analytics/templates/sitecatalyst
allowedPaths = /etc/cloudservices/analytics/*, /etc/cloudservices/analytics/.*
componentReference = cq/analytics/components/sitecatalyst
jcr:content/
cq:designPath = /etc/designs/cloudservices
sling:resourceType = cq/analytics/components/sitecatalystpage

/libs/cq/analytics/templates/generictracker
sling:resourceSuperType = cq/cloudservices/templates/configpage
allowedChildren = /libs/cq/analytics/templates/generictracker
allowedPaths = /etc/cloudservices/analytics/*, /etc/cloudservices/analytics/.*
jcr:content/
cq:designPath = /etc/designs/cloudservices
sling:resourceType = cq/analytics/components/generictrackerpage

구성 요소 components

구성 요소는 기본 구성 요소를 확장해야 합니다.

cq/cloudserviceconfigs/templates/configpage

/libs/cq/analytics/components/sitecatalystpage

/libs/cq/analytics/components/generictrackerpage

템플릿과 구성 요소를 설정한 후 아래 하위 페이지를 추가하여 구성을 추가할 수 있습니다.

/etc/cloudservices/<service-name>

콘텐츠 모델 content-model

콘텐츠 모델은 다음 아래에 cq:Page(으)로 저장됩니다.

/etc/cloudservices/<service-name>(/*)

/etc/cloudservices
/etc/cloudservices/service-name
/etc/cloudservices/service-name/config
/etc/cloudservices/service-name/config/inherited-config

구성은 하위 노드 jcr:content 아래에 저장됩니다.

  • 대화 상자에서 정의된 고정 속성은 jcr:node에 직접 저장해야 합니다.
  • 동적 요소(parsys 또는 iparsys 사용)는 하위 노드를 사용하여 구성 요소 데이터를 저장합니다.
/etc/cloudservices/service/config/jcr:content as nt:unstructured
propertyname
*
par/component/ as cq:Component
propertyname
*

API api

API에 대한 참조 설명서는 com.day.cq.wcm.webservicesupport를 참조하십시오.

AEM 통합 aem-integration

사용 가능한 서비스는 foundation/components/page 또는 wcm/mobile/components/page에서 상속되는 모든 페이지의 Cloud Service 속성 대화 상자의 페이지 탭에 나열됩니다.

탭에는 다음 기능도 제공됩니다.

  • 서비스를 활성화할 수 있는 위치에 대한 링크
  • 경로 필드에서 구성(서비스의 하위 노드)을 선택합니다

암호 암호화 password-encryption

서비스에 대한 사용자 자격 증명을 저장할 때 모든 암호를 암호화해야 합니다.

숨겨진 양식 필드를 추가하여 이를 수행할 수 있습니다. 이 필드에는 속성 이름에 @Encrypted 주석이 있어야 합니다. 즉, password 필드의 경우 이름이 다음과 같이 작성됩니다.

password@Encrypted

그러면 속성이 EncryptionPostProcessor에 의해 CryptoSupport 서비스를 사용하여 자동으로 암호화됩니다.

NOTE
표준 [SlingPostServlet](https://sling.apache.org/site/manipulating-content-the-slingpostservlet-servletspost.html) 주석과 유사합니다.
NOTE
기본적으로 EcryptionPostProcessor은(는) /etc/cloudservices에 대한 POST개의 요청만 암호화합니다.

서비스 페이지 jcr:content 노드에 대한 추가 속성 additional-properties-for-service-page-jcr-content-nodes

속성
설명
componentReference
페이지에 자동으로 포함될 구성 요소에 대한 참조 경로.
추가 기능 및 JS 포함에 사용됩니다.

cq/cloudserviceconfigs/components/servicecomponents
이(가) 포함된 페이지의 구성 요소를 포함합니다(일반적으로 body 태그 이전).
Adobe Analytics 및 Adobe Target의 경우 이를 사용하여 방문자 행동을 추적하기 위한 JavaScript 호출과 같은 추가 기능을 포함합니다.
설명
서비스에 대한 간략한 설명입니다.
descriptionExtended
서비스에 대한 확장된 설명입니다.
등급
목록에 사용할 서비스 순위.
selectableChildren
페이지 속성 대화 상자에서 구성을 표시하기 위한 필터입니다.
serviceUrl
서비스 웹 사이트의 URL.
serviceUrlLabel
서비스 URL에 대한 레이블입니다.
썸네일 경로
서비스 축소판 경로.
표시
페이지 속성 대화 상자의 가시성, 기본적으로 표시(선택 사항)

사용 사례 use-cases

이러한 서비스는 기본적으로 제공됩니다.

NOTE
사용자 지정 Cloud Service 만들기도 참조하세요.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2