CRXDE Lite による開発 developing-with-crxde-lite

ここでは、CRXDE Lite を使用して Adobe Experience Manager(AEM)アプリケーションを開発する方法について説明します。

使用可能な他の開発環境について詳しくは、概要のドキュメントを参照してください。

CRXDE Lite は AEM に搭載されており、これを使用してブラウザー内で標準的な開発作業を実行できます。CRXDE Lite を使用すると、プロジェクトの作成や、ファイル(.jsp や .java など)、フォルダー、テンプレート、コンポーネント、ダイアログ、ノード、プロパティおよびバンドルの作成と編集をログ記録を行う間に実行することができます。
CRXDE Lite は、AEM サーバーに直接アクセスできない場合にお勧めします。また、すぐに使用可能なコンポーネントと Java™ バンドルを拡張または変更してアプリケーションを開発する場合、または専用のデバッガー、コード補完、および構文のハイライト表示を必要としない場合にもお勧めします。

NOTE
AEM 6.5.5.0 以降では、CRXDE Lite の匿名アクセスは不可能になりました。
ユーザーはログイン画面にリダイレクトされます。
NOTE
プロジェクトの開発時には Eclipse 用 AEM 開発者ツールおよび AEM HTL Brackets Extension を使用することをお勧めします。

CRXDE Lite の使用 getting-started-with-crxde-lite

CRXDE Lite の使用を開始するには、次の手順に従ってください。

  1. AEM をインストールします。

  2. Web ブラウザーに https://<host>:<port>/crx/de と入力します。デフォルトでは https://localhost:4502/crx/de です。

  3. ユーザー名 ​と​ パスワード ​を入力します。デフォルト値は、それぞれadminadminです。

  4. OK」をクリックします。

ブラウザーでは、CRXDE Lite のユーザーインターフェイスは次のように表示されます。

chlimage_1-18

これで、CRXDE Lite を使用してアプリケーションを開発できます。

ユーザーインターフェイスの概要 overview-of-the-user-interface

CRXDE Lite には以下の機能があります。

上部のスイッチャーバー
CRXDE Lite、パッケージマネージャー、Package Share をすばやく切り替えます。
ノードパスウィジェット

現在選択しているノードのパスを表示します。

このウィジェットに手動でパスを入力するか、または別の場所からパスを貼り付けて、Enter キーを押すと、特定のノードにジャンプできます。

また、特定の名前を持つノードの検索がサポートされます。検索するノードの名前を入力して待機します(または、右側にある検索の記号をクリックします)。例えば、oak などの文字列をウィジェットに入力して、検索がどのように機能するかを確認できます。特定のノードがエクスプローラーウィンドウに読み込まれると、リストが表示されます。パスを選択して Enter キーを押すと、その場所に移動できます。この機能は、ブラウザーで CRXDE クライアントアプリケーションに読み込まれているノードでしか使用できません。リポジトリ全体を検索する場合は、ツール/クエリを使用します。

エクスプローラーウィンドウ

リポジトリ内のすべてのノードのツリーを表示します。

ノードをクリックして、そのプロパティを「プロパティ」タブに表示します。ノードをクリックしたら、ツールバーでアクションを選択できます。ノード名を変更するには、ノードをもう一度クリックします。

ツリーナビゲーションフィルター(双眼鏡アイコン):リポジトリ内のノードのうち、入力テキストが名前に含まれているノードをフィルタリングできます。このフィルターは、ローカルに読み込まれたノードにのみ適用されます。

編集ウィンドウ

ホーム」タブ:コンテンツやドキュメントを検索したり、開発者向けリソース(ドキュメント、開発者向けブログ、ナレッジベース)とサポート(アドビのホームページとサポートセンター)にアクセスしたりできます。

エクスプローラー ウィンドウでファイルをダブルクリックすると、その内容を表示できます。例えば、.jsp や.java ファイルの内容を表示できます。表示したファイルを変更して保存できます。

編集 ウィンドウでファイルを編集した後は、ツールバーで次のツールを使用できるようになります。

- ツリーに表示:リポジトリツリーにファイルを表示します。
- 検索と置換:検索または置換を実行します。

編集 ウィンドウのステータス行をダブルクリックすると、行に移動 ダイアログが開くので、移動先の特定の行番号を入力できます。

「プロパティ」タブ
選択したノードのプロパティを表示します。新しいプロパティを追加したり、既存のプロパティを削除したりできます。
「アクセス制御」タブ

パス、リポジトリレベル、またはプリンシパルに基づいて権限を表示します。

権限は、次のように分類されます。

- 適用可能なアクセス制御ポリシー:選択項目に適用可能なポリシー。

- ローカルアクセス制御ポリシー:選択項目に対してローカルに適用されるポリシー。

- 有効なアクセス制御ポリシー:選択項目に適用されるポリシーで、ローカルに設定されるか、親ノードから継承されます。

メモ:アクセス制御情報を確認できるようにするには、CRXDE Lite にログインしたユーザーに ACL エントリを読み取る権限が割り当てられている必要があります。匿名ユーザーは、デフォルトではこの情報を表示できません。情報を確認するには、例えば管理者としてログインしてください。

「レプリケーション」タブ
ノードのレプリケーションステータスを表示します。ノードをレプリケーションできます。または削除をレプリケーションできます。
「コンソール」タブ

サーバーログ

ログメッセージを表示します。ログレベルの設定、コンソールのクリア、選択したスクロール位置での固定およびメッセージの表示の有効化/無効化を行うことができます。

バージョン管理

バージョン管理メッセージを表示します。

「ビルド情報」タブ
バンドルのビルド中に情報を表示します。
更新
選択項目を更新します。他のユーザーによる変更が、リポジトリの自分のビューで更新されます。自分が行った変更には影響を及ぼしません。
すべて保存

すべて保存

行われたすべての変更を保存します。「保存」をクリックするまで変更は一時的であり、コンソールを終了すると失われます。

元に戻す

前回の保存アクションの後に選択したノードに対して行った変更をすべて破棄し、選択したノードにリポジトリの状態を再読み込みします。

すべて元に戻す

前回の保存アクションの後にリポジトリ全体で行った変更をすべて破棄し、リポジトリの状態を再読み込みします。

作成 ...

選択したノードの下に次の項目を作成するためのドロップダウンメニューです。

- ノード:任意のノードタイプを持つノード

- ファイル:nt:file ノードとその nt:resource サブノード

- フォルダー:nt:folder ノード

- テンプレート:AEM テンプレート

- コンポーネント:AEM コンポーネント

- ダイアログ:AEM ダイアログ

削除
選択したノードを削除します。
コピー
選択したノードをコピーします。
貼り付け
コピーしたノードを選択したノードの下に貼り付けます。
移動 ...
選択したノードを、ダイアログを使用して設定されたノードに移動します。
名前を変更 ...
選択したノードの名前を変更します。
Mixin ...
Mixin タイプをノードタイプに追加できます。ほとんどの場合、Mixin タイプは高度な機能(バージョン管理、アクセス制御、参照、ロックなど)をノードに追加するために使用されます。
ツール

次のツールを含むドロップダウンメニューです。

- サーバー設定:Felix コンソールにアクセスします。

- クエリ:リポジトリを照会します。

- 権限:権限管理を開いて、権限を確認および追加できます。

- アクセス制御をテスト:特定のパスまたはプリンシパルに対する権限をテストできる場所です。

- ノードタイプを書き出し - システム内のノードタイプを CND 表記として書き出します。

- ノードタイプを読み込み:CND 表記を使用してノードタイプを読み込みます。

- SiteCatalyst デバッガーをインストール:Analytics デバッガーをインストールする手順を示します。

ログインウィジェット

ログイン中のユーザーとログイン先のワークスペースを表示します(admin@crx.default など)。

特定のユーザーとしてログインまたは再ログインするには、このウィジェットをクリックします。ログイン先のワークスペースを指定しない場合は、デフォルトのワークスペースである crx.default にログインします。

