구성 및 구성 브라우저 configuration-browser

AEM 구성은 AEM에서 설정을 관리하고 작업 공간으로 사용됩니다.

구성이란? what-is-a-configuration

구성은 두 가지 다른 관점에서 고려될 수 있다.

요약: 관리자의 관점에서 구성은 AEM에서 설정을 관리하는 작업 영역을 만드는 방법이지만 개발자는 AEM이 저장소 내에서 이러한 구성을 사용하고 관리하는 방법을 이해해야 합니다.

사용자의 관점에서 볼 때 구성은 AEM에서 두 가지 주요 목적을 제공합니다.

관리자로서의 구성 configurations-administrator

AEM 관리자 및 작성자는 구성을 작업 공간으로 고려할 수 있습니다. 이러한 작업 공간은 이러한 기능에 대한 액세스 권한을 구현하여 조직 목적으로 설정 그룹 및 관련 콘텐츠를 수집하는 데 사용할 수 있습니다.

AEM 내의 다양한 기능에 대해 구성을 만들 수 있습니다.

예 administrator-example

예를 들어, 관리자는 편집 가능한 템플릿에 대해 두 가지 구성을 만들 수 있습니다.

그런 다음 관리자는 WKND 일반 구성을 사용하여 일반 페이지 템플릿을 만든 다음 WKND-Magazine 아래에 있는 매거진 관련 템플릿을 만들 수 있습니다.

그런 다음 관리자는 WKND-General을 WKND 사이트의 모든 콘텐츠와 연결할 수 있습니다. 그러나 WKND-Magazine 구성은 매거진 사이트와만 연결됩니다.

다음을 수행합니다.

편집 가능한 템플릿뿐만 아니라 클라우드 구성, ContextHub 세그먼트 및 콘텐츠 조각 모델에도 유사한 설정이 가능합니다.

구성 브라우저 사용 using-configuration-browser

관리자는 구성 브라우저를 사용하여 AEM에서 구성에 대한 액세스 권한을 쉽게 만들고, 관리하고, 구성할 수 있습니다.

구성 만들기 creating-a-configuration

구성 브라우저를 사용하여 AEM에서 구성을 간단하게 만들 수 있습니다.

구성 및 해당 액세스 권한 편집 access-rights

구성을 작업 영역으로 생각하면 해당 구성에 액세스 권한을 설정하여 누가 해당 작업 영역에 액세스할 수 있고 액세스할 수 없는지 적용할 수 있습니다.

개발자로서의 구성 configurations-developer

개발자로서 AEM as a Cloud Service이 구성에서 작동하는 방식과 구성 해결을 처리하는 방법을 아는 것이 중요합니다.

구성 및 컨텐츠 분리 separation-of-config-and-content

관리자와 사용자는 서로 다른 설정 및 콘텐츠를 관리하기 위해 구성을 작업 공간(으)로 생각할 수 있지만, 구성 및 콘텐츠는 저장소의 AEM에 의해 별도로 저장되고 관리된다는 것을 이해하는 것이 중요합니다.

콘텐츠는 cq:conf 속성을 통해 연결된 구성을 참조합니다. AEM은 콘텐츠 및 해당 컨텍스트 cq:conf 속성을 기반으로 조회를 수행하여 적절한 구성을 찾습니다.

예 developer-example

이 예에서는 DAM 설정에 관심이 있는 응용 프로그램 코드가 있다고 가정해 보겠습니다.

Conf conf = resource.adaptTo(Conf.class);
ValueMap imageServerSettings = conf.getItem("dam/imageserver");
String bgkcolor = imageServerSettings.get("bgkcolor", "FFFFFF");

모든 구성 조회의 시작점은 콘텐츠 리소스이며, /content 아래에 있습니다. 페이지, 페이지 내의 구성 요소, 에셋 또는 DAM 폴더일 수 있습니다. 이 컨텍스트에서 적용되는 올바른 구성을 찾고 있는 실제 콘텐츠입니다.

