AEM 애플리케이션에 태그 지정 빌드 building-tagging-into-aem-applications

사용자 지정 AEM 응용 프로그램 내에서 태그를 프로그래밍 방식으로 작업하거나 태그를 확장하기 위해 이 문서에서는

와 상호 작용하는

태그 지정에 대한 관련 정보:

태깅 API 개요 overview-of-the-tagging-api

AEM에서 태그 지정 프레임워크를 구현하면 JCR API를 사용하여 태그와 태그 콘텐츠를 관리할 수 있습니다. TagManager은(는) cq:tags 문자열 배열 속성에 값으로 입력된 태그가 중복되지 않도록 하고, 존재하지 않는 태그를 가리키는 TagID을(를) 제거하고, 이동하거나 병합된 태그에 대해 TagID을(를) 업데이트합니다. TagManager은(는) 잘못된 변경 내용을 되돌리는 JCR 관찰 수신기를 사용합니다. 기본 클래스는 com.day.cq.tagging 패키지에 있습니다.

JCR 기반 TagManager 가져오기 getting-a-jcr-based-tagmanager

TagManager 인스턴스를 검색하려면 JCR Session이(가) 있어야 하며 getTagManager(Session)을(를) 호출해야 합니다.

@Reference
JcrTagManagerFactory jcrTagManagerFactory;

TagManager tagManager = jcrTagManagerFactory.getTagManager(session);

일반적인 Sling 컨텍스트에서는 ResourceResolver의 TagManager에 적용할 수도 있습니다.

TagManager tagManager = resourceResolver.adaptTo(TagManager.class);

Tag 개체 검색 retrieving-a-tag-object

기존 태그를 확인하거나 태그를 만들어 TagManager을(를) 통해 Tag을(를) 검색할 수 있습니다.

Tag tag = tagManager.resolve("my/tag"); // for existing tags

Tag tag = tagManager.createTag("my/tag"); // for new tags

Tags을(를) JCR Nodes에 매핑하는 JCR 기반 구현의 경우 리소스가 있는 경우(예: /content/cq:tags/default/my/tag) Sling의 adaptTo 메커니즘을 직접 사용할 수 있습니다.

Tag tag = resource.adaptTo(Tag.class);

태그는 리소스(노드가 아님)에서만 from ​으로 변환할 수 있지만 태그는 노드 및 리소스 모두에서 to(으)로 변환할 수 있습니다.

Node node = tag.adaptTo(Node.class);
Resource node = tag.adaptTo(Resource.class);

태그 가져오기 및 설정 getting-and-setting-tags

// Getting the tags of a Resource:
Tag[] tags = tagManager.getTags(resource);

// Setting tags to a Resource:
tagManager.setTags(resource, tags);

태그 검색 searching-for-tags

// Searching for the Resource objects that are tagged with the tag object:
Iterator<Resource> it = tag.find();

// Retrieving the usage count of the tag object:
long count = tag.getCount();

// Searching for the Resource objects that are tagged with the tagID String:
 RangeIterator<Resource> it = tagManager.find(tagID);

태그 삭제 deleting-tags

tagManager.deleteTag(tag);

태그 복제 replicating-tags

태그가 nt:hierarchyNode 형식이므로 태그에 복제 서비스(Replicator)를 사용할 수 있습니다.

replicator.replicate(session, replicationActionType, tagPath);

태그 가비지 수집기 the-tag-garbage-collector

태그 가비지 수집기는 숨겨진 태그와 사용되지 않은 태그를 정리하는 백그라운드 서비스입니다. 숨겨진 태그와 사용되지 않은 태그는 /content/cq:tags 아래 태그이며 cq:movedTo 속성이 있고 콘텐츠 노드에서 사용되지 않습니다. 그들은 셀 수가 0이다. 이 지연 삭제 프로세스를 사용하면 이동 또는 병합 작업의 일부로 콘텐츠 노드(cq:tags 속성)를 업데이트할 필요가 없습니다. cq:tags 속성이 업데이트되면(예: 페이지 속성 대화 상자) cq:tags 속성의 참조가 자동으로 업데이트됩니다.

태그 가비지 수집기는 기본적으로 하루에 한 번 실행됩니다. 다음에서 구성할 수 있습니다.

http://<host>:<port>/system/console/configMgr/com.day.cq.tagging.impl.TagGarbageCollector

태그 검색 및 태그 목록 tag-search-and-tag-listing

태그 검색 및 태그 목록은 다음과 같이 작동합니다.

다른 언어로 된 태그 tags-in-different-languages

title 태그는 다른 언어로 정의할 수 있습니다. 그런 다음 언어 구분 속성이 태그 노드에 추가됩니다. 이 속성은 프랑스어 번역의 경우 jcr:title.<locale> 형식(예: jcr:title.fr)을 갖습니다. <locale>은(는) 소문자 ISO 로케일 문자열이어야 하며 하이픈/대시(-) 대신 밑줄(_)을 사용해야 합니다(예: de_ch).

예를 들어 Animals 태그가 Products 페이지에 추가되면 stockphotography:animals 값이 /content/wknd/en/products/jcr:content 노드의 cq:tags 속성에 추가됩니다. 번역은 태그 노드에서 참조됩니다.

서버측 API에 지역화된 title 관련 메서드가 있습니다.

AEM에서 언어는 페이지 언어 또는 사용자 언어에서 가져올 수 있습니다.

태그 지정의 경우 지역화는 컨텍스트에 따라 달라집니다. 태그 titles은(는) 페이지 언어, 사용자 언어 또는 다른 언어로 표시될 수 있습니다.

태그 편집 대화 상자에 새 언어 추가 adding-a-new-language-to-the-edit-tag-dialog

다음 절차에서는 태그 편집 대화 상자에 새로운 언어(예: 핀란드어)를 추가하는 방법을 설명합니다.

핀란드어는 이제 태그 지정 콘솔에서 태그를 편집할 때 페이지 속성의 태그 대화 상자와 태그 편집 대화 상자에서 사용할 수 있습니다.