New Additions and Changes

Describes new and implemented changes for the IPS API v4.0.

Implemented side-by-side API versions with separate WSDLs and schema namespaces.

Added PostScriptOptions/alpha field.

Added VideoRootUrl and SwfRootUrl properties for getProperty operation.

Added optional appName and appVersion params to authHeader to track calling application. Added logging to ipsApiService.log.

Added an optional serviceUrl param to the WSDL generation servlet. This param is useful for debug proxies. For example: http://<server>/scene7/webservice/IpsApi-2008-01-15.wsdl?serviceUrl=http://localhost:8081

Implemented getZipEntries operation.

Implemented search ranges and typed comparison values for system field conditions.

Added 'Asset' asset type string constant, primarily to allow cross-asset metadata fields.

Implemented trashState param for searchAssets.

Implemented getAssetPublishHistory operation.

Added optional faultHttpStatusCode SOAP header to enable fault handling in Flex. For Flex, use <faultHttpStatusCode>200</faultHttpStatusCode>. The default status code for fault responses is 500 (Internal Server Error).

Added operations to restore assets from the trash and empty assets from the trash.

Implemented CRUD operations.

Added enabled flag to ImageMap type and saveImageMap operation.

Added support for Optimize Remaining Files jobs.

Added setAssetsPublishState for bulk publish state updates.

Added ImageServingPublishSettings, getImageServingPublishSettings, setImageServingPublishSettings.

Deprecated saveMetadataField operation in favor of new createMetadataField and updateMetadataField operations.

Implemented deleteAssetsParam batch delete operation.

Implemented moveAssetsParam batch move operation.

Implemented deleteMetadataField operation.

Implemented get/setImageRenderingPublishSettings, get/set/create/updateVignettePublishFormat operations.

Implemented getAssetCounts.

Added support to setImageSetMembers for including RenderSet members in ImageSet assets.

Added replaceImage operation.

Added copyImage operation.

Added setUrlModifier operation and urlModifier/urlPostApplyModifier fields for LayerViewInfo, TemplateInfo, and WatermarkInfo.

Added createDerivedAsset operation. Currently the ownerHandle must reference an Image asset and the type may be AdjustedView or LayerView.

Added createTemplate operation. Call to create Template or Watermark assets.

IPS company settings, CompanySettings, ported to Web services API.

Added excludeByproducts filter flag to searchAssets operation. Setting this flag to true runs PSDlayer images and PDF ripped images.

Added getGenerationInfo operation.

Added SystemMessage property name to getProperty operation.

Modified some asset type string constants to match the corresponding Asset Info fields.

Modified result format of batch operations to summarize success, warnings, and errors.

Implemented batchSetAssetMetadata batch metadata operation.

Implemented support for app-specific data.

Implemented support for boolean flags for createTemplate, extendLayers, and extractText for upload jobs to control process of Photoshop processing (similar to changes for add file uploads).

Implemented setImageMaps and setZoomTargets operations.

Implemented ViewerPreset operations. The recognized types are:

Viewer skins support two parameters: skinFg and skinBg. Backend code does all the processing required to maintain backward compatibility.

Implemented getAssociatedAssets operation.

Added ReprocessAssets job type to allow reprocessing of previously uploaded primary source files, including reripping PDFs and reoptimizing images.

Renamed PropertySetType field type to propertyType. This renaming affects the createPropertySetType parameter and getPropertySetType/getPropertySetTypes response.

Implemented batchSetImageFields operation to support setting image user data and other editable image fields.

47 Added fileSize field to various asset info types:

Implemented getActivePublishContexts operation. This operation returns an array of publish context names with active publish servers for the specified company. Current publish context names are:

Implemented getSearchStrings operation. It returns an array of search strings for the given asset.

Added locale parameters for jobs and a mechanism to set the locale for API operations. The locale string should be formatted as <language_code>[-<country_code>]. The language code is a lowercase, two-letter code as specified by ISO-639, and the optional country code is an uppercase, two-letter code as specified by ISO-3166.

Added optional locale parameter to the authHeader SOAP header to set the locale for API operations. If this parameter is not present, the HTTP header Accept-Language is used. If this header is also not present, the default locale for the IPS server is used.

Added get/set support for strongly typed metadata fields.

Implemented SOAP and HTTP header support for gzip response control.

Added gzipResponse flag to authHeader. If it is not present, the API checks the HTTP Accept-Encoding header.

Added support to searchAssets for strongly typed metadata field conditions.

Added description, jobSubType, and originalJobName fields to JobLog type.

In addition, the following fields are not included with both getJobLogs and getJobLogDetails. In prior versions, they were only available with getJobLogDetails.

Added assetHandle field to JobLogDetail type.

Added optional description parameter to submitJob. This parameter is passed through for retrieval in getScheduledJobs, getActiveJobs, and getJobLogs.

Deprecated the SKU system field. The field is ignored if it is passed in as a SystemFieldCondition to searchAssets.

Added excludeAssetTypeArray filter to searchAssets.

Added MaskInfo type to Asset.

Added new Asset Types for management by IPS:

Added additional options to UploadDirectoryJob and UploadUrlsJob to control processing of Postscript, Illustrator, and PDF files independently. All existing jobs provide the necessary parameters to each of the three processing pipelines so that they function exactly as done today. The original PostScriptOptions block is used to set the processing for Illustrator and EPS/PS files. Optionally, specific file options blocks can be supplied to specify processing. The list of changes includes:

You can also query from getScheduledJobs.

Modified the webservice.gzip.response configuration property to take one of the following values: