새 추가 및 변경 사항 new-additions-and-changes

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:

작성 대상:

개발자
관리자

IPS API v4.0의 새로운 변경 사항과 구현된 변경 사항에 대해 설명합니다.

별도의 WSDL 및 스키마 네임스페이스를 사용하여 병렬 API 버전을 구현했습니다.

이전 API 버전: IpsApi.wsdl, http://www.scene7.com/IpsApi/xsd.
SPS 4.0 버전: IpsApi-2008-01-15.wsdl, http://www.scene7.com/IpsApi/xsd/2008-01-15.

PostScriptOptions/alpha 필드를 추가했습니다.

VideoRootUrl 작업에 대해 SwfRootUrl 및 getProperty 속성을 추가했습니다.

호출 응용 프로그램을 추적하기 위해 선택적 appName 및 appVersion 매개 변수를 authHeader에 추가했습니다. ipsApiService.log에 로깅을 추가했습니다.

선택적 serviceUrl 매개 변수를 WSDL 생성 서블릿에 추가했습니다. 이 매개 변수는 디버그 프록시에 유용합니다. 예: http://<server>/scene7/webservice/IpsApi-2008-01-15.wsdl?serviceUrl=http://localhost:8081

getZipEntries 작업을 구현했습니다.

시스템 필드 조건에 대한 검색 범위 및 입력된 비교 값을 구현했습니다.

자산 간 메타데이터 필드를 허용하기 위해 자산 유형 문자열 상수 'Asset'개를 추가했습니다.

trashState에 대해 searchAssets 매개 변수를 구현했습니다.

getAssetPublishHistory 작업을 구현했습니다.

Flex에서 오류 처리를 사용하도록 설정하는 선택적 faultHttpStatusCode SOAP 헤더가 추가되었습니다. Flex의 경우 <faultHttpStatusCode>200</faultHttpStatusCode> 사용. 오류 응답에 대한 기본 상태 코드는 500 (Internal Server Error)입니다.

휴지통에서 자산을 복원하고 휴지통에서 자산을 비우는 작업이 추가되었습니다.

CRUD 작업을 구현했습니다.

ImageMap 형식 및 saveImageMap 작업에 활성화된 플래그를 추가했습니다.

나머지 파일 최적화 작업에 대한 지원을 추가했습니다.

대량 게시 상태 업데이트에 대해 setAssetsPublishState을(를) 추가했습니다.

ImageServingPublishSettings, getImageServingPublishSettings, setImageServingPublishSettings이(가) 추가되었습니다.

새 saveMetadataField 및 createMetadataField 작업을 위해 사용되지 않는 updateMetadataField 작업.

deleteAssetsParam 일괄 삭제 작업을 구현했습니다.

moveAssetsParam 일괄 이동 작업을 구현했습니다.

deleteMetadataField 작업을 구현했습니다.

get/setImageRenderingPublishSettings, get/set/create/updateVignettePublishFormat 작업을 구현했습니다.

getAssetCounts을(를) 구현했습니다.

setImageSetMembers 자산에 RenderSet 구성원을 포함하는 데 대한 지원이 ImageSet에 추가되었습니다.

replaceImage 작업이 추가되었습니다.

copyImage 작업이 추가되었습니다.

setUrlModifier, urlModifier/urlPostApplyModifier 및 LayerViewInfo에 대한 TemplateInfo 작업과 WatermarkInfo 필드를 추가했습니다.

createDerivedAsset 작업이 추가되었습니다. 현재 ownerHandle은(는) 이미지 자산을 참조해야 하며 형식은 AdjustedView 또는 LayerView일 수 있습니다.

createTemplate 작업이 추가되었습니다. 템플릿 또는 워터마크 자산을 만들려면 를 호출하십시오.

IPS 회사 설정 CompanySettings이(가) 웹 서비스 API로 포팅되었습니다.

excludeByproducts 작업에 searchAssets 필터 플래그를 추가했습니다. 이 플래그를 true로 설정하면 PSDlayer개의 이미지가 실행되고 PDF에서 리핑된 이미지가 실행됩니다.

getGenerationInfo 작업이 추가되었습니다.

SystemMessage 작업에 getProperty 속성 이름을 추가했습니다.

해당 에셋 정보 필드와 일치하도록 일부 에셋 유형 문자열 상수를 수정했습니다.

WordDoc: Word
ExcelDoc: Excel
PowerPointDoc: PowerPoint
RTFDoc: Rtf

성공, 경고 및 오류를 요약하는 일괄 처리 작업의 결과 형식을 수정했습니다.

batchSetAssetMetadata 일괄 처리 메타데이터 작업을 구현했습니다.

앱별 데이터에 대한 지원을 구현했습니다.

Photoshop 처리 프로세스를 제어하기 위한 업로드 작업에 대해 createTemplate, extendLayers 및 extractText에 대한 부울 플래그에 대한 지원이 구현되었습니다(파일 업로드 추가를 위한 변경 사항과 유사).

setImageMaps 및 setZoomTargets 작업을 구현했습니다.

ViewerPreset 작업을 구현했습니다. 인식되는 유형은 다음과 같습니다.

VideoPlayer(비디오에서는 이러한 뷰어만 게시합니다.)
Brochure
BasicZoom
AdvancedZoom
Spin
Custom types

뷰어 스킨은 skinFg 및 skinBg 매개 변수를 지원합니다. 백엔드 코드는 이전 버전과의 호환성을 유지하는 데 필요한 모든 처리를 수행합니다.

getAssociatedAssets 작업을 구현했습니다.

PDF 리핑 및 이미지 재최적화를 포함하여 이전에 업로드한 기본 소스 파일을 재처리할 수 있도록 ReprocessAssets 작업 유형이 추가되었습니다.

PropertySetType 필드 형식의 이름이 propertyType(으)로 바뀌었습니다. 이 이름 변경은 createPropertySetType 매개 변수 및 getPropertySetType/getPropertySetTypes 응답에 영향을 줍니다.

이미지 사용자 데이터 및 기타 편집 가능한 이미지 필드 설정을 지원하도록 batchSetImageFields 작업을 구현했습니다.

47 다양한 에셋 정보 유형에 fileSize 필드를 추가했습니다.

VignetteInfo
CabinetInfo
WindowCoveringInfo
IccProfileInfo
FontInfo
XslInfo
ViewerSwfInfo
XmlInfo
SvgInfo
ZipInfo
VideoInfo
AcoInfo
PdfInfo
PsdInfo
FlashInfo
InDesignInfo
PostScriptInfo
IllustratorInfo
WordInfo
ExcelInfo
PowerPointInfo
IllustratorInfo
WordInfo
ExcelInfo
PowerPointInfo
RTFInfo

getActivePublishContexts 작업을 구현했습니다. 이 작업은 지정된 회사에 대해 활성 게시 서버가 있는 게시 컨텍스트 이름의 배열을 반환합니다. 현재 게시 컨텍스트 이름은 다음과 같습니다.

ImageServing
ImageRendering
Video

getSearchStrings 작업을 구현했습니다. 지정된 자산에 대한 검색 문자열 배열을 반환합니다.

작업에 대한 로케일 매개 변수와 API 작업에 대한 로케일을 설정하는 메커니즘을 추가했습니다. 로케일 문자열의 형식은 <language_code>[-<country_code>]이어야 합니다. 언어 코드는 ISO-639에 지정된 소문자 두 자리 코드이며, 선택적 국가 코드는 ISO-3166에 지정된 대문자 두 자리 코드입니다.

API 작업의 로케일을 설정하기 위해 선택적 로케일 매개 변수를 authHeader SOAP 헤더에 추가했습니다. 이 매개 변수가 없으면 HTTP 헤더 Accept-Language이(가) 사용됩니다. 이 헤더도 없으면 IPS 서버에 대한 기본 로케일이 사용됩니다.

강력한 형식의 메타데이터 필드에 대한 get/set 지원을 추가했습니다.

gzip 응답 제어에 대한 SOAP 및 HTTP 헤더 지원이 구현되었습니다.

gzipResponse에 authHeader 플래그를 추가했습니다. 없는 경우 API는 HTTP Accept-Encoding 헤더를 확인합니다.

강력한 형식의 메타데이터 필드 조건에 대한 searchAssets 지원이 추가되었습니다.

모든 필드 형식의 경우 문자열 비교 연산자(Equals, NotEquals, Contains, NotContains, StartsWith, EndsWith)를 사용하여 값을 전달할 수 있습니다.
부울 필드의 경우 boolVal이(가) Equals 작업과 함께 전달될 수 있습니다.
Int 필드의 경우 숫자 비교 연산자(longVal)를 사용하여 Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals을(를) 전달하거나 숫자 범위 작업(minLong/maxLong)을 사용하여 Between, NotBetween을(를) 전달할 수 있습니다.
부동 필드의 경우 숫자 비교 연산자(doubleVal)를 사용하여 Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals을(를) 전달하거나 숫자 범위 작업(minDouble/maxDouble)을 사용하여 Between, NotBetween을(를) 전달할 수 있습니다.
날짜 필드의 경우 숫자 비교 연산자(dateVal)로 Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals을(를) 전달하거나 숫자 범위 작업(Between, NotBetween)으로 minDate/maxDate를 전달할 수 있습니다.

설명, jobSubType 및 originalJobName 필드를 JobLog 형식에 추가했습니다.

originalJobName은(는) submitJob에 제출된 작업 이름입니다(고유한 접미사 또는 후속 작업 이름 없음).
jobSubType은(는) ImageServingPublishJob개의 작업에서만 사용됩니다(full, increment, fullwithsearch, 또는 fulloverride 중 하나).
description은(는) 모든 작업 유형에 대해 빈 문자열이지만 업로드 경로와 같은 요약 작업 정보를 포함합니다.

또한 다음 필드는 getJobLogs과(와) getJobLogDetails에 모두 포함되지 않습니다. 이전 버전에서는 getJobLogDetails에서만 사용할 수 있었습니다.

endDate(작업이 완료된 경우).
fileDuplicateCount(이전에는 항상 0을(를) 가진 getJobLogs이었습니다.)
fileUpdateCount(이전에는 항상 0을(를) 사용하여 getJobLogs이었고 fileSuccessCount에 포함되었습니다. 이제 별도의 필드로 분할됩니다.)

JobLogDetail 형식에 assetHandle 필드를 추가했습니다.

선택적 설명 매개 변수를 submitJob에 추가했습니다. 이 매개 변수는 getScheduledJobs, getActiveJobs 및 getJobLogs에서 검색하기 위해 전달됩니다.

SKU 시스템 필드를 사용하지 않습니다. 필드가 SystemFieldCondition(으)로 searchAssets에 전달되면 무시됩니다.

excludeAssetTypeArray에 searchAssets 필터를 추가했습니다.

MaskInfo에 Asset 형식을 추가했습니다.

IPS로 관리할 새 자산 유형 추가:

자산 유형

설명

Illustrator

Adobe Illustrator 파일.

PostScript

EPS 및 PostScript 파일.

WordDoc

Microsoft® .doc으로 끝나는 파일용 Word 문서.

ExcelDoc

.xls로 끝나는 파일용 Microsoft® Excel 문서.

PowerPointDoc

Microsoft® .ppt로 끝나는 파일용 PowerPoint 문서.

RTFDoc

.rtf로 끝나는 업로드된 파일에 대한 RTF 파일입니다.

Postscript, Illustrator 및 PDF 파일의 처리를 독립적으로 제어할 수 있는 추가 옵션을 UploadDirectoryJob 및 UploadUrlsJob에 추가했습니다. 기존의 모든 작업은 세 개의 처리 파이프라인 각각에 필요한 매개 변수를 제공하므로 오늘날과 같이 정확하게 작동합니다. 원래 PostScriptOptions 블록은 Illustrator 및 EPS/PS 파일의 처리를 설정하는 데 사용됩니다. 선택적으로, 특정 파일 옵션 블록이 처리를 지정하기 위해 제공될 수 있다. 변경 사항 목록에는 다음이 포함됩니다.

필드

매개 변수

값

설명

PostScriptOptions

process

없음
래스터화(기본값)

에셋만 관리하고 업로드 시 파생상품을 생성하지 않습니다.
EPS 및 PostScript 파일을 지정된 해상도 및 색상 공간의 이미지로 렌더링합니다.

알파

선택적.

<부울>

파일을 이미지로 래스터화할 때 적용됩니다. 로고를 오버레이하기 위해 원본 파일이 이러한 방식으로 정의된 경우 투명한 배경이 만들어집니다.

IllustratorOptions

프로세스

없음
래스터화(기본값)

에셋만 관리하고 업로드 시 파생상품을 생성하지 않습니다.
지정된 해상도 및 색상 공간에서 파일을 이미지로 렌더링합니다.

resolution

<정수>

해상도 래스터화.

colorspace

렌더링할 대상 색상 공간입니다.

알파

선택적.

파일을 이미지로 래스터화할 때 적용됩니다. 원본 파일이 오버레이 로고를 만들기 위해 이러한 방식으로 정의된 경우 투명한 배경을 만듭니다.

PDFOptions

프로세스

없음
래스터화(기본값)

에셋만 관리하고 업로드 시 파생상품을 생성하지 않습니다.
지정된 해상도 및 색상 공간에서 파일을 이미지로 렌더링합니다.

resolution

<정수>

해상도 래스터화.

colorspace

렌더링할 대상 색상 공간입니다.

pdfCatalog

<부울>

렌더링 후 여러 페이지 PDF을 eCatalog에 결합할지 여부를 정의합니다(기본값은 true).

extractSearchWords

<부울>

나중에 검색 서버에 제공하기 위해 PDF의 단어를 DB로 추출할지 여부를 정의합니다(기본값은 false임).

getScheduledJobs에서 쿼리할 수도 있습니다.

다음 값 중 하나를 사용하도록 webservice.gzip.response 구성 속성을 수정했습니다.

값

설명

never

응답을 gzip으로 표시하지 않습니다.

soap

Gzip 응답은 authHeader/gzipResponse가 true인 경우에만 해당됩니다.

authHeader/gzipResponse가 true이거나 gzipResponse 헤더가 없고 HTTP Accept-Encoding 헤더에 gzip이 포함된 경우, Gzip입니다. (기본값).

always

헤더 값에 관계없이 항상 gzip 응답 이 값은 디버깅 목적으로만 사용하십시오.

recommendation-more-help

4e9b9d8c-5839-4215-aa35-01b652869681