Show Menu
トピック×

アセットマイクロサービスと処理プロファイルの使用

アセットマイクロサービスは、クラウドネイティブアプリケーション(「ワーカー」とも呼ばれる)を使用して、アセットの拡張性と回復性の高い処理を実現します。 アドビは、様々なアセットタイプや処理オプションを最適に処理するためのサービスを管理します。
Asset microservices lets you process a broad range of file types covering more formats out-of-the-box than what is possible with previous versions of Experience Manager. 例えば、以前は ImageMagick などのサードパーティソリューションが必要だった PSD 形式と PSB 形式を、サムネール抽出できるようになりました。
アセットの処理は、 処理プロファイルの設定に応じて異なります 。 Experience Managerには基本的な初期設定が用意されており、管理者は特定のアセット処理設定を追加できます。 管理者は、オプションのカスタマイズを含む後処理ワークフローの設定を作成、管理および変更します。 ワークフローのカスタマイズを使用すると、開発者はデフォルトのオファーを拡張できます。

アセット処理の高レベル表示

The asset processing described here replaces the DAM Update Asset workflow model that exists in the previous versions of Experience Manager. 標準的なレンディション生成とメタデータ関連のステップのほとんどは、アセットマイクロサービスの処理に置き換わり、残りのステップは後処理ワークフロー設定に置き換えることができます。

アセット処理オプションの理解

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

サポートされているファイル形式

Asset Microservicesは、メタデータの処理、レンディションの生成、抽出を行うための様々なファイル形式をサポートしています。 MIME型の完全なリストと各型でサポートされる機能については、 サポートされるファイル形式 (英語のみ)を参照してください。

デフォルト設定

一部の初期設定は、Experience Managerで必要なデフォルトのレンディションを使用できるように事前に設定されています。 また、デフォルトの設定では、メタデータ抽出とテキスト抽出の操作も確実に行えます。 ユーザーはアセットのアップロードや更新を直ちに開始でき、基本的な処理がデフォルトで利用可能です。
デフォルト設定では、最も基本的な処理プロファイルのみが設定されます。 このような処理プロファイルは、ユーザーインターフェイスに表示されず、変更することはできません。 アップロードされたアセットは常に処理されます。Such a default processing profile ensures that the basic processing required by Experience Manager is completed on all assets.

標準設定

Experience Manager には、ユーザーのニーズに応じて、一般的な形式向けのより具体的なレンディションを生成する機能があります。 管理者は、追加の 処理プロファイルを作成して 、そのようなレンディションの作成を容易にできます。 次に、1つ以上の使用可能なプロファイルを特定のフォルダーに割り当て、追加の処理を行います。 例えば、追加の処理でWeb、モバイル、タブレット用のレンディションを生成できるとします。 次のビデオでは、処理プロファイルの作成および適用方法と、作成したレンディションへのアクセス方法を示しています。
  • レンディションの幅と高さ :「レンディションの幅」と「高さ」の指定では、生成される出力画像の最大サイズが指定されます。 Asset Microservicesは、可能な限り大きいレンディションを生成しようとします。このレンディションの幅と高さは、それぞれ指定された幅と高さ以下です。 縦横比は維持され、元の縦横比と同じになります。値が空の場合は、アセット処理で元の画像のピクセルサイズを前提とすることになります。
  • MIMEタイプインクルージョンルール :特定のMIMEタイプを持つアセットが処理される場合、最初に、MIMEタイプがレンディション仕様の除外されたMIMEタイプ値と比較されます。 そのリストと一致する場合、この特定のレンディションはアセットに対して生成されません(ブロックリスト)。それ以外の場合は、MIME タイプが包含 MIME タイプと照合され、リストと一致する場合は、そのレンディションが生成されます(許可リスト)。
  • Special FPO rendition :クリエイティブプロフェッショナルは、サイズの大きいアセットをから Experience Manager ドキュメントに配置する際、アセットを Adobe InDesign 配置した後、かなりの時間待ちます placing-graphics.html 。 Meanwhile, the user is blocked from using InDesign. これにより、クリエイティブの流れが中断され、ユーザーエクスペリエンスに悪影響が出ます。Adobe enables temporarily placing small-sized renditions in InDesign documents to begin with, which can be replaced with full-resolution assets on-demand later. Experience Manager には、配置専用(FPO)のレンディションが用意されています。これらの FPO レンディションは、ファイルサイズは小さいですが、縦横比は同じです。
処理プロファイルには、FPO(配置専用)レンディションを含めることができます。これを処理プロファイルで有効にする必要がある場合は、 のAdobe Asset Link​ ドキュメント を参照してください。詳しくは、 Adobe Asset Link の完全なドキュメント を参照してください。

標準プロファイルの作成

