アセットマイクロサービスと処理プロファイルの使用 get-started-using-asset-microservices

アセットマイクロサービスは、クラウドネイティブアプリケーション(「ワーカー」とも呼ばれる)を使用して、アセットの拡張性と回復性の高い処理を実現します。アドビは、様々なアセットタイプや処理オプションを最適に処理するためのサービスを管理します。

アセットマイクロサービスを使用すると、以前のバージョンの Experience Manager よりも多くの形式をカバーする様々なファイルタイプを追加設定なしで処理できます。例えば、PSD 形式と PSB 形式のサムネール抽出ができるようになりましたが、以前は ImageMagick などのサードパーティソリューションが必要でした。

アセットの処理は、処理プロファイル ​の設定に応じて異なります。Experience Manager には基本的な初期設定が用意されており、管理者は特定のアセット処理設定を追加できます。管理者は、オプションのカスタマイズを含む、後処理ワークフローの設定を作成および管理できます。ワークフローのカスタマイズを使用すると、デベロッパーはデフォルトのオファーを拡張できます。

アセット処理の概要

NOTE
ここで説明するアセット処理は、以前のバージョンの Experience Manager に存在する DAM Update Asset ワークフローモデルに代わるものです。標準的なレンディション生成とメタデータ関連のステップのほとんどは、アセットマイクロサービスの処理に置き換わり、残りのステップは後処理ワークフロー設定に置き換えることができます。

アセット処理オプションについて get-started

Experience Manager では、次のレベルの処理が可能です。

オプション
説明
対象となる使用例
デフォルト設定
現在の状態で使用可能で、変更できません。この設定は、非常に基本的なレンディション生成機能を提供します。
  • Assets ユーザーインターフェイスで使用される標準サムネール(48、140、319 ピクセル)
  • 大きなプレビュー(Web レンディション - 1280 ピクセル)
  • メタデータとテキストの抽出。
カスタム設定
ユーザーインターフェイスを介して管理者が設定します。デフォルトのオプションを拡張して、レンディションの生成に関するさらなるオプションを提供します。標準搭載のオプションを拡張して、様々な形式とレンディションを提供します。
  • FPO レンディション。
  • 画像のファイル形式と解像度の変更
  • 条件に応じて、設定したファイルタイプに適用します。
カスタムプロファイル
カスタムアプリケーションを介してカスタムコードを使用し、アセット計算サービスを呼び出すように、ユーザーインターフェイスを介して管理者が設定します。クラウド固有の拡張性の高い方法で、より複雑な要件をサポートします。
可能な使用例」を参照してください。

サポートされているファイル形式 supported-file-formats

アセットマイクロサービスは、様々なファイル形式での処理、レンディションの生成、メタデータの抽出をサポートしています。MIME 型の完全なリストと各型でサポートされる機能については、「サポートされているファイル形式」を参照してください。

デフォルト設定 default-config

一部のデフォルトは、Experience Manager で必要なデフォルトのレンディションを使用できるように事前に設定されています。また、デフォルト設定は、メタデータ抽出およびテキスト抽出操作も使用できるようになっています。ユーザーはアセットのアップロードや更新を直ちに開始でき、基本的な処理がデフォルトで利用可能です。

デフォルト設定では、最も基本的な処理プロファイルのみが設定されています。このような処理プロファイルはユーザーインターフェイスに表示されず、変更することはできません。アップロードされたアセットは常に処理されます。このようなデフォルトの処理プロファイルを使用すると、Experience Manager で必要なあらゆる基本処理をすべてのアセットに対して実行できます。

標準設定 standard-config

