Adobe Experience Manager からのアセットのダウンロード download-assets-from-aem

バージョン
記事リンク
AEM 6.5
ここをクリックしてください
AEM as a Cloud Service
この記事

静的レンディションおよび動的レンディションを含むアセットをダウンロードできます。または、アセットへのリンクを含むメールを Adobe Experience Manager Assets から直接送信できます。ダウンロードされたアセットは、ZIP ファイルにバンドルされています。

画像セット、スピンセット、混合メディアセット、カルーセルセットの各アセットタイプはダウンロードできません。

次の方法を使用すると、Experience Manager からアセットをダウンロードできます。

Experience Manager インターフェイスを使用したアセットのダウンロード download-assets

Experience Manager では、アセットの量とサイズに基づいてダウンロードエクスペリエンスを最適化します。サイズの小さいファイルはユーザーインターフェイスからリアルタイムでダウンロードされます。Experience Manager では、単一のアセットを ZIP アーカイブに格納するのではなく、元のファイルの単一のアセットリクエストを直接ダウンロードして、ダウンロードを高速化します。Experience Manager では、非同期リクエストによる大規模なダウンロードをサポートしています。100 GB を超えるダウンロードリクエストは、それぞれ最大 100 MB の複数の ZIP アーカイブに分割されます。

デフォルトでは、Experience Manager は、ダウンロードアーカイブの生成時に Experience Manager インボックスで通知をトリガーします。

インボックス通知

大量のダウンロードに対するメール通知を有効にする enable-emails-for-large-downloads

非同期ダウンロードは、次のいずれかの場合にトリガーされます。

  • 10 個を超えるアセットがある場合
  • ダウンロードサイズが 100 MB を超える場合
  • ダウンロードの準備に 30 秒以上かかる場合

非同期ダウンロードがバックエンドで実行される間、ユーザーは Experience Manager で調査を続行し、さらに作業できます。Experience Manager のインボックス通知に加えて、Experience Manager ではメールを送信して、ダウンロードプロセスの完了時にユーザーに通知することができます。この機能を有効にするために、管理者は SMTP サーバー接続を設定することにより、メールサービスを設定できます。

メールサービスを設定すると、管理者とユーザーは、Experience Manager インターフェイスからメール通知を行えます。

メール通知を有効にする手順は次のとおりです。

  1. Experience Manager Assets にログインします。

  2. 右上隅のユーザーアイコンをクリックし、「環境設定」をクリックして ユーザーの環境設定ウィンドウを開きます。

  3. アセットのダウンロードのメール通知」チェックボックスをオンにして、「確定」をクリックします。

    enable-email-notifications-for-large-downloads

アセットをダウンロードするには、次の手順に従います。

  1. Experience Manager ユーザーインターフェイスで、アセットファイル ​をクリックします。

  2. ダウンロードするアセットに移動します。フォルダーを選択するか、フォルダー内の 1 つ以上のアセットを選択します。ツールバーの「ダウンロード」をクリックします。

    からアセットをダウンロードする際に使用できるオプションExperience Manager Assets

  3. ダウンロードダイアログボックスで、目的のダウンロードオプションを選択します。

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
    ダウンロードオプション 説明
    アセットごとに別のフォルダーを作成 このオプションを選択すると、アセットのダウンロード済みレンディションをすべて含むフォルダーをアセットごとに作成できます。このオプションを選択しない場合、各アセット(ダウンロード用に選択した場合はそのレンディションも含む)は、生成されたアーカイブの親フォルダーに格納されます。
    メール

    (ダウンロードへのリンクを含む)メール通知を別のユーザーに送信する場合は、このオプションを選択します。受信者ユーザーは dam-users グループのメンバーである必要があります。次の場所にある標準のメールテンプレートを利用できます。

    • /libs/settings/dam/workflow/notification/email/downloadasset
    • /libs/settings/dam/workflow/notification/email/transientworkflowcompleted

    デプロイメント時にカスタマイズしたテンプレートは、次の場所で利用できます。

    • /apps/settings/dam/workflow/notification/email/downloadasset
    • /apps/settings/dam/workflow/notification/email/transientworkflowcompleted

    テナント固有のカスタムテンプレートは、次の場所に保存できます。

    • /conf/<tenant_specific_config_root>/settings/dam/workflow/notification/email/downloadasset
    • /conf/<tenant_specific_config_root>/settings/dam/workflow/notification/email/transientworkflowcompleted
    アセット このオプションを選択すると、アセットを元の形式でダウンロードできます。
    オリジナルアセットにサブアセットがある場合は、サブアセットオプションを使用できます。
    レンディション レンディションは、アセットのバイナリ表現です。アセットには、アップロードされたファイルの一次表現が含まれます。アセットは任意の数の追加の表現を持つことができます。
    このオプションを選択すると、ダウンロードするレンディションを選択できます。使用できるレンディションは、選択したアセットによって異なります。
    スマート切り抜き このオプションを選択すると、選択したアセットのすべてのスマート切り抜きレンディションが Adobe Experience Manager 内からダウンロードされます。スマート切り抜きレンディションを含む zip ファイルが作成され、ローカルコンピューターにダウンロードされます。
    動的レンディション 一連の代替レンディションをリアルタイムで生成するには、このオプションを選択します。また、このオプションを選択すると、動的に作成するレンディションを画像プリセットリストから選択します。
    さらに、サイズ、測定単位、形式、カラースペース、解像度および、画像の反転用などのオプションの画像修飾子を選択できます。このオプションは、Dynamic Media を有効にしている場合にのみ使用できます。
  4. ダイアログボックスで、「ダウンロード」をクリックします。

    大量のダウンロードに対するメール通知が有効になっている場合は、アーカイブされた zip フォルダーのダウンロード URL を記載したメールがインボックスに表示されます。メールのダウンロードリンクをクリックして、zip アーカイブをダウンロードします。

    email-notifications-for-large-downloads

    また、Experience Manager インボックスで通知を表示することもできます。

    inbox-notifications-for-large-downloads

リンクを使用したアセットの共有は、関心のあるユーザーが Assets にログインしなくてもアセットを利用できるようにするための便利な方法です。リンク共有機能を参照してください。

ユーザーが共有リンクからアセットをダウンロードする場合、Assets では、高速で途切れないダウンロードを可能にする非同期サービスを使用します。ダウンロードされるアセットは、バックグラウンドで、扱いやすいファイルサイズの ZIP アーカイブにまとめられてインボックスのキューに入れられます。大容量のダウンロードの場合、ダウンロードは 100 GB のファイルに分割されます。

ダウンロードインボックスには、各アーカイブの処理ステータスが表示されます。処理が完了したら、インボックスからアーカイブをダウンロードできます。

ダウンロードインボックス

アセットダウンロードサーブレットの有効化 enable-asset-download-servlet

Experience Manager のデフォルトサーブレットを使用すると、認証済みユーザーは、任意の大きさの同時ダウンロードリクエストを発行してアセットの ZIP ファイルを作成することができます。ダウンロードの準備でパフォーマンスに影響が及ぶ場合や、サーバーやネットワークに過重な負荷がかかる場合があります。この機能で生じる可能性がある DoS に似たリスクを軽減するため、パブリッシュインスタンスに対して AssetDownloadServlet OSGi コンポーネントが無効になっています。オーサーインスタンスでダウンロード機能が必要ない場合は、オーサーインスタンスでサーブレットを無効にします。

例えば Asset Share Commons やポータルのような実装などを使用する場合に DAM からアセットをダウンロードできるようにするには、OSGi 設定を通じてサーブレットを手動で有効にします。日常的なダウンロードの要件に影響を与えない範囲で、許容ダウンロードサイズをできるだけ小さく設定することをお勧めします。この値を大きくすれば、パフォーマンスに影響を与える可能性があります。

  1. 次のように、パブリッシュ実行モードを対象とする命名規則(config.publish)でフォルダーを作成します。

    /apps/<your-app-name>/config.publish

  2. config フォルダーに、nt:file タイプのファイル com.day.cq.dam.core.impl.servlet.AssetDownloadServlet.config を作成します。

  3. com.day.cq.dam.core.impl.servlet.AssetDownloadServlet.config に以下を入力します。ダウンロードの最大サイズ(バイト単位)を asset.download.prezip.maxcontentsize の値として設定します。以下のサンプルでは、100 KB を超えないように ZIP ダウンロードの最大サイズを設定しています。

    code language-java
    enabled=B"true"
    asset.download.prezip.maxcontentsize=I"102400"
    

アセットダウンロードサーブレットの無効化 disable-asset-download-servlet

ダウンロード機能が必要ない場合は、サーブレットを無効にして、DoS に似たリスクを回避します。オーサーおよびパブリッシュインスタンスの Asset Download Servlet を無効にするには、アセットダウンロードリクエストをすべてブロックするように Dispatcher 設定をアップデートします。Experience Managerサーブレットは、OSGi コンソールから手動で直接無効にすることもできます。

  1. Dispatcher 設定を通じてアセットダウンロード要求をブロックするには、dispatcher.any 設定を編集し、フィルターセクションに新しいルールを追加します。

    /0100 { /type "deny" /url "*.assetdownload.zip/assets.zip*" }

OnTime または OffTime レンディション on-off-time-rendition

を有効にするには、以下を実行します。 OnOffTimeAssetAccessFilter サービスの場合は、OSGi 設定を作成する必要があります。 このサービスを使用すると、オン/オフタイム設定に基づいて、アセット自体に加えて、レンディションやメタデータへのアクセスをブロックできます。 OSGi 設定の対象は次のとおりです。 com.day.cq.dam.core.impl.servlet.OnOffTimeAssetAccessFilter. 次の手順に従います。

  1. Git のプロジェクトコードで、設定ファイルを次の場所に作成します。 /apps/system/config/com.day.cq.dam.core.impl.servlet.OnOffTimeAssetAccessFilter.cfg.json. ファイルにはが含まれている必要があります {} をコンテンツとして指定し、対応する OSGi コンポーネントの空の OSGi 設定を示します。 このアクションを実行すると、サービスが有効になります。
  2. この新しい設定を含むコードを、 Cloud Manager.
  3. デプロイすると、アセットのオン/オフタイム設定に従ってレンディションとメタデータにアクセスできるようになります。 現在の日時がオンタイムより前またはオフタイムより後の場合は、エラーメッセージが表示されます。
    空の OSGi 設定の追加について詳しくは、このガイドを参照してください。

ヒントと制限事項 tips-limitations

  • 空のフォルダーをダウンロードすると、 Experience Manager は、ZIP アーカイブの作成に関する成功メッセージを伝えますが、アーカイブは作成されません。

関連情報

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab