リポジトリーブラウザー repository-browser
はじめに introduction
リポジトリブラウザーは、オーサー層、パブリッシュ層およびプレビュー層でのすべての環境に対してリポジトリへの読み取り専用ビューを提供する開発者ツールです。コンテンツの確認やデバッグを容易にするように、コンテンツ構造が見やすく設計されています。
AEM as a Cloud Service Developer Consoleからアクセスでき、選択した環境のオーサーインスタンスまたはパブリッシュインスタンスのリポジトリを参照するために使用できます。
アクセスのための前提条件 access-prerequisites
AEM as a Cloud Service Developer Console またはリポジトリブラウザーにアクセスするには、次の条件を満たす必要があります。
AEM as a Cloud Service Developer Console にアクセスするには、Developer Console へのアクセスを参照してください。
リポジトリブラウザーにアクセスするための条件は、AEM as a Cloud Service Developer Console(上記で指定)の場合と同じです。特定のインスタンスのリポジトリブラウザーのコンテンツを表示するには:
-
オーサーインスタンス:オーサーインスタンス の AEM ユーザー製品プロファイルを持つユーザーは、最小限の読み取りアクセス権でリポジトリブラウザーを表示できます。リポジトリを参照する際は、ユーザーの権限が適用されます。「AEM 管理者」製品プロファイルを持つユーザーは、完全な読み取りアクセス権でリポジトリブラウザーを表示できます。
-
パブリッシュインスタンス:パブリッシュインスタンス の AEM ユーザー製品プロファイルを持つユーザーは、最小限の読み取りアクセス権でリポジトリブラウザーを表示できます。製品プロファイルを設定していない場合、ユーザーは匿名ユーザーとして移動することになり、権限が制限されるので、一部のパスが表示されません。
ユーザー権限の設定について詳しくは、Cloud Manager のドキュメントを参照してください。
リポジトリーブラウザーの起動 launching-the-repository-browser
リポジトリーブラウザーは、次の手順に従って起動できます。
-
Cloud Manager で、目的の環境の横にある 3 ドットアイコンをクリックし、「開発者コンソール」を選択します。
-
次に、「リポジトリーブラウザー」タブをクリックします。
-
「ポッド」ドロップダウンリストをクリックして、オーサー、パブリッシュ、プレビューに対応する任意のポッドを選択します。
-
下方の「リポジトリブラウザーを開く」リンクをクリックして、リポジトリブラウザーを起動します。選択した層の代表的なインスタンス(ポッド)に対応するブラウザーが起動します。起動されたその階層の特定のポッドは制御できません。
機能 features
階層のナビゲーション navigate-the-hierarchy
左側のナビゲーションパネルを使用して、コンテンツ階層内を移動できます。各フォルダーまたはノードをクリックすると、その子が表示されます。フォルダー構造には、JCR ノードツリーのスーパーセットである Sling リソースツリーが反映されています。
または、以下に示すように、「パス」フィールドにパスを入力して、パスに直接移動することもできます。このパスにより、左側のコンテンツ階層表示での場所も拡張されます。
左側のフォルダーをクリックすると、「パス」フィールドにその場所が自動的に入力されます。この機能は、後で使用するために値をコピーおよびペーストする場合に便利です。
また、フォルダーをクリックすると、そのパスがクリックしたフォルダーに含まれるように URL が動的に変更されます。この機能により、ブックマーク可能な URL が可能になります。
パブリッシュ層の場合、デフォルトでは、リポジトリブラウザーには公開コンテンツのみが表示されます。したがって、/conf
や /home
などの特定のフォルダーは表示されません。
これらの場所を表示するには、次の操作を実行します。
-
目的の環境の横にある 3 ドットアイコンをクリックし、「アクセスを管理」を選択します。
-
パブリッシュインスタンスを見つけて、クリックします。
-
パブリッシュ管理者用の製品プロファイルを作成します。以下の例では、DEV - AEM Administrators Publish という名前が付いています。
-
フルアクセス権でパブリッシュリポジトリーブラウザーをナビゲートできるユーザーに対応する適切なユーザーを新しい製品プロファイルに追加します。
-
数分待ってから、AEM オーサー コンソールを開きます。
-
新しい製品プロファイルに対応するグループを管理者のグループのメンバーとして追加するには、ツール/セキュリティ/オーサー環境でのグループ をクリックし、管理者 グループをクリックします。次に、以下に示すようにグループを追加します。
-
administrators グループと新しい DEV - AEM Administrators Publish グループをアクティブにして、パブリッシュインスタンスで使用できるようにします。
-
よいセキュリティプラクティスとして、新しい DEV - AEM Administrators Publish グループを オーサー 環境の管理者のグループから削除して、新しいグループがパブリッシュ環境から分離されるようにします。
-
パブリッシュインスタンスのリポジトリーブラウザーにアクセスすると、
/home
や/conf
などを含むすべてのフォルダーが表示されます。
JCR プロパティの表示 view-jcr-properties
ノードをクリックすると、ナビゲーションブラウザーの右側のウィンドウに JCR プロパティが表示されます。以下は、experience-fragments
ノードの例です。
コンテンツを表示 view-content
リポジトリブラウザーを使用して、コンテンツを表示できます。ナビゲーションウィンドウでリソースをクリックすると、ブラウザーの右側で、各リソースの名前が付いたタブの下にプレビューが開きます。
プレビューは、次の画像タイプで使用できます。
- apng
- avif
- gif
- jpeg
- png
- svg+xml
- webp
- bmp
- x-icon
- tiff
また、次のテキストベースの MIME タイプの場合もプレビューを使用できます。
"text/*"
'application/javascript'
'application/json'
'application/x-sh'
コンテンツのダウンロード download-content
リポジトリーブラウザーを使用して、コンテンツをダウンロードすることもできます。次の例では、「ダウンロード」リンクをクリックして、選択したノードに関連する jcr:data
をダウンロードできます。この機能は、プロパティ定義を含んだノードに移動することで、すべてのバイナリプロパティで使用できます。