ストレージリソースプロバイダーの概要

はじめに

Adobe Experience Manager(AEM)Communities 6.1 以降、コミュニティコンテンツ ( 一般的にユーザー生成コンテンツ (UGC) と呼ばれる ) は、 ストレージリソースプロバイダー (SRP)。

複数の SRP オプションがあり、新しいAEM Communitiesインターフェイスを介して UGC にアクセスできます。 SocialResourceProvider API (SRP API)：すべての作成、読み取り、更新、削除 (CRUD) 操作を含みます。

すべての SCF コンポーネントは SRP API を使用して実装され、 基盤トポロジ または UGC の場所。

SocialResourceProvider API は、AEM Communitiesのライセンスを持つお客様のみが利用できます。

関連トピック：

• SRP と UGC の基本事項 - SRP ユーティリティのメソッドと例。
• SRP を使用した UGC へのアクセス — コーディングのガイドライン。
• SocialUtils のリファクタリング — 非推奨のユーティリティメソッドを現在の SRP ユーティリティメソッドにマッピングします。

リポジトリについて

SRP を理解するには、AEMコミュニティサイトでのAEMリポジトリ (Oak) の役割を理解すると役に立ちます。

Java™コンテンツリポジトリ (JCR)
この標準は、データモデルとアプリケーションプログラミングインターフェイスを定義します (JCR API) をコンテンツリポジトリーに追加します。 従来のファイル・システムの特性とリレーショナル・データベースの特性を組み合わせ、コンテンツ・アプリケーションが頻繁に必要とする機能をいくつか追加します。

JCR の実装の 1 つはAEMリポジトリ Oak です。

Apache Jackrabbit Oak
Oak は、コンテンツ中心のアプリケーション向けに設計されたデータストレージシステムである JCR 2.0 の実装です。 これは、非構造化データと半構造化データ用に設計された階層データベースの一種です。 リポジトリには、ユーザーに表示されるコンテンツだけでなく、アプリケーションで使用されるすべてのコード、テンプレート、内部データも保存されます。 コンテンツにアクセスするための UI は次のとおりです。 CRXDE Lite.

通常、JCR と Oak の両方がAEMリポジトリを参照するために使用されます。

非公開のオーサー環境でサイトコンテンツを開発した後は、公開パブリッシュ環境にコピーする必要があります。 これは、多くの場合、 複製. これは、作成者、開発者、管理者の管理下で発生します。

UGC の場合、コンテンツは公開パブリッシュ環境で登録されたサイト訪問者（コミュニティメンバー）によって入力されます。 これはランダムに発生します。

管理とレポートの目的で、プライベートオーサー環境から UGC にアクセスできると便利です。 SRP では、パブリッシュからオーサーへのリバースレプリケーションは必要ないので、オーサーから UGC へのアクセスの一貫性とパフォーマンスが向上します。

SRP について

UGC を共有ストレージに保存すると、メンバーコンテンツのインスタンスが 1 つになり、ほとんどのデプロイメントで、オーサー環境とパブリッシュ環境の両方からアクセスできます。 SRP の選択 (MSRP、ASRP、JSRP) に関係なく、すべての SRP API を使用してプログラムからアクセスする必要があります。

ASRP

ASRP がある場合、UGC は JCR に格納されず、Adobeがホストおよび管理するクラウドサービスに格納されます。 ASRP に保存された UGC は、CRXDE Liteと共に表示したり、JCR API を使用してアクセスしたりすることはできません。

詳しくは、 ASRP -Adobeストレージリソースプロバイダ.

開発者が UGC に直接アクセスすることはできません。

ASRP は、クエリにAdobeクラウドを使用します。

MSRP

存在する場合、MSRP、UGC は JCR に格納されず、MongoDB に格納されます。 MSRP に格納された UGC は、CRXDE Liteで表示したり、JCR API を使用してアクセスしたりすることはできません。

詳しくは、 MSRP - MongoDB ストレージリソースプロバイダー.

MSRP は ASRP と同等ですが、すべてのAEMサーバーインスタンスが同じ UGC にアクセスするので、共通のツールを使用して MongoDB に格納された UGC に直接アクセスできます。

MSRP はクエリに Solr を使用します。

JSRP

JSRP は、1 つのAEMインスタンス上のすべての UGC にアクセスするためのデフォルトのプロバイダーです。 MSRP や ASRP を設定しなくても、AEM Communities 6.1 をすばやく体験できます。

詳しくは、 JSRP - JCR ストレージリソースプロバイダー.

UGC が JCR に格納されている間に JSRP が存在し、CRXDE Liteおよび JCR API でアクセスできる場合、Adobeでは JCR API を使用しないことをお勧めします。 設定すると、今後の変更がカスタムコードに影響を与える可能性があります。

さらに、オーサー環境とパブリッシュ環境用のリポジトリは共有されません。 パブリッシュインスタンスのクラスターが共有パブリッシュリポジトリになりますが、パブリッシュで入力した UGC はオーサーに表示されないので、オーサーから UGC を管理することはできません。 UGC は、入力されたインスタンスのAEMリポジトリ (JCR) にのみ保持されます。

JSRP は、クエリに Oak インデックスを使用します。

JCR のシャドウノードについて

UGC へのパスを模倣するシャドウノードは、ローカルリポジトリ内に存在し、次の 2 つの目的を果たします。

1. アクセス制御 (ACL)
2. 存在しないリソース (NER)

SRP の実装に関係なく、実際の UGC は not シャドウノードと同じ場所に表示されます。

アクセス制御 (ACL) の場合

ASRP や MSRP などの一部の SRP 実装では、ACL 検証を提供しないデータベースにコミュニティコンテンツを格納します。 シャドウノードは、ACL を適用できるローカルリポジトリ内の場所を提供します。

SRP API を使用すると、すべての SRP オプションで、すべての CRUD 操作の前に、シャドウの場所が同じにチェックされます。

ACL チェックでは、リソースの UGC に適用される権限の確認に適したパスを返すユーティリティメソッドを使用します。

詳しくは、 SRP と UGC の基本事項 を参照してください。

存在しないリソース (NER) の場合

一部のコミュニティコンポーネントは、スクリプト内に組み込まれるので、コミュニティ機能をサポートするには Sling アドレス可能ノードが必要です。 含まれるコンポーネント は、存在しないリソース (NER) と呼ばれます。

シャドウノードは、リポジトリ内の Sling アドレス可能な場所を提供します。

ストレージの場所

次に、 コメントコンポーネント （内） コミュニティコンポーネントガイド:

• コンポーネントは、次の場所にあるローカルリポジトリに存在します。

  /content/community-components/en/comments/jcr:content/content/includable/comments

• 対応するシャドウノードが、次の場所にあるローカルリポジトリに存在します。

  /content/usergenerated/content/community-components/en/comments/jcr:content/content/includable/comments

シャドウノードの下に UGC が見つかりません。

デフォルトの動作では、関連するサブツリーが読み取りまたは書き込み用に参照されるたびに、パブリッシュインスタンス上にシャドウノードを設定します。

例えば、デプロイメントが MSRP TarMK パブリッシュファームを使用します。

When a メンバー pub1（MongoDB に格納）に UGC を投稿し、pub1 の JCR にシャドウノードを作成します。

UGC が pub2 で初めて読み取られる場合、何も設定されていないと、デフォルトの動作ではシャドウノードが作成されます。

デフォルト動作以外の動作が必要な場合は、オーサーインスタンスで設定し、すべてのパブリッシュインスタンス（通常は手動プロセス）にロールフォワードする必要があります。