이제 Conf 개체를 통해 관심 있는 특정 구성 항목을 검색할 수 있습니다. 이 경우 imageserver과(와) 관련된 설정의 컬렉션인 dam/imageserver입니다. getItem 호출이 ValueMap을(를) 반환합니다. 그런 다음 bgkcolor 문자열 속성을 읽고 속성(또는 전체 구성 항목)이 없는 경우 "FFFFFF"의 기본값을 제공합니다.

이제 해당 JCR 콘텐츠를 살펴보겠습니다.

/content/dam/wknd
    + jcr:content
      - cq:conf = "/conf/wknd"
    + image.png [dam:Asset]

/conf/wkns
    + settings
      + dam
        + imageserver [cq:Page]
          + jcr:content
            - bgkcolor = "FF0000"

이 예에서는 여기에서 WKND별 DAM 폴더와 해당 구성을 가정할 수 있습니다. 해당 폴더 /content/dam/wknd부터 하위 트리에 적용해야 하는 구성을 참조하는 문자열 속성 cq:conf이(가) 있음을 확인할 수 있습니다. 속성이 자산 폴더 또는 페이지의 jcr:content에 설정되어 있습니다. 이러한 conf 링크는 명시적이므로 CRXDE의 콘텐츠만 보면 쉽게 따라갈 수 있습니다.

/conf 내에서 점프하면 참조를 따라 /conf/wknd 노드가 있는지 확인할 수 있습니다. 이는 구성입니다. 조회는 애플리케이션 코드를 통과시킵니다. 예제 코드에는 전용 참조가 없으므로 Conf 개체 뒤에 숨겨집니다. 적용되는 구성은 JCR 콘텐츠를 통해 제어됩니다.

구성에 이 경우에 필요한 dam/imageserver을(를) 포함하여 실제 항목을 포함하는 고정 이름의 settings 노드가 포함되어 있음을 알 수 있습니다. 이러한 항목은 "설정 문서"로 생각할 수 있으며 실제 콘텐츠를 포함하는 jcr:content을(를) 포함하는 cq:Page로 표시됩니다.

마지막으로 샘플 코드에 필요한 속성 bgkcolor을(를) 볼 수 있습니다. getItem에서 다시 가져온 ValueMap은(는) 페이지의 jcr:content 노드를 기반으로 합니다.

구성 해결 방법 configuration-resolution

위의 기본 예에서는 단일 구성을 보여 주었습니다. 그러나 기본 전역 구성, 각 브랜드마다 다른 구성 및 하위 프로젝트별로 특정 구성과 같은 다른 구성을 원하는 경우가 많습니다.

이를 지원하기 위해 AEM의 구성 조회에는 다음과 같은 기본 설정 순서로 상속 및 폴백 메커니즘이 있습니다.

구성 사용 using-configurations

AEM의 구성은 슬링 컨텍스트 인식 구성을 기반으로 합니다. Sling 번들은 컨텍스트 인식 구성을 가져오는 데 사용할 수 있는 서비스 API를 제공합니다. 컨텍스트 인식 구성은 이전 예에서 설명한 대로 콘텐츠 리소스 또는 리소스 트리와 관련된 구성입니다.

컨텍스트 인식 구성, 예제 및 사용 방법에 대한 자세한 내용은 Sling 설명서를 참조하십시오.

ConfMgr 웹 콘솔 confmgr-web-console

디버깅 및 테스트 목적으로 https://<host>:<port>/system/console/conf에 지정된 경로/항목에 대한 구성을 표시할 수 있는 ConfMgr 웹 콘솔이 있습니다.

간단히 다음을 제공합니다.

확인된 구성을 확인하고 해당 구성을 확인하는 샘플 코드를 받으려면 확인 ​을 선택합니다.

컨텍스트 인식 구성 웹 콘솔 context-aware-web-console

디버깅 및 테스트 목적으로 https://<host>:<port>/system/console/slingcaconfig에 컨텍스트 인식 구성 웹 콘솔이 있으며, 이를 통해 저장소의 컨텍스트 인식 구성을 쿼리하고 해당 속성을 볼 수 있습니다.

간단히 다음을 제공합니다.

선택한 구성에 대해 연결된 컨텍스트 경로 및 속성을 검색하려면 확인 ​을 선택합니다.