ドキュメントAEM 6.4開発ガイド

コンソールのカスタマイズ customizing-the-consoles

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • Developer
CAUTION
AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。 詳細は、 技術サポート期間. サポートされているバージョンを見つける ここ.
CAUTION
このドキュメントでは、最新のタッチ操作対応 UI でコンソールをカスタマイズする方法について説明します。クラシック UI には適用されません。

AEMは、コンソール ( および ページオーサリング機能) を作成します。

  • Clientlibs

    クライアントライブラリを使用すると、デフォルトの実装を拡張して新しい機能を実現しながら、標準の関数、オブジェクト、メソッドを再利用できます。カスタマイズするときに、独自の clientlib を /apps. に作成して、カスタムコンポーネントに必要なコードを保持するといった操作が可能です。

  • オーバーレイ

    オーバーレイオーバーレイはノード定義に基づいており、（/libsにある）標準の機能に、（/appsにある）カスタマイズした独自機能を重ねることができます。Sling Resource Merger は継承を許可しているので、オーバーレイを作成するときに、オリジナルの 1 対 1 のコピーは必要ありません。

これらは、AEMコンソールを拡張するための様々な方法で使用できます。 一部については、以降で（大まかに）説明します。

NOTE
詳しくは、次のセクションを参照してください。
このトピックについては、AEM Gems セッション - User interface customization for AEM 6.0 でも説明しています。
CAUTION
/libs パス内の設定は​ 一切 ​変更しないでください。
/libs コンテンツは、インスタンスを次回アップグレードするとき（場合によってはホットフィックスまたは機能パックを適用したとき）に上書きされるからです。
設定およびその他の変更に推奨される方法は次のとおりです。

  1. 必要な項目（/libs内に存在）を、/appsの下で再作成します。

  2. /apps 内で変更作業をおこないます。

例えば、次の場所は、 /libs 構造はオーバーレイできます。

  • コンソール（Granite UI ページに基づくすべてのコンソール）。次に例を示します。

    • /libs/wcm/core/content
NOTE
ヒントおよびツールについて詳しくは、ナレッジベースの記事「Troubleshooting AEM TouchUI issues」を参照してください。

コンソールのデフォルト表示のカスタマイズ customizing-the-default-view-for-a-console

コンソールのデフォルトの表示（列、カード、リスト）をカスタマイズできます。

  1. ビューの順序を変更するには、次の場所から必要なエントリをオーバーレイします。

    /libs/wcm/core/content/sites/jcr:content/views

    先頭のエントリがデフォルトになります。

    使用可能なノードは、使用可能な表示オプションに関連付けられます。

    • column
    • card
    • list

  2. 例えば、リスト用のオーバーレイで、

    /apps/wcm/core/content/sites/jcr:content/views/list

    次のプロパティを定義します。

    • 名前：sling:orderBefore
    • 型：String
    • 値: column

ツールバーに新しいアクションを追加する add-new-action-to-the-toolbar

  1. 独自のコンポーネントを構築し、対応するカスタムアクション用のクライアントライブラリを含めることができます。 例： twitterに昇格 アクション：

    /apps/wcm/core/clientlibs/sites/js/twitter.js

    このアクションを独自コンソールのツールバー項目に関連付けることができます。

    /apps/<yourProject>/admin/ext/launches

    選択モードの例：

    content/jcr:content/body/content/header/items/selection/items/twitter

特定のグループにツールバーアクションを制限する restrict-a-toolbar-action-to-a-specific-group

  1. カスタムのレンダリング条件を使用して、標準のアクションをオーバーレイし、レンダリング前に満たす必要のある特定の条件を課すことができます。

    例えば、グループに従ってレンダリング条件を制御するコンポーネントを作成します。

    /apps/myapp/components/renderconditions/group

  2. これをサイトコンソールの「サイトを作成」アクションに適用するには、

    /libs/wcm/core/content/sites

    オーバーレイを作成します。

    /apps/wcm/core/content/sites

  3. このアクションのレンダリング条件を追加します。

    jcr:content/body/content/header/items/default/items/create/items/createsite/rendercondition

    このノードのプロパティを使用して、特定のアクションを実行できる groups（administrators など）を定義できます。

リスト表示で列のカスタマイズ customizing-columns-in-the-list-view

NOTE
この機能は、テキストフィールドの列に対して最適化されています。その他のデータタイプに対しては、/apps の cq/gui/components/siteadmin/admin/listview/columns/analyticscolumnrenderer をオーバーレイできます。

リスト表示の列をカスタマイズするには：

  1. 使用可能な列のリストをオーバーレイします。

    • ノードの場合：

      /apps/wcm/core/content/common/availablecolumns

    • 新しい列を追加、または既存の列を削除します。

    詳しくは、オーバーレイ（および Sling Resource Merger）の使用を参照してください。

  2. 省略可能：

    • 追加データを挿入する場合は、以下を持つ [PageInforProvider](https://helpx.adobe.com/experience-manager/6-4/sites/developing/using/reference-materials/javadoc/com/day/cq/wcm/api/PageInfoProvider.html) を記述する必要があります。

      pageInfoProviderType property.
      例えば、以下の GitHub から添付されたクラス/バンドルを参照してください。

  3. これで、リスト表示の列コンフィギュレーターで列を選択できます。

リソースのフィルタリング filtering-resources

コンソールを使用する場合、一般的な使用例は、ユーザーがリソース（ページ、コンポーネント、アセットなど）から選択する必要がある場合です。 これは、例えば、作成者が項目を選択する必要があるリストの形式をとることができます。

リストを適切なサイズに保ち、使用事例にも関連するように、カスタム述語の形式でフィルターを実装できます。 詳しくは、 この記事 」を参照してください。

recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e