Experience Manager には、ユーザーのニーズに応じて、一般的な形式向けのより具体的なレンディションを生成する機能があります。管理者は、追加の処理プロファイルを作成して、そのようなレンディションの作成を容易にできます。ユーザーは、使用可能な 1 つ以上のプロファイルを特定のフォルダーに割り当てて、追加の処理を完了することができます。例えば、追加の処理で Web、モバイル、タブレット用のレンディションを生成できるとします。次のビデオでは、処理プロファイルの作成および適用方法と、作成したレンディションへのアクセス方法を示しています。

  • レンディションの幅と高さ:レンディションの幅と高さの仕様には、生成される出力画像の最大サイズを指定します。アセットマイクロサービスでは、レンディションの幅と高さがそれぞれ指定の幅と高さを超えない範囲で、可能な限り大きなレンディションを生成しようとします。縦横比は維持され、元の縦横比と同じになります。値が空の場合は、アセット処理で元の画像のピクセルサイズを前提とすることになります。

  • MIME タイプ包括ルール:特定の MIME タイプのアセットが処理される際は、まず、その MIME タイプがレンディション仕様の除外 MIME タイプの値と照合されます。そのリストと一致する場合、この特定のレンディションはアセットに対して生成されません(ブロックリスト)。それ以外の場合は、MIME タイプが包含 MIME タイプと照合され、リストと一致する場合は、そのレンディションが生成されます(許可リスト)。

  • 特殊 FPO レンディション:クリエイティブ作業でサイズの大きいアセットを Experience Manager から Adobe InDesign ドキュメントに配置する際、アセットを配置した後、かなりの時間を待つ必要があります。その間ユーザーは InDesign の使用をブロックされます。これにより、クリエイティブの流れが中断され、ユーザーエクスペリエンスに悪影響が出ます。InDesign ドキュメントでは、最初に小さいサイズのレンディションを一時的に配置して、後からオンデマンドでフル解像度のアセットに置き換えることができます。Experience Manager には、配置専用(FPO)のレンディションが用意されています。これらの FPO レンディションは、ファイルサイズは小さいですが、縦横比は同じです。

処理プロファイルには、FPO(配置専用)レンディションを含めることができます。これを処理プロファイルで有効にする必要がある場合は、 Adobe Asset Link ドキュメントを参照してください。詳しくは、 Adobe Asset Link の完全なドキュメント を参照してください。

標準プロファイルの作成 create-standard-profile

標準の処理プロファイルを作成するには、次の手順に従います。

  1. 管理者は、ツールアセット処理プロファイル ​にアクセスします。「作成」をクリックします。

  2. フォルダーに適用する際に、プロファイルを一意に識別するのに役立つ名前を指定します。

  3. FPO レンディションを生成するには、「画像」タブで「FPO レンディションを作成」を有効にします。品質 ​の値を 1~100 で入力します。

  4. 他のレンディションを生成するには、「新規追加」をクリックし、次の情報を入力します。

    • 各レンディションのファイル名。
    • 各レンディションのファイル形式(PNG、JPEG、GIF、WebP)。
    • 各レンディションの幅と高さ(ピクセル単位)。指定しなかった場合は、元の画像の最大ピクセルサイズが使用されます。
    • 各 JPEG および WebP レンディションの画質(パーセント単位)。
    • プロファイルの適用性を定義する、包含および除外 MIME タイプ。

    processing-profiles-adding

  5. 保存」をクリックします。

カスタムプロファイルと使用例 custom-config

Asset Compute Service は、デフォルト処理、Photoshop ファイルなどのアドビ固有の形式の処理、カスタム処理や組織固有の処理など、様々なユースケースをサポートしています。以前に必要だった DAM アップデートアセットワークフローのカスタマイズは、自動的に処理されるか、処理プロファイルの設定を介して処理されます。これらの処理オプションでビジネスニーズが満たされない場合、デフォルトの機能を拡張するために Asset Compute Service を開発および使用することを推奨します。概要については、「拡張機能と使用するタイミングについて」を参照してください。

NOTE
デフォルトの設定または標準のプロファイルを使用してビジネス要件を満たすことができない場合にのみ、カスタムアプリケーションの使用をお勧めします。

画像、ビデオ、ドキュメントおよびその他のファイル形式を、サムネール、抽出したテキストおよびメタデータ、アーカイブなど、様々なレンディションに変換できます。

デベロッパーは、Asset Compute Service を使用して、サポートされる使用例に応じたカスタムアプリケーションを作成できます。Experience Managerは、管理者が設定したカスタムプロファイルを使用して、これらのカスタムアプリケーションをユーザーインターフェイスから呼び出すことができます。Asset Compute Service は、外部サービスを呼び出す次の使用例をサポートしています。

  • Adobe Photoshop の ImageCutout API を使用して、結果をレンディションとして保存します。
  • サードパーティシステムを呼び出して、PIM システムなどのデータをアップデートします。
  • Photoshop API を使用して、Photoshop テンプレートに基づいて様々なレンディションを生成します。
  • Adobe Lightroom API を使用して、取得したアセットを最適化し、レンディションとして保存します。
