Usted está aquí:
Transformación de imágenes Estructura, validación y orden de operaciones de la URL
Las solicitudes de transformación de imagen usan una ruta /dw/image/v2/ y una cadena de consulta. Dynamic Imaging Service de B2C Commerce aplica esos parámetros en un orden fijo.
Para los tipos de transformación, los nombres de los parámetros, los objetos de transformación de JavaScript y los detalles de validación, use la tabla Transformaciones admitidas . En este tema solo se explica la forma de la ruta, el orden de las operaciones y cómo se relaciona el formato de salida con la dirección URL.
Marcador de ruta
Las URL de imagen transformadas usan el segmento de ruta /dw/image/v2/ con la ruta de contenido estático usual (por ejemplo, on/demandware.static/...). Cree direcciones URL con las clases URLUtils y MediaFile en Dynamic Imaging Service , como en el concentrador Temas relacionados con Dynamic Imaging Service .
Formato de salida y extensión de archivo
La extensión de archivo en la URL generada (por ejemplo, . webp o . avif) selecciona el formato de salida. El parámetro sfrm, cuando sea necesario, puede especificar el formato de la imagen de origen. Consulte la fila Formato en Transformaciones admitidas .
Orden de operaciones
Cuando se aplican varios tipos de transformación a una sola solicitud, Dynamic Imaging Service los procesa en el siguiente orden. Si combina el recorte y la escala, planifique el recorte en la imagen de origen original, ya que el servicio aplica primero el recorte y, a continuación, escala el resultado, y no al revés.
- Formato (cuando se especifique)
- Color de fondo (
bgcolor), para aplanar la transparencia donde se usa - Recorte (
cx,cy,cw,ch) - Modo de cambio de tamaño / escala (
sw,sh,sm) - Superposición (
buey,oy,oimg) - Calidad (
q) - Tira de metadatos (
tira)
Reglas de validación de parámetros (referencia rápida)
El servicio rechaza las solicitudes con parámetros no válidos y devuelve 400 Bad Request. Para ver las reglas completas, consulte la tabla Transformaciones admitidas .
| Parámetro | Regla | Obligatorio |
|---|---|---|
SW, SH
|
Entero, de 10 a 3000 píxeles. No puede estar vacío cuando está presente. | No |
SM
|
Cortar (por defecto) o Ajustar. Úselo solo con sw y sh.
|
No |
CX, CY
|
Entero, 0 o mayor. Los cuatro parámetros de cultivo se requieren juntos. | Con recorte |
cw, ch
|
Entero, 10 o mayor. Los cuatro parámetros de cultivo se requieren juntos. | Con recorte |
Buey, Oy
|
Entero, 0 o mayor. Los tres parámetros de superposición se requieren juntos. | Con superposición |
Oimg
|
Ruta codificada en URL a una imagen propiedad del cliente en el dominio de Dynamic Imaging Service. Máximo 400 caracteres. Formatos admitidos: GIF, PNG, JPG, JP2. | Con superposición |
bgcolor
|
hexadecimal de 6 dígitos (opaco) o hexadecimal de 8 dígitos (alfa, solo salida PNG). | No |
q
|
Entero, del 1 al 100. Por defecto 80 para JPG/JP2. Omitir cuando se usa el valor predeterminado. | No |
SFRM
|
Formato fuente: gif, jp2, jpg, jpeg, png, tiff o tif.
|
No |
Tira
|
true (predeterminado) elimina los metadatos; false lo conserva. |
No |
Causas comunes de una respuesta 400
- Parámetros duplicados en la misma URL (
? sw=100&, sw=200). El último valor gana, lo que puede enmascarar errores lógicos. - Valores vacíos (
? sw=&sh=400). - Delimitador incorrecto, generalmente un
%desviado en lugar de&. - Espacios no codificados u otros caracteres reservados en una URL superpuesta.
- Conjuntos de parámetros de recorte o superposición incompletos.
- Valores fuera de los rangos anteriores (por ejemplo,
sw=5).
Para obtener información sobre el tamaño de archivo, el tiempo de espera, las directrices de imagen y el almacenamiento en caché de imágenes dinámicas, consulte Dynamic Imaging Service . Para Solución de problemas y migración , use ese tema.
