AEM アプリケーションへのタグ付けの構築

カスタムAEMアプリケーション内のタグや拡張タグをプログラムで操作する場合、このページでは、

• タグ付け API

これは

• タグ付けフレームワーク

タグに関する関連情報については、次を参照してください。

• タグの管理 タグの作成と管理、およびタグが適用されるコンテンツについて説明します。
• タグの使用 コンテンツのタグ付けについて詳しくは、を参照してください。

タグ付け API の概要

AEM のタグ付けフレームワークの実装により、JCR API を使用してタグおよびタグコンテンツを管理できます。TagManager は、cq:tags 文字列配列プロパティに値として入力されたタグが重複しないようにして、存在しないタグを指している TagID を削除し、移動または結合されたタグの TagID を更新してください。TagManager は、間違った変更を元に戻す JCR 監視リスナーを使用します。メインクラスは com.day.cq.tagging パッケージ内にあります。

• JcrTagManagerFactory - TagManager の JCR ベースの実装を返します。タグ付け API のリファレンス実装です。
• TagManager - パスと名前を使用して、タグを解決して作成できます。
• Tag - タグオブジェクトを定義します。

JCR ベースの TagManager の取得

TagManager インスタンスを取得するには、JCR が必要です Session および getTagManager(Session):

@Reference
JcrTagManagerFactory jcrTagManagerFactory;

TagManager tagManager = jcrTagManagerFactory.getTagManager(session);

一般的な Sling コンテキストでは、 TagManager から ResourceResolver:

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

Tag オブジェクトの取得

A Tag は、 TagManager（既存のタグを解決するか作成する）:

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);

タグは、ノードからではなく、*リソース *からのみ変換できますが、ノードとリソースの両方に変換できます。

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

タグの取得と設定

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

// Setting tags to a Resource:
tagManager.setTags(resource, 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);

タグの削除

tagManager.deleteTag(tag);

タグの複製

タグのタイプは Replicator なので、タグで複製サービス（nt:hierarchyNode）を使用できます。

replicator.replicate(session, replicationActionType, tagPath);

クライアント側でのタグ付け

フォームウィジェット CQ.tagging.TagInputField は、タグを入力するためのものです。 既存のタグから選択できるポップアップメニューを備えており、自動入力などの機能もあります。xtype は tags です。

タグのガベージコレクター

タグのガベージコレクターは、非表示および未使用のタグをクリーンアップするバックグラウンドサービスです。非表示および未使用のタグとは、cq:movedToプロパティが設定された/content/cq:tagsの下にあるタグのことで、コンテンツノードでは使用されません（カウントはゼロになります）。この遅延削除プロセスを使用すると、コンテンツノード ( cq:tags プロパティ ) は、移動または結合操作の一環として更新する必要はありません。 cq:tags プロパティの参照は、cq:tags プロパティがアップデートされると自動的にアップデートされます（例：ページプロパティダイアログを介して）。

タグのガベージコレクターは、デフォルトで 1 日に 1 回実行されます。次の場所で設定できます。

http://localhost:4502/system/console/configMgr/com.day.cq.tagging.impl.TagGarbageCollector

タグ検索およびタグ一覧

タグ検索およびタグ一覧は次のように動作します。

• TagID の検索では、cq:movedTo プロパティが TagID に設定されているタグを検索します。cq:movedTo の TagID に従って検索します。

• タグタイトルの検索では、cq:movedTo プロパティのないタグのみを検索します。

他の言語のタグ

タグの管理に関するドキュメントの他の言語でのタグ管理の節で説明されているように、タグの title は別の言語で定義できます。言語に依存するプロパティがタグノードに追加されます。このプロパティは jcr:title.<locale> の形式を持ちます（例：フランス語訳は jcr:title.fr）この <locale> は小文字の ISO ロケール文字列である必要があり、「 — 」の代わりに「_」を使用します。次に例を示します。 de_ch.

Animals タグが Products ページに追加されると、値 stockphotography:animals は /content/geometrixx/en/products/jcr:content ノードの cq:tags プロパティに追加されます。翻訳は、タグノードから参照されます。

サーバーサイド API には、ローカライズされた title 関連のメソッドがあります。

• com.day.cq.tagging.Tag

  • getLocalizedTitle(Locale locale)
  • getLocalizedTitlePaths()
  • getLocalizedTitles()
  • getTitle(Locale locale)
  • getTitlePath(Locale locale)

• com.day.cq.tagging.TagManager

  • canCreateTagByTitle(String tagTitlePath, Locale locale)
  • createTagByTitle(String tagTitlePath, Locale locale)
  • resolveByTitle(String tagTitlePath, Locale locale)

AEM では、言語はページ言語またはユーザー言語のどちらかから取得できます。

• JSP でページ言語を取得するには：

  • currentPage.getLanguage(false)

• JSP でユーザー言語を取得するには：

  • slingRequest.getLocale()

この currentPage および slingRequest は、 <cq:definedobjects> タグを使用します。

タグ付けの場合、ローカリゼーションはタグとしてのコンテキストに依存します titlesは、ページ言語、ユーザー言語またはその他の言語で表示できます。

タグを編集ダイアログへの新しい言語の追加

以下の手順では、 タグ編集 ダイアログ：

1. CRXDE で、ノード /content/cq:tags の複数値プロパティ languages を編集します。

2. フィンランド語のロケールを表す fi_fi を追加して、変更を保存してください。

タグ付け​コンソールでタグを編集する際に、ページプロパティタグダイアログと​タグを編集​ダイアログで、新しい言語（フィンランド語）を使用できるようになりました。