匿名ユーザーとしてリポジトリを参照する場合は、ログイン名に anonymous を使用し、任意のパスワード(スペース、ドットなど)を使用します。

承認が無効になった場合(期限切れの場合など)は、ログインウィジェットに「無許可 - ログイン」と表示されます。もう一度ログインするには、このメッセージをクリックします。

フォルダーの作成 creating-a-folder

CRXDE Lite でフォルダーを作成するには:

  1. ブラウザーで CRXDE Lite を開きます。

  2. ナビゲーションウィンドウで、新しいフォルダーを作成するフォルダーを右クリックして、「作成」、「フォルダーを作成」の順に選択します。

  3. フォルダーの​ 名前 ​を入力して、「OK」をクリックします。

  4. すべて保存」をクリックして、サーバーに変更を保存します。

テンプレートの作成 creating-a-template

CRXDE Lite でテンプレートを作成するには:

  1. ブラウザーで CRXDE Lite を開きます。

  2. ナビゲーションウィンドウで、テンプレートを作成するフォルダーを右クリックして、「作成」、「テンプレートを作成」の順に選択します。

  3. テンプレートの​ ラベルタイトル説明リソースタイプランキング ​を入力します。「次へ」をクリックします。

  4. (オプション)「許可されているパス」を設定します。「次へ」をクリックします。

  5. (オプション)「許可されている親」を設定します。「次へ」をクリックします。

  6. (オプション)「許可されている子」を設定します。「OK」をクリックします。

  7. すべて保存」をクリックして、サーバーに変更を保存します。

次の項目が作成されます。

  • テンプレートのプロパティを含むcq:Templateタイプのノード

  • ページコンテンツのプロパティを含む cq:PageContent タイプの子ノード

テンプレートにプロパティを追加できます。プロパティの作成を参照してください。

コンポーネントの作成 creating-a-component

ここで説明する機能を使用できるのは、CQ5 がインストールされている(つまり、ノードタイプ cq:Component をリポジトリで使用できる)場合のみです。

CRXDE Lite でコンポーネントを作成するには:

  1. ブラウザーで CRXDE Lite を開きます。

  2. ナビゲーションウィンドウで、コンポーネントを作成するフォルダーを右クリックして、「作成」、「コンポーネントを作成」の順に選択します。

  3. コンポーネントの​ ラベルタイトル説明スーパーリソースタイプグループ ​を入力します。「次へ」をクリックします。

  4. (オプション)コンポーネントのプロパティ(「コンテナです」、「装飾なし」、「セル名」、「ダイアログパス」)を設定します。「次へ」をクリックします。

  5. (オプション)コンポーネントのプロパティ「許可されている親」を設定します。「次へ」をクリックします。

  6. (オプション)コンポーネントのプロパティ「許可されている子」を設定します。「OK」をクリックします。

  7. すべて保存」をクリックして、サーバーに変更を保存します。

次の項目が作成されます。

  • タイプのノード cq:Component
  • コンポーネントのプロパティ
  • コンポーネントの .jsp スクリプト

ダイアログの作成 creating-a-dialog

CRXDE Lite でダイアログを作成するには:

  1. ブラウザーで CRXDE Lite を開きます。

  2. ナビゲーションウィンドウで、ダイアログを作成するコンポーネントを右クリックして、「作成」、「ダイアログを作成」の順に選択します。

  3. ラベル ​と​ タイトル ​を入力します。「OK」をクリックします。

  4. すべて保存」をクリックして、サーバーに変更を保存します。

次の構造を持つダイアログが作成されます。

dialog[cq:Dialog]/items[cq:Widget]/items[cq:WidgetCollection]/tab1[cq:Panel]

これで、プロパティを変更したり、ノードを作成したりして、ニーズに合ったダイアログを作成できます。

ダイアログエディターを使用してダイアログを編集することもできます。CRXDE Lite でダイアログノードをダブルクリックすると、エディターが表示されます。詳しくは、ダイアログエディターを参照してください。

