위치:
이미지 변환 URL 구조, 유효성 검사 및 작업 순서
이미지 변환 요청은 /dw/image/v2/ 경로와 쿼리 문자열을 사용합니다. B2C Commerce Dynamic Imaging Service는 이러한 매개 변수를 고정된 순서로 적용합니다.
변환 유형, 매개변수 이름, JavaScript 변환 오브젝트 및 검증 세부 정보는지원되는 변환테이블을 사용하십시오. 이 항목에서는 경로 모양, 작업 순서 및 출력 형식이 URL과 관련되는 방식만 설명합니다.
경로 마커
변환된 이미지 URL은 일반적인 정적 컨텐츠 경로(예: on/demandware.static/... )와 함께 경로 세그먼트/dw/image/v2/를 사용합니다. 허브에서와 같이Dynamic Imaging Service에서URLUtils및MediaFile클래스를 사용하여 URL을 빌드합니다관련 Dynamic Imaging Service 항목 .
출력 형식 및 파일 확장자
생성된 URL의 파일 확장자(예: .webp또는.avif )는 출력 형식을 선택합니다. 필요한 경우 sfrm매개변수는 소스 이미지 형식을 지정할 수 있습니다. 지원되는 변환의 형식 행을 참조하십시오 .
작업 순서
단일 요청에 여러 변환 유형이 적용되는 경우 Dynamic Imaging Service는 다음 순서로 변환을 처리합니다. 자르기와 배율을 결합하는 경우 서비스가 자르기를 먼저 적용한 다음 결과의 크기를 조정하기 때문에원본원본 이미지에서 자르기를 계획합니다.
- 형식(지정된 경우)
- 배경색(
bgcolor), 사용된 경우 투명도를 병합합니다. - 자르기(
cx,cy,cw,ch) - 크기 조정/배율 모드(
sw,sh,sm) - 오버레이(
ox,oy,oimg) - 퀄리티 (
q) - 메타데이터 스트립(
스트립)
매개 변수 유효성 검사 규칙(빠른 참조)
서비스는 잘못된 매개 변수가 있는 요청을 거부하고400 잘못된 요청을반환합니다. 전체 규칙은지원되는 변환표를 참조하십시오.
| 매개변수 | 규칙 | 필수 |
|---|---|---|
남서 , sh
|
정수, 10 - 3000픽셀. 있는 경우 비워 둘 수 없습니다. | 아니요 |
Sm
|
cut (기본값) 또는fit을 선택합니다. sw및sh와 함께만 사용하십시오.
|
아니요 |
CX , 사이
|
정수, 0 이상. 네 가지 자르기 매개 변수가 모두 함께 필요합니다. | 작물과는 |
CW , 채널
|
정수, 10 이상. 네 가지 자르기 매개 변수가 모두 함께 필요합니다. | 작물과는 |
황소 , 오이
|
정수, 0 이상. 세 가지 오버레이 매개변수가 모두 함께 필요합니다. | 오버레이 포함 |
OIMG
|
Dynamic Imaging Service 도메인의 고객 소유 이미지에 대한 URL 인코딩 경로입니다. 최대 400자까지 입력할 수 있습니다. 지원되는 형식: GIF, PNG, JPG, JP2입니다. | 오버레이 포함 |
Bgcolor
|
6자리 16진수(불투명) 또는 8자리 16진수(알파, PNG 출력 전용). | 아니요 |
Q
|
1에서 100 사이의 정수입니다. JPG/JP2의 경우 기본값은 80입니다. 기본값을 사용하는 경우 생략합니다. | 아니요 |
증권 시세 표시기
|
소스 형식: gif , jp2 , jpg , jpeg , png , tiff또는tif .
|
아니요 |
스트립
|
true (기본값)는 메타데이터를 제거합니다. false로 설정하면 보존됩니다. |
아니요 |
400 응답의 일반적인 원인
- 동일한 URL에서 중복 매개변수(
?sw=100&, sw=200). 마지막 값이 우선하며, 이는 논리 오류를 마스킹할 수 있습니다. - 빈 값(
?sw=&sh=400). - 잘못된 구분 기호, 일반적으로 대신 빗나간
%&입니다. - 오버레이 URL의 인코딩되지 않은 공백 또는 기타 예약된 문자입니다.
- 불완전한 자르기 또는 중첩 매개변수 세트.
- 위의 범위를 벗어난 값(예:
sw=5).
파일 크기, 시간 제한, 이미지 지침 및 동적 이미징 캐싱에 대한 자세한 내용은Dynamic Imaging Service 를 참조하십시오 . 문제 해결 및 마이그레이션의경우 해당 항목을 사용합니다.
