モバイルとコンテンツ同期 mobile-with-content-sync

コンテンツ同期を使用してコンテンツをパッケージ化し、ネイティブモバイルアプリケーションで使用できるようにします。 AEMで作成されたページは、デバイスがオフラインの場合でも、アプリコンテンツとして使用できます。 さらに、AEMページは Web 標準に基づいているので、クロスプラットフォームで機能し、任意のネイティブラッパーに埋め込むことができます。 この戦略により、開発作業を削減し、アプリコンテンツを簡単に更新できます。

コンテンツ同期フレームワークは、Web コンテンツを格納するアーカイブファイルを作成します。 単純なページ、画像、PDFファイル、Web アプリケーション全体から、あらゆるコンテンツを作成できます。 コンテンツ同期 API を使用すると、モバイルアプリまたはビルドプロセスからアーカイブファイルにアクセスして、コンテンツを取得してアプリに含めることができます。

次に、コンテンツ同期の一般的な使用例を示します。

コンテンツ同期ハンドラーの開発 developing-the-content-sync-handlers

コンテンツ同期ハンドラーの開発に関するガイドラインの一部を次に示します。

コンテンツ同期コンテンツの設定 configuring-the-content-sync-content

コンテンツ同期設定を作成して、クライアントに配信される ZIP ファイルのコンテンツを指定します。 任意の数のコンテンツ同期設定を作成できます。 各設定には、識別のための名前が付けられます。

コンテンツ同期設定を作成するには、 cq:ContentSyncConfig リポジトリのノードに、 sling:resourceType プロパティを contentsync/config. この cq:ContentSyncConfig ノードはリポジトリ内の任意の場所に配置できますが、AEMパブリッシュインスタンス上のユーザーがそのノードにアクセスできる必要があります。 したがって、以下にノードを追加する必要があります。 /content.

コンテンツ同期 ZIP ファイルのコンテンツを指定するには、cq:ContentSyncConfig ノードに子ノードを追加します。 各子ノードの次のプロパティは、含めるコンテンツ項目と、その追加時の処理方法を識別します。

詳しくは、 コンテンツ同期設定の例 を参照してください。

コンテンツ同期設定を作成すると、その設定がコンテンツ同期コンソールに表示されます。

コンテンツ同期ダウンロードへのアクセスの設定 configuring-access-to-content-sync-downloads

コンテンツ同期からダウンロードできるユーザーまたはグループを指定します。 すべてのコンテンツ同期キャッシュからダウンロードできるデフォルトのユーザーまたはグループを設定できます。また、デフォルトを上書きして、特定のコンテンツ同期設定のアクセスを設定できます。

AEMをインストールすると、管理者グループのメンバーは、デフォルトでコンテンツ同期からダウンロードできます。

コンテンツ同期ダウンロードのデフォルトアクセスの設定 setting-the-default-access-for-content-sync-downloads

Day CQ Content Sync Manager サービスは、コンテンツ同期へのアクセスを制御します。 このサービスを設定して、デフォルトでコンテンツ同期からダウンロードできるユーザーまたはグループを指定します。

次の場合、 Web コンソールを使用したサービスの設定の場合は、ユーザーまたはグループの名前を Fallback Cache Authorizable プロパティの値として入力します。

次の場合、 リポジトリでの設定を使用する場合は、このサービスに関する次の情報を使用します。

コンテンツ同期キャッシュのダウンロードアクセスの上書き overriding-download-access-for-a-content-sync-cache

特定のコンテンツ同期設定のダウンロードアクセスを設定するには、次のプロパティを cq:ContentSyncConfig ノード：

例えば、ユーザーがアプリを使用して、コンテンツ同期から直接更新をインストールできるようにします。 すべてのユーザーが更新をダウンロードできるようにするには、authorizable プロパティの値をに設定します。 everyone.

この cq:ContentSyncConfig ノードに authorizable プロパティがない場合、Day CQ Content Sync Manager サービスの Fallback Cache Authorizable プロパティ用に設定されているデフォルトのユーザーまたはグループが、誰をダウンロードできるかを決定します。

コンテンツ同期キャッシュを更新するためのユーザーの設定 configuring-the-user-for-updating-a-content-sync-cache

ユーザーがコンテンツ同期キャッシュの更新を実行すると、特定のユーザーアカウントがユーザーに代わってアクションを実行します。 匿名ユーザーは、デフォルトで、すべてのコンテンツ同期キャッシュを更新します。