ノードの作成 creating-a-node

CRXDE Lite でノードを作成するには:

  1. ブラウザーで CRXDE Lite を開きます。
  2. ナビゲーションウィンドウで、新しいノードを作成するノードを右クリックして、「作成」、「ノードを作成」の順に選択します。
  3. 名前 ​を入力して、タイプ ​を選択します。「OK」をクリックします。
  4. すべて保存」をクリックして、サーバーに変更を保存します。

これで、プロパティを変更したり、ノードを作成したりして、ニーズに合ったノードを作成できます。

NOTE
ノードの作成を含むほとんどの編集操作では、すべての変更をメモリに保持し、保存時(「すべて保存」ボタンをクリックした場合)にのみそれらをリポジトリに格納します。ただし、移動などの一部の操作は自動的に保持されます。
最初に変更を保存する際には、新しく作成したノードが親ノードのノードタイプで許可されるかどうかに関する検証も JCR リポジトリによって実行されます。ノードの保存時にエラーメッセージが表示された場合は、コンテンツ構造が有効かどうかを確認してください(例えば、nt:unstructured ノードを nt:folder ノードの子として作成することはできません)。

プロパティの作成 creating-a-property

CRXDE Lite でプロパティを作成するには:

  1. ブラウザーで CRXDE Lite を開きます。

  2. ナビゲーションウィンドウで、新しいプロパティを追加するノードを選択します。

  3. 下部のウィンドウの「プロパティ」タブで、名前タイプ ​および​ ​に入力します。「追加」をクリックします。

  4. すべて保存」をクリックして、サーバーに変更を保存します。

スクリプトの作成 creating-a-script

スクリプトを作成するには:

  1. ブラウザーで CRXDE Lite を開きます。

  2. ナビゲーションウィンドウで、スクリプトを作成するコンポーネントを右クリックして、「作成」、「ファイルを作成」の順に選択します。

  3. 拡張子を含む​ ファイル名 ​を入力します。「OK」をクリックします。

  4. 新しいファイルが編集ウィンドウ内のタブとして開きます。

  5. ファイルを編集します。

  6. すべて保存」をクリックして変更を保存します。

ノードタイプの書き出しと読み込み exporting-and-importing-node-types

CRXDE Lite では、CND(Compact Namespace and Node Type Definition)表記でノードタイプ定義を読み込んだり、書き出したりできます。

ノードタイプ定義を書き出すには:

  1. ブラウザーで CRXDE Lite を開きます。

  2. 必要なノードを選択します。

  3. ツール」、「ノードタイプを書き出し」の順に選択します。

  4. CND 表記の定義がブラウザーに表示されます。必要に応じて情報を保存します。

ノードタイプ定義を読み込むには:

  1. ブラウザーで CRXDE Lite を開きます。

  2. ツール」、「ノードタイプを読み込み」の順に選択します。

  3. テキストボックスに定義の CND 表記を入力します。

  4. 既存の定義を更新する場合は、「更新を許可」を選択します。

  5. インポート ​をクリックします。

ログ logging

CRXDE Lite では、ファイルシステムの <crx-install-dir>/crx-quickstart/server/logs にある error.log ファイルを表示して、適切なログレベルでフィルタリングできます。以下の手順を実行します。

  1. ブラウザーで CRXDE Lite を開きます。

  2. ウィンドウの下部にある「コンソール」タブの右側のドロップダウンメニューで、「サーバーログ」を選択します。

  3. 停止 ​アイコンをクリックして、メッセージを表示します。

以下の操作を実行できます。

  • ログ設定 ​アイコンをクリックして、Felix コンソールでログパラメーターを調整します。
  • ブラシ ​アイコンをクリックして、メッセージを消去します。
  • ピン留め ​アイコンをクリックして、現在選択されている場所にメッセージを固定します。
  • 停止 ​アイコンをクリックしてメッセージの表示を有効または無効にします。

アクセス制御 access-control

NOTE
詳しくは、ユーザー、グループおよびアクセス権の管理を参照してください。
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2