新增和变更 new-additions-and-changes
介绍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。
向WSDL生成Servlet添加了可选的serviceUrl参数。 此参数对于调试代理很有用。 例如： http://<server>/scene7/webservice/IpsApi-2008-01-15.wsdl?serviceUrl=http://localhost:8081
已实施getZipEntries操作。
已实施搜索范围并键入系统字段条件的比较值。
添加了'Asset'资源类型字符串常量，主要是为了允许跨资源元数据字段。
已为trashState实施searchAssets参数。
已实施getAssetPublishHistory操作。
添加了可选的faultHttpStatusCodeSOAP标头，以便在Flex中启用错误处理。 对于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已移植到Web服务API。
已将excludeByproducts筛选器标志添加到searchAssets操作。 将此标记设置为true可运行PSDlayer个图像和PDF翻录的图像。
添加了getGenerationInfo操作。
已将SystemMessage属性名称添加到getProperty操作。
修改了一些资源类型字符串常量，以匹配相应的资源信息字段。
- WordDoc： Word
- ExcelDoc： Excel
- PowerPointDoc： PowerPoint
- RTFDoc： Rtf
修改了批处理操作的结果格式，以汇总成功、警告和错误。
已实施batchSetAssetMetadata批处理元数据操作。
为应用程序特定的数据实施了支持。
为上载作业实施了对createTemplate、extendLayers和extractText的布尔标志的支持，以控制Photoshop处理的过程（与添加文件上载的更改类似）。
已实施setImageMaps和setZoomTargets操作。
已实施ViewerPreset操作。 可识别的类型包括：
VideoPlayer（视频仅发布这些查看器。）BrochureBasicZoomAdvancedZoomSpinCustom types
查看器外观支持两个参数： skinFg和skinBg。 后端代码执行保持向后兼容性所需的所有处理。
已实施getAssociatedAssets操作。
添加了ReprocessAssets作业类型，以允许重新处理以前上载的主源文件，包括重新翻录PDF和重新优化图像。
已将PropertySetType字段类型重命名为propertyType。 此重命名会影响createPropertySetType参数和getPropertySetType/getPropertySetTypes响应。
已实施batchSetImageFields操作以支持设置图像用户数据和其他可编辑的图像字段。
47已将fileSize字段添加到各种资源信息类型：
VignetteInfoCabinetInfoWindowCoveringInfoIccProfileInfoFontInfoXslInfoViewerSwfInfoXmlInfoSvgInfoZipInfoVideoInfoAcoInfoPdfInfoPsdInfoFlashInfoInDesignInfoPostScriptInfoIllustratorInfoWordInfoExcelInfoPowerPointInfoIllustratorInfoWordInfoExcelInfoPowerPointInfoRTFInfo
已实施getActivePublishContexts操作。 此操作返回具有指定公司的活动发布服务器的发布上下文名称数组。 当前发布上下文名称为：
ImageServingImageRenderingVideo
已实施getSearchStrings操作。 它会返回给定资源的搜索字符串数组。
为作业添加了区域设置参数，并增加了设置API操作区域设置的机制。 区域设置字符串的格式应为<language_code>[-<country_code>]。 语言代码是由ISO-639指定的小写形式的双字母代码，而可选国家/地区代码是由ISO-3166指定的大写形式的双字母代码。
向authHeader SOAP标头添加了可选的区域设置参数，以设置API操作的区域设置。 如果此参数不存在，则使用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。 - 对于Float字段，可以使用数字比较运算符(
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中；现在它被拆分为单独的字段）。
已将assetHandle字段添加到JobLogDetail类型。
向submitJob添加了可选描述参数。 传递此参数以在getScheduledJobs、getActiveJobs和getJobLogs中进行检索。
已弃用SKU系统字段。 如果字段作为SystemFieldCondition传递到searchAssets，则忽略该字段。
已将excludeAssetTypeArray筛选器添加到searchAssets。
已将MaskInfo类型添加到Asset。
添加了可由IPS管理的新资产类型：
向UploadDirectoryJob和UploadUrlsJob添加了其他选项，用于控制独立处理Postscript、Illustrator和PDF文件。 所有现有作业都为三条处理管道中的每条管道提供必要参数，以便它们与今天完全相同。 原始PostScriptOptions块用于设置Illustrator和EPS/PS文件的处理。 或者，可以提供特定的文件选项块来指定处理。 更改列表包括：
-
无
-
栅格化（默认）
-
仅管理资产，上传时不会创建任何衍生工具。
-
按照规定的分辨率和色彩空间将EPS和PostScript文件渲染到图像。
alpha
可选.
- 无
- 栅格化（默认）
-
仅管理资产，上传时不会创建任何衍生工具。
-
按照规定的分辨率和色彩空间将文件渲染为图像。
alpha
可选.
-
无
-
栅格化（默认）
-
仅管理资产，上传时不会创建任何衍生工具。
-
按照规定的分辨率和色彩空间将文件渲染为图像。
您还可以从getScheduledJobs中查询。
已修改webservice.gzip.response配置属性以采用以下值之一：