デフォルトのユーザーを上書きし、特定のコンテンツ同期キャッシュを更新するユーザーまたはグループを指定できます。

デフォルトのユーザーを上書きするには、次のプロパティを cq:ContentSyncConfig ノードに追加して、特定のコンテンツ同期設定の更新を実行するユーザーまたはグループを指定します。

この cq:ContentSyncConfig ノードがありません updateuser プロパティ、デフォルト anonymous ユーザーがキャッシュを更新します。

設定タイプ configuration-types

処理には、単純な JSON のレンダリングから、参照元のアセットを含むページの完全に本格的なレンダリングまで多岐にわたります。 この節では、使用可能な設定タイプとその特定のパラメーターを示します。

コピー ファイルとフォルダーをコピーするだけです。

コンテンツ 標準を使用してコンテンツをレンダリング Sling リクエストの処理.

clientlib JavaScript または CSS クライアントライブラリをパッケージ化します。

アセット

アセットのオリジナルのレンディションを収集します。

画像 画像を収集します。

画像タイプは、We Retail ロゴを zip ファイルに含めるために使用されます。

ページ AEMページをレンダリングし、参照元のアセットを収集します。

書き換え rewrite ノードは、書き出されたページでリンクを書き換える方法を定義します。 書き換えられたリンクは、zip ファイルに含まれるファイルまたはサーバー上のリソースを指す場合があります。

この rewrite ノードは、以下に配置する必要があります。 page ノード。

この rewrite ノードには、次の 1 つ以上のプロパティを含めることができます。

各プロパティは、次のいずれかの値を持つことができます。

AEMサービスの名前： PathRewriterTransformerFactory では、書き換える特定の html 属性を設定できます。 このサービスは Web コンソールで設定でき、 rewrite ノード： clientlibs, images および links.

この機能はAEM 5.5 で追加されました。

コンテンツ同期設定の例 example-content-sync-configuration

次のリストは、コンテンツ同期の設定例を示しています。

+ weretail_go [cq:ContentSyncConfig]
  - sling:resourceType = "contentsync/config"

  + etc.designs.default [nt:unstructured]
    - path = "/etc/designs/default"
    - type = "copy"

  + etc.designs.mobile [nt:unstructured]
    - path = "/etc/designs/mobile"
    - type = "copy"

  + events.plist [nt:unstructured]
    - path = "/content/weretail_mobile/en/events/jcr:content/par/events"
    - type = "content"
    - extension = "plist"

  + events.touch.html [nt:unstructured]
    - path = "/content/weretail_mobile/en/events"
    - type = "pages"
    - extension = "html"
    - selector = "touch"

  + logo [nt:unstructured]
    - path = "/etc/designs/mobile/jcr:content/mobilecontentpage/logo"
    - type = "logo"

  + manifest [nt:unstructured]
    - indexPage = "/content/weretail_mobile/en/events.touch.html"
    - metadataPlist = "/content/weretail_mobile/en/events/_jcr_content/par/events.plist"

  + ...

etc.designs.default と etc.designs.mobile 設定の最初の 2 つのエントリは、非常に明確である必要があります。 多数のモバイルページを含める場合は、/etc/designs の下に関連するデザインファイルが必要です。 追加の処理は不要なので、コピーで十分です。

events.plist このエントリは、少し特別です。 導入で説明したように、アプリケーションは、イベントの位置のマーカーを持つマップビューを提供する必要があります。 必要なロケーション情報は、PLIST 形式の個別のファイルとして提供します。 これを機能させるには、インデックスページで使用されるイベントリストコンポーネントに plist.jsp というスクリプトを使用します。 このスクリプトは、コンポーネントのリソースが.plist 拡張子を持つように要求されたときに実行されます。 通常どおり、コンポーネントのパスは path プロパティで指定され、タイプは content に設定されます。これは、 Sling リクエストの処理.

events.touch.html 次に、アプリに表示される実際のページが表示されます。 path プロパティがイベントのルートページに設定されます。 ディーププロパティのデフォルト値は true なので、そのページ以下のすべてのイベントページも含まれます。 ページを設定タイプとして使用し、画像またはページ上のダウンロードコンポーネントから参照される画像やその他のファイルが含まれるようにします。 また、タッチセレクターを設定すると、モバイルバージョンのページが表示されます。 機能パックの設定には、この種のエントリがさらに含まれていますが、ここでは簡単にするために、これらは省略されています。

