Você está aqui:
Estrutura, validação e ordem de operações do URL de transformação de imagens
As solicitações de transformação de imagem usam um caminho /dw/image/v2/ e uma string de consulta. O Dynamic Imaging Service do B2C Commerce aplica esses parâmetros em uma ordem fixa.
Para tipos de transformação, nomes de parâmetros, objetos de transformação JavaScript e detalhes de validação, use a tabela Transformações com suporte . Este tópico explica apenas a forma do caminho, a ordem das operações e como o formato de saída se relaciona com a URL.
Marcador de caminho
Os URLs de imagem transformada usam o segmento de caminho /dw/image/v2/ com o caminho de conteúdo estático usual (por exemplo, on/demandware.static/...). Crie URLs com as classes URLUtils e MediaFile no Dynamic Imaging Service , como no hub Related Dynamic Imaging Service Topics .
Formato de saída e extensão de arquivo
A extensão de arquivo na URL gerada (por exemplo, . webp ou . avif) seleciona o formato de saída. O parâmetro sfrm, quando necessário, pode especificar o formato da imagem de origem. Consulte a linha Formatar em Transformações suportadas .
Ordem das operações
Quando vários tipos de transformação se aplicam a uma única solicitação, o Dynamic Imaging Service os processa na seguinte ordem. Se você combinar corte e escala, planeje o corte na imagem de origem original, porque o serviço aplica o corte primeiro e, em seguida, dimensiona o resultado, e não o contrário.
- Formato (quando especificado)
- Cor de fundo (
bgcolor), para achatar a transparência onde usado - Colheita (
cx,cy,cw,ch) - Modo de redimensionamento/escala (
sw,sh,sm) - Sobreposição (
boi,oy,oimg) - Qualidade (
q) - Faixa de metadados (
strip)
Regras de validação de parâmetros (referência rápida)
O serviço rejeita solicitações com parâmetros inválidos e retorna 400 solicitações incorretas. Para obter as regras completas, consulte a tabela Transformações com suporte .
| Parâmetro | Regras | Obrigatório |
|---|---|---|
SW, SH
|
Inteiro, 10 a 3000 pixels. Não pode estar vazio quando presente. | Não |
Sm
|
Corte (padrão) ou ajuste. Use apenas com sw e sh.
|
Não |
CX, Cy
|
Inteiro, 0 ou maior. Todos os quatro parâmetros de cultivo necessários juntos. | Com colheita |
CW, CH
|
Inteiro, 10 ou maior. Todos os quatro parâmetros de cultivo necessários juntos. | Com colheita |
boi, oy
|
Inteiro, 0 ou maior. Todos os três parâmetros de sobreposição necessários juntos. | Com sobreposição |
OIMG
|
Caminho codificado por URL para uma imagem de propriedade do cliente no domínio Dynamic Imaging Service. Máximo de 400 caracteres. Formatos suportados: GIF, PNG, JPG, JP2. | Com sobreposição |
Bgcolor
|
Hex de 6 dígitos (opaco) ou hexadecimal de 8 dígitos (somente saída alfa, PNG). | Não |
Q
|
Inteiro, 1 a 100. Padrão 80 para JPG/JP2. Omitir ao usar o padrão. | Não |
SFRM
|
Formato de origem: gif, jp2, jpg, jpeg, png, tiff ou tif.
|
Não |
Tira
|
true (padrão) remove metadados; falso preserva-o. |
Não |
Causas comuns de uma resposta 400
- Parâmetros duplicados no mesmo URL (
? sw=100&, sw=200). O último valor vence, o que pode mascarar erros de lógica. - Valores vazios (
? sw=&sh=400). - Delimitador errado, geralmente um
%perdido em vez de&. - Espaços não codificados ou outros caracteres reservados em um URL de sobreposição.
- Conjuntos de parâmetros de corte ou sobreposição incompletos.
- Valores fora dos intervalos acima (por exemplo,
sw=5).
Para ver o tamanho do arquivo, o tempo limite, as Diretrizes de imagem e o Cache dinâmico de imagens, consulte Dynamic Imaging Service . Para Solução de problemas e migração , use esse tópico.
