詳細情報:
画像変換 URL の構造、検証、および操作の順序
画像変換要求では、/dw/image/v2/ パスとクエリ文字列が使用されます。B2C Commerce Dynamic Imaging Service では、これらのパラメーターが一定の順序で適用されます。
変換タイプ、パラメーター名、JavaScript 変換オブジェクト、および検証の詳細については、サポートされている変換の表を使用してください。このトピックでは、パスの形状、操作の順序、および出力形式と URL の関係についてのみ説明します。
パスマーカー
変換された画像 URL では、パスセグメント/dw/image/v2/と通常の静的コンテンツパスが使用されます (例: on/demandware.static/... )。ハブのDynamic Imaging Service トピック にあるように、Dynamic Imaging Service のURLUtilsクラスとMediaFileクラスを使用して URL を作成します。
出力形式とファイル拡張子
生成された URL のファイル拡張子 ( .webpや.avifなど) によって、出力形式が選択されます。sfrmパラメーターは、必要に応じて、ソース・イメージ・フォーマットを指定できます。「サポートされている変換」の「形式」行を参照してください。
操作の順序
1 つの要求に複数の変換の種類が適用される場合、Dynamic Imaging Service はそれらを次の順序で処理します。切り抜きと拡大縮小を組み合わせる場合は、サービスが最初に切り抜きを適用してから結果を拡大縮小するため、元のソース画像で切り抜きを計画します。
- 形式 (指定されている場合)
- 背景色 (
bgcolor)、使用されている場所で透明度を平坦化します。 - クロップ(
cx、cy、cw、ch) - サイズ変更/拡大縮小モード(
sw、sh、sm) - オーバーレイ(
ox、oy、oimg) - 品質 (
q) - メタデータ ストリップ (
strip)
パラメーター検証ルール (クイック リファレンス)
サービスは無効なパラメーターを持つ要求を拒否し、400 Bad Requestを返します。完全なルールについては、「サポートされている変換」の表を参照してください。
| パラメーター | ルール | 必要あり |
|---|---|---|
SW、SH
|
整数、10〜3000ピクセル。存在する場合は空にすることはできません。 | なし |
Sm
|
cut (デフォルト) またはfitです。swとshでのみ使用してください。
|
なし |
CX、CY
|
整数、0 以上。4 つのクロップ パラメーターすべてが同時に必要です。 | 切り抜きあり |
CW、CHの
|
整数、10 以上。4 つのクロップ パラメーターすべてが同時に必要です。 | 切り抜きあり |
オックス、オイ
|
整数、0 以上。3 つのオーバーレイ パラメーターすべてが同時に必要です。 | オーバーレイあり |
OIMGの
|
Dynamic Imaging Service ドメイン上の顧客所有のイメージへの URL エンコードされたパス。最大 400 文字。サポートされている形式:GIF、PNG、JPG、JP2。 | オーバーレイあり |
Bgcolor
|
6 桁の 16 進数 (不透明) または 8 桁の 16 進数 (アルファ、PNG 出力のみ)。 | なし |
q
|
整数、1 から 100。デフォルトは JPG/JP2 の 80 です。デフォルトを使用する場合は省略します。 | なし |
Sfrm
|
ソース形式: gif、jp2、jpg、jpeg、png、tiff、または tif。
|
なし |
ストリップ
|
true (デフォルト) はメタデータを削除します。falseはそれを保持します。 |
なし |
400 応答の一般的な原因
- 同じ URL に重複するパラメーター (
?sw=100&sw=200)。最後の値が優先され、論理エラーをマスクできます。 - 空の値 (
?sw=&sh=400)。 - 区切り文字が間違っています。通常は
&ではなく%です。 - オーバーレイ URL 内のエンコードされていないスペースまたはその他の予約文字。
- 不完全なクロップまたはオーバーレイパラメータセット。
- 上記の範囲外の値 (
例: sw=5)。
ファイルサイズ、タイムアウト、イメージのガイドライン、およびダイナミックイメージングキャッシュについては、Dynamic Imaging Service を参照してください。トラブルシューティングと移行については、そのトピックを使用してください。
