설명서AEM 6.5사용 안내서

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

Last update: Wed Apr 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • Developer

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

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

개념 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

사용 가능한 서비스는 Cloud Service 의 탭 페이지 속성 을 상속하는 모든 페이지의 대화 상자 foundation/components/page 또는 wcm/mobile/components/page).

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

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

암호 암호화 password-encryption

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

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

password@Encrypted

그러면 속성이 자동으로 암호화됩니다(다음을 사용하여). CryptoSupport 에 의해 제공) EncryptionPostProcessor.

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

서비스 페이지 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