標準の処理プロファイルを作成するには、次の手順に従います。
  1. 管理者は、 ツール / アセット / 処理プロファイルにアクセスします 。 「 作成 」をクリックします。
  2. フォルダーに適用する際に、プロファイルを一意に識別するのに役立つ名前を指定します。
  3. FPOレンディションを生成するには、「 標準 」タブで「FPOレンディションを 作成 」を有効にします。 1 ~ 100の 画質 (Quality)値を入力します。
  4. 他のレンディションを生成するには、「 追加New 」をクリックし、次の情報を入力します。
    • 各レンディションのファイル名。
    • 各レンディションのファイル形式(PNG、JPEGまたはGIF)。
    • 各レンディションの幅と高さ(ピクセル単位) 値を指定しない場合は、元の画像の最大ピクセルサイズが使用されます。
    • 各JPEGレンディションの画質(%)。
    • プロファイルの適用性を定義する、包含および除外 MIME タイプ。
  5. 保存 」をクリックします。

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

は、デフォルト処理、PhotoshopファイルなどのAdobe固有の形式の処理、カスタム処理や組織固有の処理など、様々な使用例を Asset Compute Service サポートしています。 以前に必要だったDAM Update Assetワークフローのカスタマイズは、自動的に処理されるか、処理プロファイルの設定を介して処理されます。 これらの処理オプションでビジネスニーズが満たされない場合、Adobeでは、デフォルトの機能を拡張するために開発および使用す Asset Compute Service ることを推奨します。 概要については、「拡張機能と使用するタイミングにつ いて」を参照してください
Adobeでは、デフォルトの設定または標準のプロファイルを使用してビジネス要件を満たすことができない場合にのみ、カスタムアプリケーションの使用をお勧めします。
画像、ビデオ、ドキュメントおよびその他のファイル形式を、サムネール、抽出したテキストおよびメタデータ、アーカイブなど、様々なレンディションに変換できます。
開発者は、を使用して、サポートされ Asset Compute Service る使用例に応じたカスタムアプリケーションを 作成できます 。 Experience Manager 管理者が設定したカスタムプロファイルを使用して、これらのカスタムアプリケーションをユーザーインターフェイスから呼び出すことができます。 Asset Compute Service は、外部サービスを呼び出す次の使用例をサポートしています。
  • のImageCutout API Adobe Photoshopを使用して、結果をレンディションとして保存します photoshop-api-docs-pre-release#imagecutout
  • サードパーティ製システムを呼び出して、PIMシステムなどのデータを更新します。
  • APIを使用して、Photoshopテンプレートに基づいて様々なレンディションを生成します。 Photoshop
  • AdobeLightroomAPI (API)を使用して、取り込んだアセットを最適化し、レンディションとして保存します。
標準メタデータは、カスタムアプリケーションを使用して編集することはできません。 変更できるのは、カスタムメタデータのみです。

カスタムプロファイルの作成

カスタムプロファイルを作成するには、次の手順に従います。
  1. 管理者は、 ツール/アセット/処理プロファイルにアクセスします 。 「 作成 」をクリックします。
  2. カスタム 」タブをクリックします。 Click Add New . レンディションの目的のファイル名を指定します。
  3. 次の情報を入力します。
    保存 」をクリックします。
カスタムアプリケーションは、ヘッドレスな Project Firefly Appです。 処理プロファイルが設定されている場合、カスタムアプリケーションは指定されたすべてのファイルを取得します。 アプリケーションは、ファイルをフィルタリングする必要があります。
Fireflyアプリと Experience Manager アカウントが同じ組織に属していない場合、統合は機能しません。

カスタムプロファイルの例

カスタムプロファイルの使用方法を説明するために、キャンペーン画像にカスタムテキストを適用する使用例を考えてみましょう。 PhotoshopAPIを利用して画像を編集する処理プロファイルを作成できます。
Asset Compute Serviceの統合により、Experience Managerは、「 Service Parameters 」フィールドを使用して、これらのパラメーターをカスタムアプリケーションに渡すことができます。 次に、カスタムアプリケーションがPhotoshopAPIを呼び出し、これらの値をAPIに渡します。 例えば、フォント名、テキストカラー、テキスト重み付けおよびテキストサイズを渡して、カスタムテキストをキャンペーン画像に追加できます。
図:「サービスパラメータ」フィールドを使用して、カスタムアプリケーションに組み込む事前定義済みのパラメータに追加情報を渡します。 この例では、キャンペーン画像がアップロードされると、画像はフォントの Jumanji テキストで更新され Arial-BoldMT ます。

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