ロゴ ロゴの設定タイプについては、これまで説明されておらず、組み込みタイプにもなりません。 ただし、コンテンツ同期フレームワークはある程度拡張可能です。これはその一例で、次の節で説明します。

manifest 多くの場合、コンテンツの開始ページなど、何らかの種類のメタデータを zip ファイルに含めることが望ましいと考えられます。 ただし、このような情報をハードコーディングすると、後で簡単に変更できなくなります。 コンテンツ同期フレームワークは、設定内のマニフェストノードを探すことでこの使用例をサポートします。このノードは名前で識別されるだけで、設定タイプは不要です。 特定のノードで定義されたすべてのプロパティは、ファイルに追加されます。このファイルは manifest とも呼ばれ、zip ファイルのルートに存在します。

この例では、イベントリストページは最初のページであると想定されています。 この情報は、 indexPage これにより、いつでも簡単に変更できるプロパティを作成できます。 2 つ目のプロパティは、 events.plist ファイル。 後で説明するように、クライアントアプリケーションはマニフェストを読み取り、それに従って動作できるようになります。

設定が完了し次第、ブラウザーまたはその他の HTTP クライアントを使用してコンテンツをダウンロードできます。iOS用に開発する場合は、専用の WAppKitSync クライアントライブラリを使用できます。 ダウンロード場所は、設定のパスと .zip 拡張機能 ( 例：ローカルAEMインスタンスを使用する場合 ): http://localhost:4502/content/weretail_go.zip

コンテンツ同期コンソール the-content-sync-console

コンテンツ同期コンソールには、リポジトリ内のすべてのコンテンツ同期設定（タイプのすべてのノード）がリストされます cq:ContentSyncConfig) と各設定で、次の操作を実行できます。

開発やトラブルシューティングに役立ちます。

コンソールには、次の場所からアクセスできます。

http://localhost:4502/libs/cq/contentsync/content/console.html

次のようなコンソールが表示されます。

コンテンツ同期フレームワークの拡張 extending-the-content-sync-framework

設定オプションの数は既にかなり多いものの、特定の使用例のすべての要件を満たしているわけではない場合があります。 この節では、コンテンツ同期フレームワークの拡張ポイントと、カスタム設定タイプの作成方法について説明します。

設定タイプごとに、 コンテンツ更新ハンドラー：その特定のタイプに対して登録される OSGi コンポーネントファクトリです。 これらのハンドラーは、コンテンツを収集し、処理し、コンテンツ同期フレームワークで管理されるキャッシュに追加します。 次のインターフェイスまたは抽象基本クラスを実装します。

クラスを OSGi コンポーネントファクトリとして登録し、バンドルの OSGi コンテナにデプロイします。 これは、 Maven SCR プラグイン JavaDoc タグまたは注釈の使用 次の例は、JavaDoc のバージョンを示しています。

/*
 * @scr.component metatype="no"
 * factory="com.day.cq.contentsync.handler.ContentUpdateHandler/customtype"
 */
public class CustomTypeUpdateHandler implements ContentUpdateHandler {
    // add your code here
}

/*
 * @scr.component metatype="no" inherit="true"
 * factory="com.day.cq.contentsync.handler.ContentUpdateHandler/othertype"
 */
public class OtherTypeUpdateHandler extends AbstractSlingResourceUpdateHandler {
    // add your code here
}

この 工場 定義には、共通インターフェイスとカスタムタイプをスラッシュで区切って含めます。 この方法では、コンテンツ同期フレームワークが設定エントリでカスタムタイプを認識し、カスタムクラスのインスタンスを検索して作成できます。 次の節では、カスタム更新ハンドラの具体的な例を示します。

カスタム更新ハンドラーの実装 implementing-a-custom-update-handler

すべての We.Retail Mobile ページの左上隅には、もちろん zip ファイルに含めたいロゴが含まれています。 ただし、キャッシュの最適化の場合、AEMは画像ファイルのリポジトリ内の実際の場所を参照しないので、 コピー 設定タイプ。 代わりに、独自の ロゴ AEMが要求した場所で画像を使用できるようにする設定タイプ。 次のコードリストは、ロゴ更新ハンドラーの完全な実装を示しています。

LogoUpdateHandler.java logoupdatehandler-java

package com.day.cq.wcm.apps.weretail.impl;

import javax.jcr.Node;
import javax.jcr.RepositoryException;
import javax.jcr.Session;

import org.apache.sling.api.resource.Resource;
import org.apache.sling.api.resource.ResourceResolver;
import org.apache.sling.jcr.resource.JcrResourceResolverFactory;

