AEM 設定は、AEM の設定を管理し、ワークスペースとして機能します。
設定には、2 つの異なる観点があります。
まとめ:管理者の観点からの設定とは、AEM で設定を管理するワークスペースの作成方法を指します。一方、デベロッパーは、AEM がリポジトリー内でこれらの設定を使用および管理する方法を理解する必要があります。
設定は、上記の観点に関係なく、AEM で 2 つの主な目的を果たします。
AEM 管理者と作成者は、設定をワークスペースと見なすことができます。これらのワークスペースは、機能のアクセス権を実装することで、組織的な目的で設定のグループと関連コンテンツを収集するために使用できます。
設定は、AEM 内の多くの異なる機能に対して作成できます。
例えば、管理者は編集可能なテンプレートの 2 つの設定を作成できます。
WKND-General の設定を使用して一般的なページテンプレートを作成し、WKND-Magazine の設定で雑誌専用のテンプレートを作成できます。
WKND-General を WKND サイトのすべてのコンテンツに関連付けることができますが、WKND-Magazine は、雑誌サイトにのみ関連付けられます。
これににより、次のことができます。
編集可能なテンプレートだけでなく、クラウド設定、ContextHub セグメント、コンテンツフラグメントモデルに対しても同様の設定が可能です。
設定ブラウザーを使用すると、管理者は AEM 設定に対するアクセス権を簡単に作成、管理、設定できます。
ユーザーに admin
権限がある場合にのみ、設定ブラウザーを使用して設定を作成できます。アクセス権を設定に割り当てたり、設定を変更したりするには、管理者権限も必要です。
設定ブラウザーを使用してAEMで設定を簡単に作成できます。
AEM as a Cloud Service にログインし、メインメニューでツール/一般/設定ブラウザーを選択します。
「作成」をタップまたはクリックします。
設定にタイトルと名前を指定します。
許可する設定のタイプを確認します。
「作成」をタップまたはクリックします。
設定は入れ子にできます。
設定をワークスペースと考える場合、これらの設定にアクセス権を設定して、それらのワークスペースにアクセスできるユーザーとアクセスできないユーザーを指定することができます。
AEM as a Cloud Service にログインし、メインメニューでツール/一般/設定ブラウザーを選択します。
変更する設定を選択し、をタップまたはクリックします。 プロパティ 」をクリックします。
設定に追加する追加機能を選択します。
設定の作成後は、機能の選択を解除することはできません。
「有効な権限」ボタンを使用すると、役割の一覧と、現在設定されている設定に対する権限が表示されます。
新しい権限を割り当てるには、新しい権限の追加セクションの「ユーザーまたはグループを選択」フィールドにユーザーまたはグループ名を入力します。
オートコンプリートの結果から適切なユーザーまたは役割を選択します。
選択したユーザーまたはロールのアクセスオプションを選択し、 追加.
手順を繰り返して、ユーザーまたはロールを選択し、必要に応じて追加のアクセス権を割り当てることができます。
選択 保存して閉じる 完了したら、
デベロッパーは、AEM as a Cloud Service と設定との連携、および設定の処理方法を知ることが重要です。
管理者とユーザーは、設定を、異なる設定やコンテンツを管理するためのワークスペースと考るかもしれませんが、AEM では設定とコンテンツはリポジトリー内で別々に保存および管理されることを理解しておくことが重要です。
/content
はすべてのコンテンツのホームページです。/conf
はすべての設定のホームです。コンテンツは cq:conf
プロパティを介して関連する設定を参照します。AEMは、コンテンツとそのコンテキストに基づいて検索を実行します cq:conf
プロパティを使用して適切な設定を検索します。
この例では、DAM 設定に関心のあるアプリケーションコードがあるとします。
Conf conf = resource.adaptTo(Conf.class);
ValueMap imageServerSettings = conf.getItem("dam/imageserver");
String bgkcolor = imageServerSettings.get("bgkcolor", "FFFFFF");
すべての設定参照の開始点は、コンテンツリソースで、以下の場所に配置されます。 /content
. これは、ページ、ページ内のコンポーネント、アセット、DAM フォルダーのいずれかです。 これは、このコンテキストで適用される適切な設定を探している実際のコンテンツです。
次に、 Conf
オブジェクトを使用して、目的の特定の設定項目を取得できます。 この場合、 dam/imageserver
: 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 コンテンツを通じて制御します。
設定には、固定名の settings
実際の項目 ( dam/imageserver
この場合に必要な情報を示します。 このような項目は、「設定ドキュメント」と見なすことができ、 cq:Page
次を含む jcr:content
実際の内容を保持している
最後に、プロパティを確認できます bgkcolor
そのサンプルコードにはが必要です。 The ValueMap
~から戻って来る getItem
は、ページの jcr:content
ノード。
上記の基本的な例は、1 つの設定を示しています。デフォルトのグローバル設定、ブランドごとに異なる設定、サブプロジェクト用に特定の設定など、様々な設定を使用したい場合が多くあります。
これをサポートするために、AEMの設定参照には、次の優先順位で継承とフォールバックメカニズムがあります。
/conf/<siteconfig>/<parentconfig>/<myconfig>
cq:conf
から /content
のどこかで参照された特定の設定/conf/<siteconfig>/<parentconfig>
/conf/<siteconfig>
/conf/global
admin
の役割によって設定/apps
/libs
AEM の設定は、Sling コンテキスト対応設定に基づいています。Sling バンドルには、コンテキスト対応設定の取得に使用できるサービス API が用意されています。コンテキスト対応設定とは、前の例で説明したように、コンテンツリソースまたはリソースツリーに関連する設定です。
コンテキスト対応設定、例、使用方法の詳細については、Sling のドキュメントを参照してください。
デバッグおよびテストの目的で、https://<host>:<port>/system/console/conf
には ConfMgr Web コンソールがあり、特定のパス/項目の設定を表示することができます。
以下を提供するだけです。
解決された設定を確認し、それらの設定を解決するサンプルコードを受け取るには、「 解決.
デバッグおよびテストの目的で、https://<host>:<port>/system/console/slingcaconfig
にコンテキスト対応設定の Web コンソールがあり、リポジトリー内のコンテキスト対応設定にクエリを実行し、そのプロパティを表示できます。
以下を提供するだけです。
選択した設定に関連付けられたコンテキストパスとプロパティを取得するには、「 」を選択します。 解決.