CRXDE Lite による開発

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

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

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

メモ

AEM 6.5.5.0 以降では、CRXDE Lite の匿名アクセスは不可能になりました。
ユーザーはログイン画面にリダイレクトされます。

メモ

プロジェクトの開発時には AEM Developer Tools for Eclipse および AEM HTL Brackets Extension を使用することをお勧めします。

CRXDE Lite の使用

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

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

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

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

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

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

chlimage_1-18

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

ユーザーインターフェイスの概要

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

上部のスイッチャーバー CRXDE Lite、パッケージマネージャー、パッケージ共有をすぐに切り替えることができます。
ノードパスウィジェット

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

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

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

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

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

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

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

エクスプローラーウィンドウでファイルをダブルクリックして、その内容を表示します（例：.jsp ファイルまたは .java ファイル）。次に、ファイルを変更して保存できます。

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

- ツリーに表示：リポジトリツリー内のファイルを表示します。
- 検索と置換：検索または置換をおこないます。

編集ウィンドウのステータス行をダブルクリックすると、行に移動ダイアログが開き、移動先の特定の行番号を入力できます。
「プロパティ」タブ
 選択したノードのプロパティを表示します。新しいプロパティを追加したり、既存のプロパティを削除したりできます。
「アクセス制御」タブ

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

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

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

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

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

注意：アクセス制御情報を確認できるようにするには、CRXDE Lite にログインしたユーザーに ACL エントリを読み取る権限が割り当てられている必要があります。デフォルトでは、匿名ユーザーはこの情報を確認できません。情報を確認するには、例えば admin としてログインしてください。
「レプリケーション」タブ

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

サーバーログ：

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

バージョン管理：

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

すべて保存：

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

元に戻す：

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

すべて元に戻す：

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

- SiteCatalyst デバッガーをインストール：Analytics デバッガーをインストールする手順を示します。
ログインウィジェット

現在ログイン中のユーザーとログイン先のワークスペースを表示します（例：admin@crx.default）。

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

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

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

フォルダーの作成

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

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

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

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

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

テンプレートの作成

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

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

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

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

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

  5. 「許可されている親」を設定します。「次へ」をクリックします。

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

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

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

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

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

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

コンポーネントの作成

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

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

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

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

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

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

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

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

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

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

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

ダイアログの作成

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

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

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

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

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

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

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

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

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

ノードの作成

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

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

これで、プロパティを変更するか、または新しいノードを作成すれば、ニーズに合ったノードを作成できます。

メモ

ノードの作成を含むほとんどの編集操作では、すべての変更をメモリに保持し、保存時（「すべて保存」ボタンをクリックした場合）にのみそれらをリポジトリに格納します。ただし、移動などの一部の操作は自動的に保持されます。

最初に変更を保存する際には、新しく作成したノードが親ノードのノードタイプで許可されるかどうかに関する検証も JCR リポジトリによって実行されます。ノードの保存時にエラーメッセージが表示された場合は、コンテンツ構造が有効かどうかを確認してください（例えば、nt:unstructured ノードを nt:folder ノードの子として作成することはできません）。

プロパティの作成

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

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

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

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

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

スクリプトの作成

新しいスクリプトを作成するには：

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

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

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

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

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

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

ノードタイプの書き出しと読み込み

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

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

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

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

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

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

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

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

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

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

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

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

ログ

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

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

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

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

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

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

アクセス制御

メモ

詳しくは、ユーザー、グループおよびアクセス権の管理を参照してください。

このページ