NOTE
標準メタデータは、カスタムアプリケーションを使用して編集することはできません。変更できるのは、カスタムメタデータのみです。

カスタムプロファイルの作成 create-custom-profile

カスタムプロファイルを作成するには、次の手順に従います。

  1. 管理者は、ツールアセット処理プロファイル ​にアクセスします。「作成」をクリックします。

  2. カスタム」タブをクリックします。「新規追加」をクリックします。レンディションの目的のファイル名を指定します。

  3. 以下の情報を入力します。

    保存」をクリックします。

カスタムアプリケーションは、ヘッドレスな Project App Builder アプリです。処理プロファイルが設定されている場合、カスタムアプリケーションは指定されたすべてのファイルを取得します。アプリケーションは、ファイルをフィルタリングする必要があります。

CAUTION
App Builder アプリと Experience Manager アカウントが同じ組織に属していない場合、統合は機能しません。

カスタムプロファイルの例 custom-profile-example

カスタムプロファイルの使用方法を説明するために、キャンペーン画像にカスタムテキストを適用するユースケースを考えてみましょう。Photoshop API を使用して画像を編集する処理プロファイルを作成できます。

アセット計算サービスの統合により、Experience Manager は、「サービスパラメーター」フィールドを使用して、これらのパラメーターをカスタムアプリケーションに渡すことができます。次に、カスタムアプリケーションが Photoshop API を呼び出し、これらの値を API に渡します。例えば、フォント名、テキストカラー、テキスト重み付け、テキストサイズを渡して、カスタムテキストをキャンペーン画像に追加できます。

カスタム処理プロファイル

図:「サービスパラメーター」フィールドを使用して、カスタムアプリケーションに組み込む事前定義済みのパラメーターに追加情報を渡します。この例では、キャンペーン画像がアップロードされると、画像は Arial-BoldMT フォントの Jumanji テキストで更新されます。

処理プロファイルを使用したアセットの処理 use-profiles

追加のカスタム処理プロファイルを作成し、Experience Manager の特定のフォルダーに適用して、これらのフォルダーにアップロードまたは更新されたアセットを処理します。デフォルトの組み込み標準処理プロファイルは常に実行されますが、ユーザーインターフェイスには表示されません。カスタムアセットを追加する場合、プロファイルされたアセットは両方のプロファイルを使用して処理されます。

次のいずれかの方法を使用して、処理プロファイルをフォルダーに適用します。

  • 管理者は、ツールアセット処理プロファイル ​で処理プロファイルの定義を選択し、「プロファイルをフォルダーに適用」アクションを使用できます。コンテンツブラウザーが開き、そこで特定のフォルダーに移動したり、フォルダーを選択したり、プロファイルの適用を確定したりできます。

  • Assets ユーザーインターフェイスでフォルダーを選択し、「プロパティ」アクションを使用してフォルダーのプロパティ画面を開き、「アセット処理」タブをクリックし、 処理プロファイル リストでそのフォルダーに適した処理プロファイルを選択します。変更を保存するには、「保存して閉じる」をクリックします。
    「アセットのプロパティ」タブからのフォルダーへの処理プロファイルの適用

  • Assets ユーザーインターフェイスでフォルダーまたは特定のアセットを選択して処理プロファイルを適用し、上部にあるオプションから アセット再処理アイコン アセットを再処理」オプションを選択できます。

TIP
1 つのフォルダーに適用できる処理プロファイルは 1 つだけです。さらにレンディションを生成するには、既存の処理プロファイルにレンディションの定義を追加します。

処理プロファイルがフォルダーに適用されると、このフォルダーまたはその任意のサブフォルダー内でアップロード(または更新)された新しいアセットはすべて、設定された追加の処理プロファイルを使用して処理されます。この処理は、標準のデフォルトプロファイルによる処理に加えて行われます。

