AEM 태그 지정 프레임워크 aem-tagging-framework

태깅을 사용하면 컨텐츠를 분류하고 구성할 수 있습니다. 태그는 네임스페이스와 분류법으로 분류할 수 있습니다. 태그 사용에 대한 자세한 내용은 다음을 참조하십시오.

이 문서에서는 AEM에서 태그 지정을 지원하는 기본 프레임워크와 개발자로 사용하는 방법에 대해 중점적으로 다룹니다.

소개 introduction

콘텐츠에 태그를 지정하고 AEM 태그 지정 인프라를 사용하려면 다음을 수행하십시오.

태그 : cq:Tag 노드 유형 tags-cq-tag-node-type

태그의 선언은 유형의 노드에서 저장소에 캡처됩니다 cq:Tag.

태그는 간단한 단어일 수 있습니다(예: sky) 또는 계층 분류를 나타냅니다(예: fruit/apple: 제네릭을 모두 의미합니다 fruit 및 보다 구체적임 apple).

태그는 고유한 TagID로 식별됩니다.

태그에는 제목, 현지화된 제목 및 설명과 같은 선택적 메타 정보가 있습니다. 존재하는 경우 제목은 TagID 대신 사용자 인터페이스에 표시되어야 합니다.

태깅 프레임워크는 작성자와 사이트 방문자가 사전 정의된 특정 태그만 사용하도록 제한하는 기능도 제공합니다.

태그 특성 tag-characteristics

태그는 단순히 JCR 노드이므로 노드 이름은 JCR 명명 규칙.

태그 ID tagid

TagID는 저장소의 태그 노드로 확인되는 경로를 식별합니다.

일반적으로 TagID는 네임스페이스로 시작하는 줄임 표기 TagID이거나 분류 루트 노드.

컨텐츠에 태그가 지정되어 있지만 아직 존재하지 않는 경우 [cq:tags](#tagged-content-cq-tags-property) 속성이 콘텐츠 노드에 추가되고 TagID가 속성의 String 배열 값.

TagID는 네임스페이스 뒤에 로컬 TagID가 옵니다. 컨테이너 태그 에는 분류법의 계층 구조 순서를 나타내는 하위 태그가 있습니다. 하위 태그를 사용하여 모든 로컬 TagID와 동일한 태그를 참조할 수 있습니다. 예를 들어 콘텐츠에 태그 지정 fruit 다음과 같은 하위 태그가 있는 컨테이너 태그인 경우에도 허용됩니다. fruit/apple 및 fruit/banana.

분류 루트 노드 taxonomy-root-node

분류 루트 노드는 저장소의 모든 태그에 대한 기본 경로입니다. 분류법 루트 노드는 유형의 노드가 아니어야 합니다. cq:Tag.

AEM에서 기본 경로는 /content/cq:tags 및 루트 노드는 유형이 있습니다. cq:Folder.

태그 네임스페이스 tag-namespace

네임스페이스를 사용하면 항목을 그룹화할 수 있습니다. 가장 일반적인 사용 사례는 사이트당 네임스페이스(예: 공개, 내부 및 포털) 또는 더 큰 애플리케이션(예: WCM, Assets, Communities)당 네임스페이스입니다. 그러나 네임스페이스는 다양한 다른 요구 사항에 사용할 수 있습니다. 네임스페이스는 사용자 인터페이스에서 현재 콘텐츠에 적용할 수 있는 태그의 하위 집합(즉, 특정 네임스페이스의 태그)만 표시하는 데 사용됩니다.

태그의 네임스페이스는 분류 하위 트리의 첫 번째 수준이며, 이 트리는 바로 아래에 있는 노드입니다. 분류 루트 노드. 네임스페이스는 유형의 노드입니다. cq:Tag 부모가 다음이 아님 cq:Tag 노드 유형.

모든 태그에는 네임스페이스가 있습니다. 네임스페이스를 지정하지 않으면 태그는 기본 네임스페이스인 TagID에 할당됩니다 default 제목 포함 Standard Tags, 즉, /content/cq:tags/default.

컨테이너 태그 container-tags

컨테이너 태그는 유형의 노드입니다. cq:Tag 임의 개수의 하위 노드를 포함하여 사용자 지정 메타데이터로 태그 모델을 향상시킬 수 있습니다.

또한 분류법의 컨테이너 태그(또는 슈퍼 태그)는 모든 하위 태그의 하위 태그 역할을 합니다. (예: 태그된 콘텐츠) fruit/apple 태그된 것으로 간주됩니다. fruit 또한. 즉, 태그 지정된 콘텐츠 검색 fruit 태그된 콘텐츠도 찾을 수 있음 fruit/apple.

TagID 확인 resolving-tagids

TagID에 콜론(:), 콜론은 슬래시( )로 더 구분되는 태그 또는 하위 분류법에서 네임스페이스를 분리합니다./). TagID에 콜론이 없으면 기본 네임스페이스가 암시됩니다.