import com.day.cq.commons.jcr.JcrUtil;
import com.day.cq.contentsync.config.ConfigEntry;
import com.day.cq.contentsync.handler.ContentUpdateHandler;
import com.day.cq.wcm.foundation.Image;
import com.day.text.Text;

/**
 * The <code>LogoUpdateHandler</code> is used to update the content sync cache
 * with a page logo added using a logo component.
 *
 * @scr.component metatype="no"
 * factory="com.day.cq.contentsync.handler.ContentUpdateHandler/logo"
 */
public class LogoUpdateHandler implements ContentUpdateHandler {

    private static final Logger log = LoggerFactory.getLogger(LogoUpdateHandler.class);

    /** @scr.reference policy="static" */
    protected JcrResourceResolverFactory resolverFactory;

    public boolean updateCacheEntry(ConfigEntry configEntry, Long lastUpdated, String configCacheRoot, Session admin, Session session) {
        ResourceResolver resolver = resolverFactory.getResourceResolver(admin);
        Resource resource = resolver.getResource(configEntry.getContentPath());

        Image img = new Image(resource);
        img.setItemName(Image.NN_FILE, "image");
        img.setItemName(Image.PN_REFERENCE, "imageReference");
        img.setSelector("img");

        try {
            if(img.getLastModified() == null || lastUpdated < img.getLastModified().getTime().getTime()) {
                String src = img.getSrc();
                String parentPath = configCacheRoot + Text.getRelativeParent(src, 1);

                Node parent = JcrUtil.createPath(parentPath, "sling:Folder", admin);
                Node image = resolver.getResource(resource.getPath() + "/image").adaptTo(Node.class);
                JcrUtil.copy(image, parent, Text.getName(src));

                admin.save();

                return true;
            }
        } catch (RepositoryException e) {
            log.error("Unexpected error while updating logo: ", e);
        }

        return false;
    }
}

この LogoUpdateHandler クラスは、 ContentUpdateHandler インターフェイスの updateCacheEntry(ConfigEntry, Long, String, Session, Session) メソッドを使用します。このメソッドは、次のように多数の引数を取ります。

カスタムハンドラーを実装するには、まず、設定エントリで指定されたリソースに基づいて Image クラスのインスタンスを作成します。 これは、基本的に、ページ上の実際のロゴコンポーネントと同じ手順です。 画像のターゲットパスは、ページから参照されたパスと同じにする必要があります。

次に、前回の更新以降にリソースが変更されたかどうかを確認します。 カスタム実装では、キャッシュの不要な更新を避け、何も変更しない場合は false を返す必要があります。 リソースが変更された場合は、キャッシュのルートを基準とした適切なターゲット位置に画像をコピーします。 最後に true がフレームワークに返され、キャッシュが更新されたことが示されます。

クライアントでのコンテンツの使用 using-the-content-on-the-client

コンテンツ同期で提供されるモバイルアプリでコンテンツを使用するには、HTTP または HTTPS 接続を介してコンテンツをリクエストする必要があります。 その結果、取得したコンテンツ（ZIP ファイルにパック）を抽出し、モバイルデバイス上でローカルに保存することができます。 コンテンツとは、データだけでなくロジック（完全な Web アプリケーション）も指すことに注意してください。これにより、ネットワークに接続していなくても、モバイルユーザは検索したウェブアプリケーション及び対応するデータを実行することができる。

コンテンツ同期は、インテリジェントな方法でコンテンツを提供します。最後に正常にデータ同期が配信されてからのデータ変更のみがおこなわれるので、データ転送に必要な時間が短縮されます。 1970 年 1 月 1 日以降、アプリケーションデータの初回実行時に変更がリクエストされ、その後、前回正常に同期された後に変更されたデータのみがリクエストされます。 AEMは、iOSのクライアント通信フレームワークを利用して、データ通信と転送を簡素化し、iOSベースの Web アプリケーションを有効にするために最小限のネイティブコードが必要になるようにします。

転送されたすべてのデータは同じディレクトリ構造に抽出でき、データを抽出する際に追加の手順（依存関係チェックなど）は必要ありません。 iOSの場合、すべてのデータはiOSアプリの Documents フォルダー内のサブフォルダーに保存されます。

iOSベースのAEM Mobileアプリの一般的な実行パス：

接続を確立できなかった場合は、以前にダウンロードしたデータが表示されます。

その他のリソース additional-resources

管理者および作成者の役割と責任について詳しくは、以下のリソースを参照してください。