モバイルとコンテンツ同期

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

コンテンツ同期フレームワークは、Web コンテンツを格納するアーカイブファイルを作成します。このコンテンツには、シンプルなページのデータ、画像、PDF ファイルまたは Web アプリ全体を含めることができます。コンテンツ同期 API は、モバイルアプリまたはビルドプロセスからアーカイブファイルへのアクセスを提供することで、コンテンツを取得してアプリに追加できるようにします。

次の一連の手順は、コンテンツ同期の一般的な使用例を示しています。

1. AEM 開発者が、追加するコンテンツを指定するコンテンツ同期設定を作成します。
2. コンテンツ同期フレームワークが、コンテンツを収集してキャッシュします。
3. モバイルデバイスで、モバイルアプリケーションが起動され、サーバーからコンテンツを要求します。コンテンツは ZIP ファイルで提供されます。
4. クライアントが、ZIP のコンテンツをローカルファイルシステムに解凍します。ZIP ファイル内のフォルダー構造は、クライアント（ブラウザーなど）が、通常、サーバーから要求するパスをシミュレートします。
5. クライアントが、組み込みのブラウザーでコンテンツを開くか、その他の方法でコンテンツを使用します。
6. クライアントが、更新されたコンテンツを後でサーバーから要求します。コンテンツ同期フレームワークが、ダウンロードのサイズと時間を削減するための増分更新を提供します。これは、帯域幅とデータボリュームが限られているモバイルデバイスで重要になる場合があります。

コンテンツ同期ハンドラーの開発

以下に、コンテンツ同期ハンドラーを開発する際のガイドラインをいくつか示します。

• ハンドラーは、com.day.cq.contentsync.handler.ContentUpdateHandler​を実装する必要があります（直接実装するか、実装するクラスを拡張する）。
• ハンドラーは、com.adobe.cq.mobile.platform.impl.contentsync.handler.AbstractSlingResourceUpdateHandler を拡張できます。
• ハンドラーは、ContentSyncキャッシュを更新した場合にのみtrueを報告する必要があります。 それ以外の場合で true を返すと、実際には更新されていないときでも AEM が更新を作成します。
• ハンドラーは、コンテンツが実際に変更された場合にのみ、キャッシュを更新する必要があります。ホワイトが不要な場合は、キャッシュに書き込まないでください。 これにより、不要な更新が作成されます。

コンテンツ同期のコンテンツの設定

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

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

コンテンツ同期の ZIP ファイルのコンテンツを指定するには、cq:ContentSyncConfig ノードに子ノードを追加します。それぞれの子ノードの次のプロパティによって、追加するコンテンツ項目と追加の際の処理方法が特定されます。

• path：コンテンツの場所。
• type：コンテンツの処理に使用する設定タイプの名前。複数のタイプを使用できます。設定タイプ​の節を参照してください。

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

作成したコンテンツ同期設定はコンテンツ同期コンソールに表示されます。

コンテンツ同期のダウンロードへのアクセスの設定

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

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

コンテンツ同期のダウンロードのデフォルトアクセスの設定

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

Web コンソールを使用してサービスを設定する場合は、ユーザーまたはグループの名前を「許可可能なフォールバックキャッシュ」プロパティの値として入力します。

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

• PID:com.day.cq.contentsync.impl.ContentSyncManagerImpl
• プロパティ名：contentsync.fallback.authorizable

コンテンツ同期キャッシュのダウンロードアクセスの上書き

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

• 名前：authorizable
• タイプ：String
• 値：ダウンロードを行うことのできるユーザーまたはグループの名前

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

cq:ContentSyncConfig ノードに authorizable プロパティがない場合は、Day CQ コンテンツ同期マネージャーサービスの「許可可能なフォールバックキャッシュ」プロパティに設定されているデフォルトのユーザーまたはグループによって、ダウンロードを行うことのできるユーザーが決定されます。

コンテンツ同期キャッシュの更新のためのユーザーの設定

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

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

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

• 名前：updateuser
• 型：String
• 値：更新を実行できるユーザーまたはグループの名前

cq:ContentSyncConfigノードにupdateuserプロパティがない場合、デフォルトのanonymousユーザーがキャッシュを更新します。

設定タイプ

シンプルな JSON のレンダリングからページ（参照先のアセットを含む）の本格的なレンダリングまで、様々な処理が可能です。ここでは、使用可能な設定タイプとそのパラメーターについて説明します。

​​copySimpleにファイルとフォルダーをコピーします。

• path — パスが単一のファイルを指す場合、ファイルのみがコピーされます。フォルダー（ページノードを含む）を指す場合は、その下にあるすべてのファイルとフォルダーがコピーされます。

​​contentRenderコンテンツをレンダリング できます。

• path — 出力するリソースのパス。

• extension — リクエストで使用する拡張機能。一般的な例は ** htmland json​ですが、その他の拡張子も使用できます。

• selector — オプションのセレクター（ドット区切り）。一般的な例としては、 モバイルバージョンのページのレンダリング用のタッチや、JSON出 力用の無限などがあります。

​​clientlibPackage a Javascript or CSS client library.

• path — クライアントライブラリのルートのパス。
• 拡張機能 — クライアントライブラリのタイプ。これは、現時点で、jsor cssに設 定す る必要があります。

アセット

アセットの元のレンディションを収集します。

• path - /content/damの下のアセットフォルダーのパス。

​​imageCollect画像を収集します。

• path — 画像リソースのパス。

image タイプは、zip ファイルに We.Retail ロゴを追加するために使用します。

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

• path - ページのパス。