追加のカスタム処理プロファイルを作成し、Experience Manager の特定のフォルダーに適用して、これらのフォルダーにアップロードまたは更新されたアセットを処理します。デフォルトの組み込み標準処理プロファイルは常に実行されますが、ユーザーインターフェイスには表示されません。カスタムアセットを追加する場合、プロファイルされたアセットは両方のプロファイルを使用して処理されます。
次のいずれかの方法を使用して、処理プロファイルをフォルダーに適用します。
  • Administrators can select a processing profile definition in Tools > Assets > Processing Profiles , and use Apply Profile to Folder(s) action. コンテンツブラウザーが開き、そこで特定のフォルダーに移動したり、フォルダーを選択したり、プロファイルの適用を確定したりできます。
  • Users can select a folder in the Assets user interface, use Properties action to open folder properties screen, click on the Processing Profiles tab, and in the popup list, select the appropriate processing profile for that folder. 変更を保存するには、「 保存して閉じる 」をクリックします。
1つのフォルダーに適用できる処理プロファイルは1つだけです。 さらにレンディションを生成するには、既存の処理プロファイルにレンディションの定義を追加します。
処理プロファイルがフォルダーに適用されると、このフォルダーまたはその任意のサブフォルダー内でアップロード(または更新)された新しいアセットはすべて、設定された追加の処理プロファイルを使用して処理されます。この処理は、標準のデフォルトプロファイルによる処理に加えておこなわれます。
フォルダーに適用された処理プロファイルはツリー全体で機能しますが、サブフォルダーに適用された別のプロファイルでオーバーライドすることができます。アセットがフォルダーにアップロードされると、Adobe Experience Manager は、そのフォルダーのプロパティで処理プロファイルを確認します。何も適用されない場合は、適用する処理プロファイルが階層内の親フォルダーで確認されます。
アセットが処理されていることを確認するには、生成されたレンディションを左側のパネルの レンディション 表示にプレビューします。 アセットプレビューを開き、左のパネルを開いて レンディション 表示にアクセスします。 特定のアセットのタイプが MIME タイプ包含ルールと一致する処理プロファイルの特定のレンディションが表示され、アクセス可能になります。
図:親フォルダーに適用された処理プロファイルで生成された 2 つの追加レンディションの例.

後処理ワークフロー

処理プロファイルを使用して実現できない追加のアセット処理が必要な状況では、追加の後処理ワークフローを設定に追加できます。これにより、アセットマイクロサービスを使用して、設定可能な処理の上に完全にカスタマイズされた処理を追加できます。
後処理ワークフローが設定されている場合は、マイクロサービスの処理が終了した後に、AEM で後処理ワークフローが自動的に実行されます。ワークフローランチャーを手動で追加してトリガーする必要はありません。次に例を示します。
  • アセットを処理するためのカスタムワークフロー手順。
  • 外部システムから提供されるアセット(製品やプロセスの情報など)にメタデータやプロパティを追加するための統合機能。
  • 外部サービスによる追加処理。
後処理ワークフロー設定を Adobe Experience Manager に追加する作業は、次の手順で構成されます。
  • 1 つ以上のワークフローモデルの作成。ドキュメントでは​ 後処理ワークフローモデル ​と呼びますが、これらは通常の Experience Manager ワークフローモデルです。
  • これらのモデルへの特定のワークフローステップの追加。手順は、ワークフローモデルの設定に基づいてアセットに対して実行されます。
  • DAM アセットの更新ワークフロー完了プロセスステップを最後に追加します。この手順を追加すると、Experience Manager がいつ処理が終了したかを把握して、アセットを処理済みとしてマークできるので、アセットに​ 新規 ​が表示されます。
  • Custom Workflow Runner サービスの設定を作成すると、パス(フォルダーの場所)または正規表現で後処理ワークフローモデルの実行を設定できます。

後処理ワークフローモデルの作成

後処理ワークフローモデルは、通常の AEM ワークフローモデルです。リポジトリの場所やアセットタイプごとに異なる処理が必要な場合は、異なるモデルを作成します。
処理ステップは、ニーズに応じて追加する必要があります。サポートされているステップのほか、カスタム実装されたワークフローステップも使用できます。
各後処理ワークフローの最後の手順が DAM Update Asset Workflow Completed Process であることを確認します。最後の手順は、アセットの処理が完了したことを Experience Manager が確実に把握できるようにするのに役立ちます。

後処理ワークフローの実行の設定

アセットマイクロサービスの処理が終了した後に、システム内でアップロードまたは更新されたアセットに対して実行する後処理ワークフローモデルを設定するには、Custom Workflow Runner サービスを設定する必要があります。
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
Custom Workflow Runner の設定は、OSGi サービスの設定になります。OSGi 設定のデプロイ方法については、 Adobe Experience Manager へのデプロイ を参照してください。 OSGi Web コンソールは、AEM の On-Premise デプロイメントや Managed Services デプロイメントとは異なり、Cloud Service デプロイメントでは直接使用できません。
後処理ワークフローで使用できる標準ワークフローステップについて詳しくは、開発者向けリファレンスの 後処理ワークフローのワークフローステップ を参照してください。

ベストプラクティスと制限事項

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