Show Menu
トピック×

コンテンツ配信

単一ページアプリケーションフレームワークを基にしたクライアント側レンダリング(React など)が必要なプロジェクトでは、SPA エディターを使用することをお勧めします。 詳細情報
モバイルアプリは、目的とするアプリエクスペリエンスを配信するために、AEM 内のあらゆるコンテンツを必要に応じて利用できなければなりません。
これには例えば、アセット、サイトコンテンツ、CaaS コンテンツ、無線(OTA)コンテンツ、独自の構造を持つカスタムコンテンツなどが含まれます。
Over-the-Air Contentは 、ContentSyncハンドラーを使用して上記のいずれかのコンテンツから取得できます。 無線コンテンツを使用すると、パッケージと配信を Zip して一括で処理したり、アップデートやパッケージを保守したりできます。
コンテンツサービスは、主に 3 種類の要素を配信します。
  1. アセット
  2. パッケージド HTML コンテンツ(HTML/CSS/JS)
  3. チャネル独立コンテンツ

アセット

アセットコレクションは、他のコレクションの参照を含む AEM 構成要素です。
アセットコレクションは、コンテンツサービスを介して公開できます。要求でアセットコレクションを呼び出すと、アセットのリストであるオブジェクト(URLを含む)が返されます。 アセットは URL を介してアクセスされ、その URL はオブジェクトの形で提供されます。次に例を示します。
  • ページエンティティは、画像参照を含む JSON(ページオブジェクト)を返します。画像参照は、画像のアセットバイナリの取得に使用されるURLです。
  • フォルダー内のアセットのリストをリクエストすると、JSON と、そのフォルダー内のすべてのエンティティに関する詳細が返されます。そのリストは目的物です。 この JSON は、そのフォルダー内の各アセットのアセットバイナリを取得するために使用する URL 参照を含みます。

アセットの最適化

コンテンツサービスは、デバイス用に最適化されたアセットを返します。これは、コンテンツサービスの重要な機能です。これにより、ローカルデバイスのストレージのニーズが減り、アプリのパフォーマンスが向上します。
アセットの最適化は、API リクエストで提供される情報に基づく、サーバー側の機能です。可能な限り、アセットのレンディションをキャッシュして、同様の要求を行ってもアセットのレンディションを再生成する必要がないようにします。

アセットのワークフロー

次に、アセットのワークフローを示します。
  1. 既製の AEM で使用可能なアセット参照
  2. モデルを選択してアセット参照エンティティを作成
  3. エンティティを編集
    1. 資産または資産コレクションを選択
    2. JSON レンダリングをカスタマイズ
The following diagram shows the Assets Reference Workflow :

アセットの管理

コンテンツサービスは、他の AEM コンテンツを介して参照できない、AEM の管理対象アセットへのアクセスを提供します。

既存の管理対象アセット

既存の AEM Sites および Assets ユーザーは、AEM Assets を使用して、すべてのチャネルのすべてのデジタル要素を管理しています。ネイティブモバイルアプリを開発しているので、AEM Assetsで管理される複数のアセットを使用する必要があります。 例えば、ロゴ、背景画像、ボタンアイコンなど。
現在、これらのアセットは、アセットリポジトリ全体にわたって保存されています。アプリが参照する必要のあるファイルは次のとおりです。
  • /content/dam/geometrixx-outdoors/brand/logo_light.png
  • /content/dam/geometrixx-outdoors/brand/logo_dark.png
  • /content/dam/geometrixx-outdoors/styles/backgrounds/grey_blue.jpg
  • /content/dam/geometrixx-outdoors/brand/icons/app/cart.png
  • /content/dam/geometrixx-outdoors/brand/icons/app/home.png

CS アセットエンティティへのアクセス

ここでは、ページは既に使用可能になっているものとします。API を利用してページを使用可能にする手順については触れません(この手順については、AEM UI に関する説明で触れます)。アセットエンティティが作成され、「appImages」スペースに追加されました。 組織のために、スペースの下に追加のフォルダーが作成されました。 したがって、アセットエンティティはAEM JCRに次のように保存されます。
  • /content/entities/appImages/logos/logo_light
  • /content/entities/appImages/logos/logo_dark
  • /content/entities/appImages/bkgnd/grey_blue
  • /content/entities/appImages/icons/cart
  • /content/entities/appImages/icons/home

使用可能なアセットエンティティのリストの取得

アプリ開発者は、アセットエンティティを取得することで、使用可能なアセットのリストを取得できます。Content Servicesスペースエンドポイントは、WebサービスAPI SDKを介してこの情報を提供できます。
結果として取得できるリストは、「icons」フォルダー内のアセットのリストを提供する JSON 形式のオブジェクトです。

画像の取得

JSON は、コンテンツサービスによって生成される各画像に URL を提供します。
「cart」画像のバイナリを取得するために、クライアントライブラリは再度使用されます。

パッケージド HTML コンテンツ

コンテンツのレイアウトを維持するには、HTML コンテンツが必要です。これは、Cordova webビューなど、Webコンテナを使用してコンテンツを表示するネイティブアプリケーションで役立ちます。
AEM コンテンツサービスは、API を介してモバイルアプリに HTML コンテンツを提供できます。AEMコンテンツをHTMLとして公開したい場合、AEMコンテンツソースを指すHTMLページエンティティが作成されます。
次のオプションを検討します。
  • ​Zipファイル:デバイス上で適切に表示するために、ページの参照されているすべてのマテリアル(css、JavaScript、アセットなど) — 応答と共に単一の圧縮ファイルに含まれます。 HTMLページ内の参照は、これらのファイルへの相対パスを使用するように調整されます。
  • ​ストリーミング:AEMから必要なファイルのマニフェストを取得します。 次に、これ以降のリクエストでは、このマニフェストを使用してすべてのファイル(HTML、CSS、JS など)をリクエストします。

チャネル独立コンテンツ

チャネルに依存しないコンテンツは、レイアウトやコンポーネント、その他のチャネル固有の情報を気にすることなく、ページなどのAEMコンテンツ構成を公開する手段です。
これらのコンテンツエンティティは、コンテンツモデルを使用して AEM 構成要素を JSON 形式に変換することで生成されます。結果のJSONデータには、コンテンツのデータに関する情報(AEMリポジトリとの分離)が含まれます。 これには、メタデータとAEM参照リンクをアセットに返すこと、およびコンテンツ構造(エンティティ階層を含む)間の関係を返すことが含まれます。

チャネル独立コンテンツの管理

コンテンツは、様々な方法でアプリにアクセスできます。
  1. AEM 無線を介してコンテンツの ZIP を取得します。
    • コンテンツ同期ハンドラーは、zipパッケージを直接更新するか、既存のコンテンツレンダラーを呼び出して更新できます
      • プラットフォームハンドラー
      • AEMM ハンドラー
      • カスタムハンドラー
  2. コンテンツレンダラーを介してコンテンツを直接取得します。
    • 既製のデフォルト Sling レンダラー
    • AEM Mobile/コンテンツサービスのコンテンツレンダラー
    • カスタムレンダリング