• extension — リクエストで使用する拡張機能。ページの場合、これはほとんど常に htmlです​が、他のページも引き続き使用できます。

• selector — オプションのセレクター（ドット区切り）。一般的な例として、ペ ** ージのモバイルバージョンのレンダリング用のタッチがあります。

• deep — 子ページも含める必要があるかどうかを指定する、オプションのブール型プロパティ。デフォルト値はtrue です。

• includeImages - 画像を含める必要があるかどうかを指定する、オプションンのブールプロパティ。デフォルト値は true です。

  デフォルトでは、リソースタイプが foundation/components/image の画像コンポーネントだけが追加の対象になります。Web コンソールで Day CQ WCM Pages Update Handler を設定することで、その他のリソースタイプを追加できます。

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

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

rewrite ノードには、次に示す 1 つ以上のプロパティを指定できます。

• clientlibs:clientlibsのパスを書き換えます。

• images:画像のパスを書き換えます。

• links:リンクのパスを書き換えます。

各プロパティには、次のどちらかの値を指定できます。

• REWRITE_RELATIVE：ファイルシステム上のページの .html ファイルを基準とした相対位置を使用してパスを書き換えます。

• REWRITE_EXTERNAL:AEM Externalizerサービスを使用して、サーバー上のリソースを指すことで、パスを書き換えます。

PathRewriterTransformerFactory という名前の AEM サービスを使用すると、書き換える特定の html 属性を設定できます。このサービスはWebコンソールで設定でき、rewriteノードの各プロパティに対して設定を行います。clientlibs、imagesおよびlinks。

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

コンテンツ同期設定の例

コンテンツ同期の設定例を次に示します。

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

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

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

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

設定が完了したらすぐに、ブラウザーまたはその他の任意の HTTP クライアントでコンテンツをダウンロードできます。iOS 用の開発をおこなう場合は、専用の WAppKitSync クライアントライブラリを使用できます。ダウンロード場所は、設定のパスと **.zip 拡張子で構成されます。例えば、ローカル AEM インスタンスを操作する場合は、http://localhost:4502/content/weretail_go.zip です。

コンテンツ同期コンソール

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

• キャッシュの更新
• キャッシュのクリア
• zip 全体のダウンロード
• 現在および特定の日時の差分の zip のダウンロード

このコンソールは開発およびトラブルシューティングの際に役立ちます。

次の URL からコンソールにアクセスできます。

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

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

コンテンツ同期フレームワークの拡張

多数の設定オプションが用意されているとしても、特定の使用例のすべての要件に対応することはできない可能性があります。ここでは、コンテンツ同期フレームワークの拡張ポイントとカスタム設定タイプを作成する方法について説明します。

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

• com.day.cq.contentsync.handler.ContentUpdateHandler - すべての更新ハンドラーが実装する必要のあるインターフェイス
• com.day.cq.contentsync.handler.AbstractSlingResourceUpdateHandler - Sling を使用してリソースのレンダリングを簡略化する抽象クラス

実装したクラスを OSGi コンポーネントファクトリとして登録し、バンドル内の OSGi コンテナにデプロイします。そのためには、JavaDoc タグまたはアノテーションを使用して Maven SCR Plugin を使用します。次の例は、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
}

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

カスタム更新ハンドラーの実装

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

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)メソッドを実装します。このメソッドは、次のように、多数の引数を取ります。

• このハンドラーを呼び出す対象となる、設定エントリへのアクセスを提供する ConfigEntry インスタンスとそのプロパティ。
• 前回のコンテンツ同期によってキャッシュが更新された日時を示す lastUpdated タイムスタンプ。このタイムスタンプ以降に変更されていないコンテンツをハンドラーで更新しないでください。
• キャッシュのルートパスを指定するconfigCacheRoot引数。 更新されたすべてのファイルをzipファイルに追加するには、このパスの下に保存する必要があります。
• すべてのキャッシュ関連リポジトリ操作に使用する必要がある管理セッション。
• 特定のユーザーのコンテキストでコンテンツを更新し、ある種のパーソナライズされたコンテンツを提供するために使用できるユーザーセッション。

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

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

クライアントでのコンテンツの使用

コンテンツ同期が提供するコンテンツをモバイルアプリで使用するには、HTTP または HTTPS 接続を経由してコンテンツを要求する必要があります。その結果、取得したコンテンツ（ZIP ファイルにパッケージ化されます）がモバイルデバイスのローカルに解凍および格納されます。コンテンツは、データだけでなくロジック（つまり、完全な Web アプリケーション）も参照します。これにより、ネットワークに接続されていない場合でも、取得した Web アプリケーションと対応するデータをモバイルユーザーが実行できるようになります。

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

転送されたデータはすべて同じディレクトリ構造に解凍できます。データの解凍時に追加の手順（依存関係の確認など）を行う必要はありません。iOS では、すべてのデータが iOS アプリの Documents フォルダー内のサブフォルダーに格納されます。

iOS ベースの AEM モバイルアプリの一般的な実行パスは次のとおりです。

• ユーザーが iOS デバイスでアプリを起動します。
• アプリが AEM バックエンドへの接続を試行して、前回の実行時以降のデータの変更を要求します。
• サーバーが対応するデータを取得して、zip ファイルに圧縮します。
• データがクライアントデバイスに返されて、Documents フォルダーに解凍されます。
• UIWebView コンポーネントが起動／更新されます。

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

その他のリソース

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

• AEM Mobile On-demand Services の AEM コンテンツのオーサリング
• AEM Mobile On-demand Services を使用するためのコンテンツの管理