構成と構成ブラウザ

AEM設定は、AEMの設定を管理し、ワークスペースとして機能します。

設定とは

設定は、2つの異なる視点から考察できます。

まとめ：管理者の表示上、設定とは、AEMで設定を管理するワークスペースの作成方法を指します。一方、開発者は、AEMがリポジトリ内でこれらの設定を使用および管理する方法を理解する必要があります。

設定は、ユーザーの視点に関係なく、AEMでは2つの主な目的を果たします。

  • 設定により、特定のユーザーグループに対して特定の機能が有効になります。
  • 設定によって、これらの機能のアクセス権が定義されます。

管理者としての設定

AEM管理者と作成者は、設定をワークスペースと見なすことができます。 これらのワークスペースは、これらの機能のアクセス権を実装することで、組織の目的のために、設定のグループと関連するコンテンツをまとめて収集するのに使用できます。

設定は、AEM内の多くの異なる機能に対して作成できます。

例

例えば、管理者が編集可能なテンプレートの2つの設定を作成できます。

  • WKND-General
  • WKNDマガジン

その後、WKND-General設定を使用して一般的なページテンプレートを作成し、WKND-Magazineの下の雑誌専用のテンプレートを作成できます。

その後、管理者はWKND-GeneralをWKNDサイトのすべてのコンテンツに関連付けることができます。 ただし、WKND-Magazine設定は、雑誌サイトにのみ関連付けられます。

次の操作を行います。

  • コンテンツ作成者が雑誌の新しいページを作成するとき、作成者は「一般」テンプレート（WKND — 一般）または「雑誌」テンプレート（WKND — 雑誌）から選択できます。
  • コンテンツ作成者が、雑誌以外のサイトの別の部分に対して新しいページを作成した場合、作成者は一般テンプレート(WKND-General)からのみ選択できます。

編集可能なテンプレートだけでなく、クラウド設定、ContextHubセグメント、コンテンツフラグメントモデルに対しても同様の設定が可能です。

設定ブラウザーの使用

設定ブラウザを使用すると、管理者はAEMの設定に対するアクセス権を簡単に作成、管理および設定できます。

メモ

ユーザーにadmin権限がある場合にのみ、設定ブラウザーを使用して設定を作成できます。 admin アクセス権を設定に割り当てたり、設定を変更したりするには、権限も必要です。

構成の作成

設定ブラウザーを使用してAEMで新しい設定を作成する方法は、非常に簡単です。

  1. AEMにCloud Serviceとしてログインし、メインメニューで​ツール -> 一般 -> 構成ブラウザー​を選択します。

  2. 「作成」をタップまたはクリックします。

  3. 設定に​タイトル​と​名前​を指定します。

    設定の作成

  4. 許可する設定のタイプを確認します。

  5. 「作成」をタップまたはクリックします。

ヒント

構成は入れ子にできます。

設定とそのアクセス権の編集

設定をワークスペースと考える場合、これらの設定にアクセス権を設定して、それらのワークスペースにアクセスできるユーザーとアクセスできないユーザーを強制できます。

  1. AEMにCloud Serviceとしてログインし、メインメニューで​ツール -> 一般 -> 構成ブラウザー​を選択します。

  2. 変更する設定を選択し、ツールバーの​プロパティ​をタップまたはクリックします。

  3. 設定に追加する追加機能を選択します

    メモ

    設定が作成された後は、フィーチャの選択を解除することはできません。

  4. 有効な権限​ボタンを使用して、ロールの一覧と、現在設定されている設定に対する権限を表示します。
    有効な権限ウィンドウ

  5. 新しい権限を割り当てるには、「新しい権限」セクションの「ユーザーまたはグループを選択」フィールドにユーザーまたはグループ名追加を入力します。

    • Select user or group​フィールドのオファーは、既存のユーザーと役割に基づいて自動入力されます。

  6. オートコンプリートの結果から適切なユーザーまたは役割を選択します。

    • 複数のユーザーまたはロールを選択できます。

  7. 選択したユーザーまたはロールに必要なアクセスオプションを確認し、追加​をクリックします。
    設定追加へのアクセス権

  8. 手順を繰り返して、ユーザーまたはロールを選択し、必要に応じて追加のアクセス権を割り当てます。

  9. 終了したら、「保存して閉じる」をタップまたはクリックします。

