Ti trovi qui:
Struttura, convalida e ordine delle operazioni degli URL di trasformazione delle immagini
Le richieste di trasformazione delle immagini utilizzano un percorso /dw/image/v2/ e una stringa di query. B2C Commerce Dynamic Imaging Service applica tali parametri in un ordine fisso.
Per i tipi di trasformazione, i nomi dei parametri, gli oggetti di trasformazione JavaScript e i dettagli di convalida, utilizzare la tabella Trasformazioni supportate . In questo argomento vengono illustrati solo la forma del percorso, l'ordine delle operazioni e la relazione tra il formato di output e l'URL.
Indicatore di percorso
Gli URL di immagine trasformati utilizzano il segmento di percorso /dw/image/v2/ con il consueto percorso di contenuto statico (ad esempio, on/demandware.static/...). Creare URL con le classi URLUtils e MediaFile in Dynamic Imaging Service , come negli argomenti correlati di Dynamic Imaging Service dell'hub.
Formato di output ed estensione del file
L'estensione del file nell'URL generato (ad esempio, . webp o . avif) seleziona il formato di output. Il parametro sfrm, se necessario, può specificare il formato dell'immagine di origine. Vedere la riga Formato in Trasformazioni supportate .
Ordine delle operazioni
Quando più tipi di trasformazione si applicano a una singola richiesta, Dynamic Imaging Service li elabora nell'ordine seguente. Se si combinano ritaglio e scala, pianificare il ritaglio sull'immagine di origine originale, perché il servizio applica prima il ritaglio e poi ridimensiona il risultato, non il contrario.
- Formato (se specificato)
- Colore di sfondo (
bgcolor), per appiattire la trasparenza dove usato - Ritaglia (
cx,cy,cw,ch) - Modalità ridimensionamento/ridimensionamento (
sw,sh,sm) - Sovrapposizione (
bue,oy,oimg) - Qualità (
q) - Striscia di metadati (
striscia)
Regole di convalida dei parametri (riferimento rapido)
Il servizio rifiuta le richieste con parametri non validi e restituisce 400 richieste non valide. Per le regole complete, vedere la tabella Trasformazioni supportate .
| Parametro | Regola | Obbligatorio |
|---|---|---|
sw, sh
|
Intero, da 10 a 3000 pixel. Non può essere vuoto quando presente. | No |
Sm
|
Taglio (impostazione predefinita) o Adatta. Utilizzare solo con sw e sh.
|
No |
CX, CY
|
Intero, 0 o superiore. Tutti e quattro i parametri di coltura richiesti insieme. | Con il raccolto |
CW, CH
|
Intero, 10 o superiore. Tutti e quattro i parametri di coltura richiesti insieme. | Con il raccolto |
bue, oy
|
Intero, 0 o superiore. Tutti e tre i parametri di sovrapposizione richiesti insieme. | Con sovrapposizione |
OIMG
|
Percorso con codifica URL di un'immagine di proprietà del cliente nel dominio Dynamic Imaging Service. Massimo 400 caratteri. Formati supportati: GIF, PNG, JPG, JP2. | Con sovrapposizione |
Bgcolor
|
Esadecimale a 6 cifre (opaco) o esadecimale a 8 cifre (alfa, solo output PNG). | No |
D
|
Intero, da 1 a 100. Predefinito 80 per JPG/JP2. Omettere quando si utilizza l'impostazione predefinita. | No |
SFRM
|
Formato sorgente: gif, jp2, jpg, jpeg, png, tiff o tif.
|
No |
Striscia
|
true (impostazione predefinita) rimuove i metadati; false lo conserva. |
No |
Cause comuni di una risposta 400
- Parametri duplicati nello stesso URL (
? sw=100&; sw=200). L'ultimo valore ha la priorità, il che può mascherare gli errori logici. - Valori vuoti (
? sw=&sh=400). - Delimitatore errato, di solito una
%vagante invece di&. - Spazi non codificati o altri caratteri riservati in un URL di overlay.
- Set di parametri di ritaglio o sovrapposizione incompleti.
- Valori al di fuori degli intervalli sopra indicati (ad esempio,
sw=5).
Per informazioni sulle dimensioni dei file, il timeout, le linee guida per le immagini e la memorizzazione nella cache di Dynamic Imaging, vedere Dynamic Imaging Service . Per Risoluzione dei problemi e migrazione , utilizzare questo argomento.