태그의 표준 및 유일한 위치는 아래와 같습니다 /content/cq:tags.

를 가리키지 않는 기존 패스 또는 패스를 참조하는 태그 cq:Tag 노드가 유효하지 않은 것으로 간주되어 무시됩니다.

다음 표는 일부 샘플 TagID, 해당 요소 및 TagID가 저장소의 절대 경로로 확인되는 방법을 보여 줍니다.

태그 제목의 현지화 localization-of-tag-title

태그에 선택적 제목 문자열 가 포함된 경우( jcr:title) 속성을 추가하여 표시할 제목을 현지화할 수 있습니다 jcr:title.<locale>.

자세한 내용은 다음 문서를 참조하십시오.

액세스 제어 access-control

태그는 아래의 저장소에 노드로 존재합니다 분류 루트 노드. 저장소에서 적절한 ACL을 설정하여 작성자 및 사이트 방문자가 주어진 네임스페이스에서 태그를 만들 수 있도록 허용하거나 거부할 수 있습니다.

또한 특정 태그나 네임스페이스에 대한 읽기 권한을 거부하면 특정 콘텐츠에 태그를 적용하는 기능이 제어됩니다.

일반적인 방법은 다음과 같습니다.

태그 지정 가능 콘텐츠 : cq:Taggable Mixin taggable-content-cq-taggable-mixin

애플리케이션 개발자가 컨텐츠 유형에 태깅을 첨부할 경우 노드의 등록(CND)에는 다음 항목이 포함되어야 합니다. cq:Taggable mixin 또는 cq:OwnerTaggable mixin.

다음 cq:OwnerTaggable mixin: 상속 위치 cq:Taggable는 소유자/작성자에 의해 컨텐츠가 분류될 수 있음을 나타내기 위한 것입니다. AEM에서는 의 속성일 뿐입니다 cq:PageContent 노드. 다음 cq:OwnerTaggable mixin은 태깅 프레임워크에서 필요하지 않습니다.

노드 유형 표기법(CND) node-type-notation-cnd

노드 유형 정의는 저장소에 CND 파일로 존재합니다. CND 표기법은 JCR 설명서의 일부로 정의됩니다 여기.

AEM에 포함된 노드 유형에 대한 필수 정의는 다음과 같습니다.

[cq:Tag] > mix:title, nt:base
    orderable
    - * (undefined) multiple
    - * (undefined)
    + * (nt:base) = cq:Tag version

[cq:Taggable]
    mixin
    - cq:tags (string) multiple

[cq:OwnerTaggable] > cq:Taggable
    mixin

태그가 지정된 컨텐츠: cq:tags 속성 tagged-content-cq-tags-property

다음 cq:tags 속성이 String 작성자 또는 사이트 방문자가 콘텐츠에 적용할 때 하나 이상의 TagID를 저장하는 데 사용되는 배열입니다. 속성은 로 정의된 노드에 추가되는 경우에만 의미를 갖습니다. [cq:Taggable](#taggable-content-cq-taggable-mixin) mixin.

태그 이동 및 병합 moving-and-merging-tags

다음은 를 사용하여 태그를 이동하거나 병합할 때 저장소의 효과에 대한 설명입니다 태깅 콘솔:

태그 마이그레이션 tags-migration

Adobe Experience Manager 6.4부터 태그는 /content/cq:tags 반면 이전 버전에서는 /etc/tags.

6.4 이전 버전에서 AEM 시스템을 업그레이드할 때마다 태그만 로 마이그레이션해야 합니다. /content/cq:tags. 다음을 참조하십시오 AEM 6.5의 일반적인 저장소 재구성 추가 정보.