NOTE
フォルダーに適用された処理プロファイルはツリー全体で機能しますが、サブフォルダーに適用された別のプロファイルでオーバーライドすることができます。アセットがフォルダーにアップロードされると、Adobe Experience Manager は、そのフォルダーのプロパティで処理プロファイルを確認します。何も適用されない場合は、適用する処理プロファイルが階層内の親フォルダーで確認されます。

アセットが処理されていることを確認するには、生成されたレンディションを左側のパネルのレンディションビューでプレビューします。アセットプレビューを開き、左のパネルを開いて​ レンディション ​ビューにアクセスします。特定のアセットのタイプが MIME タイプ包含ルールと一致する処理プロファイルの特定のレンディションが表示され、アクセス可能になります。

追加レンディション

図:親フォルダーに適用された処理プロファイルで生成された 2 つの追加レンディションの例.

後処理ワークフロー post-processing-workflows

処理プロファイルを使用して実現できない追加のアセット処理が必要な状況では、追加の後処理ワークフローを設定に追加できます。後処理では、アセットマイクロサービスを使用して、設定可能な処理の上に、完全にカスタマイズされた処理を追加できます。

ワークフローの後処理、または自動スタートワークフロー(設定されている場合)は、マイクロサービスの処理が完了した後に、Experience Manager によって自動的に実行されます。ワークフローランチャーを手動で追加してワークフローをトリガーする必要はありません。次に例を示します。

  • アセットを処理するためのカスタムワークフロー手順。
  • 外部システムから提供されるアセット(製品やプロセスの情報など)にメタデータやプロパティを追加するための統合機能。
  • 外部サービスによる追加処理。

後処理ワークフロー設定を Experience Manager に追加するには、次の手順に従います。

  • 1 つ以上のワークフローモデルを作成します。このドキュメントでは、これらのカスタムモデルを​ 後処理ワークフローモデル ​と呼びます。これらは、通常の Experience Manager ワークフローモデルです。
  • 必要なワークフローステップをこれらのモデルに追加します。デフォルトワークフローのステップを確認し、必要なデフォルトステップをすべてカスタムワークフローに追加します。ステップは、ワークフローモデルの設定に基づいてアセットに対して実行されます。例えば、アセットのアップロード時に自動的にスマートタグ付けを実行する場合は、そのステップをカスタムの後処理ワークフローモデルに追加します。
  • DAM アセットの更新ワークフロー完了プロセスステップを最後に追加します。この手順を追加すると、Experience Manager がいつ処理が終了したかを把握して、アセットを処理済みとしてマークできるので、アセットに​ 新規 ​が表示されます。
  • Custom Workflow Runner サービスの設定を作成すると、パス(フォルダーの場所)または正規表現で後処理ワークフローモデルの実行を設定できます。

後処理ワークフローで使用できる標準ワークフローステップについて詳しくは、開発者向けリファレンスの後処理ワークフローのワークフローステップを参照してください。

後処理ワークフローモデルの作成 create-post-processing-workflow-models

後処理ワークフローモデルは、通常の Experience Manager ワークフローモデルです。リポジトリーの場所やアセットタイプごとに異なる処理が必要な場合は、異なるモデルを作成します。

必要に応じて処理手順を追加します。サポートされているステップのほか、カスタム実装されたワークフローステップも使用できます。

各後処理ワークフローの最後の手順が DAM Update Asset Workflow Completed Process であることを確認します。最後の手順は、アセットの処理が完了したことを Experience Manager が確実に把握できるようにするのに役立ちます。

後処理ワークフローの実行の設定 configure-post-processing-workflow-execution

アセットマイクロサービスがアップロードされたアセットの処理を完了したら、後処理ワークフローを定義して、アセットをさらに処理できます。ワークフローモデルを使用して後処理を設定するには、次のいずれかを実行します。

フォルダーにワークフローモデルを適用する apply-workflow-model-to-folder

一般的な後処理のユースケースでは、メソッドを使用してワークフローをフォルダーに適用することを検討してください。フォルダーのプロパティにワークフローモデルを適用するには、次の手順に従います。

  1. ワークフローモデルを作成します。

  2. フォルダーを選択し、ツールバーの「プロパティ」をクリックして、「アセット処理」タブをクリックします。

  3. 自動開始ワークフロー」で、必要なワークフローを選択し、ワークフローのタイトルを指定して、変更を保存します。

    後処理ワークフローをフォルダのプロパティに適用する

