カスタムAEMアプリケーション内のタグや拡張タグをプログラムで操作する場合、このページでは、
これは
タグに関する関連情報については、次を参照してください。
AEM のタグ付けフレームワークの実装により、JCR API を使用してタグおよびタグコンテンツを管理できます。TagManager は、cq:tags
文字列配列プロパティに値として入力されたタグが重複しないようにして、存在しないタグを指している TagID を削除し、移動または結合されたタグの TagID を更新してください。TagManager は、間違った変更を元に戻す JCR 監視リスナーを使用します。メインクラスは com.day.cq.tagging パッケージ内にあります。
TagManager
の JCR ベースの実装を返します。タグ付け API のリファレンス実装です。TagManager
- パスと名前を使用して、タグを解決して作成できます。Tag
- タグオブジェクトを定義します。TagManager インスタンスを取得するには、JCR が必要です Session
および getTagManager(Session)
:
@Reference
JcrTagManagerFactory jcrTagManagerFactory;
TagManager tagManager = jcrTagManagerFactory.getTagManager(session);
一般的な Sling コンテキストでは、 TagManager
から ResourceResolver
:
TagManager tagManager = resourceResolver.adaptTo(TagManager.class);
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);
Node
は Sling の Adaptable.adaptTo(Class)
メソッドを実装しないので、Node
を Tag
に直接適合させることはできません。
// 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);
次の有効な RangeIterator
を使用できます。
com.day.cq.commons.RangeIterator
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
関連のメソッドがあります。
AEM では、言語はページ言語またはユーザー言語のどちらかから取得できます。
JSP でページ言語を取得するには:
currentPage.getLanguage(false)
JSP でユーザー言語を取得するには:
slingRequest.getLocale()
この currentPage
および slingRequest
は、 <cq:definedobjects> タグを使用します。
タグ付けの場合、ローカリゼーションはタグとしてのコンテキストに依存します titles
は、ページ言語、ユーザー言語またはその他の言語で表示できます。
以下の手順では、 タグ編集 ダイアログ:
CRXDE で、ノード /content/cq:tags
の複数値プロパティ languages
を編集します。
フィンランド語のロケールを表す fi_fi
を追加して、変更を保存してください。
タグ付けコンソールでタグを編集する際に、ページプロパティタグダイアログとタグを編集ダイアログで、新しい言語(フィンランド語)を使用できるようになりました。
新しい言語は、AEMで認識される言語の 1 つである必要があります。 つまり、以下のノードとして使用できる必要があります。 /libs/wcm/core/resources/languages
.
サービスパックをインストールすると、/content/cq:tags ノードの languages プロパティがデフォルトにリセットされます。 したがって、インストール前にプロパティから追加する必要があります。