開発者としての設定

開発者として、Cloud ServiceとしてのAEMの設定との連携、および設定解決の処理方法を知ることが重要です。

構成とコンテンツの分離

管理者とユーザーは、設定を職場と考えて異なる設定やコンテンツを管理できますが、設定とコンテンツはリポジトリ内の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文字列プロパティを読み取り、プロパティ（または設定項目全体）が存在しない場合に備えて、デフォルト値の「FFFFF」を指定します。

次に、対応する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が必要です。 このようなアイテムは「設定ドキュメント」と考えることができ、通常はjcr:contentを含むcq:Pageで表されます。

最後に、サンプルコードに必要なプロパティbgkcolorが表示されます。 getItemから戻るValueMapは、ページのjcr:contentノードに基づいています。

構成の解決

上記の基本的な例は、1つの設定を示しています。 しかし、デフォルトのグローバル設定、ブランドごとに異なる設定、サブプロジェクト用に特定の設定など、多くの場合、異なる設定を使用したいと思われます。

これをサポートするために、AEMでの設定参照には継承とフォールバックのメカニズムが次の優先順に用意されています。

  1. /conf/<siteconfig>/<parentconfig>/<myconfig>
    • cq:confから/contentのどこかで参照された特定の設定
    • 階層は任意であり、サイト構造と同様にデザインできます。これを知るのはアプリケーションコードのビジネスではありません。
    • 設定権限を持つユーザーが実行時に変更できる
  2. /conf/<siteconfig>/<parentconfig>
    • 代替設定のために親をトラバース
    • 設定権限を持つユーザーが実行時に変更できる
  3. /conf/<siteconfig>
    • 代替設定のために親をトラバース
    • 設定権限を持つユーザーが実行時に変更できる
  4. /conf/global
    • システムのグローバル設定
    • 通常、インストールのグローバルなデフォルト
    • adminロールによって設定
    • 設定権限を持つユーザーが実行時に変更できる
  5. /apps
    • アプリケーションのデフォルト
    • アプリケーションのデプロイメントに関する修正
    • 実行時の読み取り専用
  6. /libs
    • AEMの製品デフォルト
    • Adobeによって変更できるのみ、プロジェクトへのアクセスは許可されていません
    • アプリケーションのデプロイメントに関する修正
    • 実行時の読み取り専用

構成の使用

AEMの設定は、Sling Context-Aware設定に基づいています。 Slingバンドルには、コンテキストに応じた設定の取得に使用できるサービスAPIが用意されています。 コンテキスト対応構成とは、前の例で説明したように、コンテンツリソースまたはリソースツリーに関連する構成です。

コンテキスト対応の設定、例、およびその使用方法の詳細については、Slingのドキュメントを参照してください。

ConfMgr Webコンソール

デバッグおよびテストの目的で、ConfMgr Webコンソールがhttps://<host>:<port>/system/console/confにあり、これは特定のパス/項目の設定を示すことができます。

ConfMgr

以下を提供するだけです。

  • コンテンツのパス
  • Item
  • User

解決​をクリックして、解決される構成を確認し、それらの構成を解決するサンプルコードを受け取ります。

コンテキスト対応構成Webコンソール

デバッグおよびテストの目的で、Context-Aware Configuration Webコンソールがhttps://<host>:<port>/system/console/slingcaconfigにあります。これにより、リポジトリ内のコンテキスト対応設定にクエリーを実行し、そのプロパティを表示できます。

コンテキスト対応設定Webコンソール

以下を提供するだけです。

  • コンテンツのパス
  • 構成名

「Resolve」をクリックして、選択した構成に関連付けられたコンテキストパスとプロパティを取得します。

このページ