Custom Workflow Runner サービスの設定 configure-custom-workflow-runner-service

フォルダーにワークフローを適用することでは実現できない高度な設定に対しては、Custom Workflow Runner サービスを設定できます。例えば、正規表現を使用するワークフローなどです。Adobe CQ DAM Custom Workflow Runner(com.adobe.cq.dam.processor.nui.impl.workflow.CustomDamWorkflowRunnerImpl)は OSGi サービスです。設定には、次の 2 つのオプションが用意されています。

  • パスによる後処理ワークフローの設定(postProcWorkflowsByPath):異なるリポジトリーパスに基づいて、複数のワークフローモデルをリストアップできます。コロンを使用してパスとモデルを区切ります。単純なリポジトリーパスがサポートされています。これらを /var パスのワークフローモデルにマッピングします。例:/content/dam/my-brand:/var/workflow/models/my-workflow
  • 式による後処理ワークフローの設定(postProcWorkflowsByExpression):異なる正規表現に基づいて、複数のワークフローモデルをリストアップできます。式とモデルはコロンで区切る必要があります。正規表現は、レンディションやファイルの 1 つではなく、アセットノードを直接指すものでなければなりません。例:/content/dam(/.*/)(marketing/seasonal)(/.*):/var/workflow/models/my-workflow

OSGi 設定のデプロイ方法については、 Experience Managerへのデプロイを参照してください。

ワークフローの後処理の実行を無効にする

後処理が必要ない場合は、自動開始ワークフロー ​選択で、「空の」ワークフローモデルを作成して使用します。

無効な自動開始ワークフローモデルの作成
  1. ツール/ワークフロー/モデル ​に移動します。

  2. 上部のアクションバーから、作成/モデルを作成 ​を選択します。

  3. 新しいワークフローモデルのタイトルと名前を指定します。例:

    • タイトル:自動開始ワークフローを無効にする
    • 名前:disable-auto-start-workflow
  4. 完了」を選択して、ワークフローモデルを作成します。

  5. 作成したワークフローモデルを​ 選択 ​して​ 編集 ​します。

  6. ワークフローモデルエディターで、モデル定義から「ステップ 1」を選択して削除します。

  7. サイドパネル ​を開き、「ステップ」を選択します。

  8. DAM アセットの更新ワークフローの完了」ステップをモデル定義にドラッグします。

  9. ページ情報」ボタン(サイドパネル ​切り替えスイッチの横)を選択し、「プロパティを開く」を選択します。

  10. 基本」タブで、「一時的なワークフロー」を選択します。

  11. 上部のアクションバーから「保存して閉じる」を選択します。

  12. 上部のアクションバーから「同期」を選択します。

  13. ワークフローモデルエディターを閉じます。

無効な自動開始ワークフローモデルの適用

フォルダー用の​ 自動開始ワークフロー ​はアセットの後処理を必要としないので、フォルダーにワークフローモデルを適用するで説明した手順に従い、自動開始ワークフローを無効にする ​を設定します。

ベストプラクティスと制限事項 best-practices-limitations-tips

  • ワークフローを設計する際には、あらゆる種類のレンディションに対するニーズを考慮します。レンディションが今後必要になることが予測されない場合は、ワークフローからレンディションの作成ステップを削除します。以後、レンディションは一括削除できません。Experience Manager を長時間使用した後、不要なレンディションで大量のストレージ領域が占有される場合があります。個々のアセットについては、ユーザーインターフェイスからレンディションを手動で削除できます。複数のアセットについては、特定のレンディションを削除するように Experience Manager をカスタマイズすることもできますし、アセットを削除して再びアップロードすることもできます。
  • 現在、サポートはレンディションの生成に限られています。新しいアセットの生成はサポートされていません。
  • 現在、メタデータ抽出のファイルサイズの上限は約 15 GB です。非常に大きなアセットをアップロードする場合は、メタデータの抽出操作に失敗することがあります。

関連情報

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