新增内容和更改

介绍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字段。

getProperty操作添加了VideoRootUrlSwfRootUrl属性。

authHeader添加了可选的appNameappVersion参数,以跟踪调用应用程序。 向ipsApiService.log添加了日志记录。

向WSDL生成Servlet添加了可选的serviceUrl参数。 这对调试代理特别有用。 示例: http://<server>/scene7/webservice/IpsApi-2008-01-15.wsdl?serviceUrl=http://localhost:8081

实施了getZipEntries操作。

实现了系统字段条件的搜索范围和键入的比较值。

添加了'Asset'资产类型字符串常量,主要用于允许跨资产元数据字段。

searchAssets实施了trashState参数。

实施了getAssetPublishHistory操作。

添加了可选的faultHttpStatusCode SOAP标头,以在Flex中启用故障处理。 对于Flex,请使用<faultHttpStatusCode>200</faultHttpStatusCode>。 故障响应的默认状态代码为500 (Internal Server Error)

添加了从垃圾桶恢复资产和从垃圾桶恢复空资产的操作。

已实施CRUD操作。

ImageMap类型和saveImageMap操作添加了已启用的标记。

添加了对“优化剩余文件”作业的支持。

添加了setAssetsPublishState用于批量发布状态更新。

添加了ImageServingPublishSettingsgetImageServingPublishSettingssetImageServingPublishSettings

已弃用saveMetadataField操作,支持新的createMetadataFieldupdateMetadataField操作。

实施了deleteAssetsParam批量删除操作。

实施了moveAssetsParam批量移动操作。

实施了deleteMetadataField操作。

实施了get/setImageRenderingPublishSettingsget/set/create/updateVignettePublishFormat操作。

已实施getAssetCounts

setImageSetMembers添加了对在ImageSet资产中包含RenderSet成员的支持。

添加了replaceImage操作。

添加了copyImage操作。

LayerViewInfoTemplateInfoWatermarkInfo添加了setUrlModifier操作和urlModifier/urlPostApplyModifier字段。

添加了createDerivedAsset操作。 当前,ownerHandle必须引用图像资产,类型可能为AdjustedViewLayerView

添加了createTemplate操作。 当前,可以调用此操作来创建模板或水印资产。

IPS公司设置(CompanySettings)移植到Web服务API。

searchAssets操作添加了excludeByproducts筛选器标记。 将此标记设置为true会运行PSDlayer图像和PDF翻译图像。

添加了getGenerationInfo操作。

getProperty操作添加了SystemMessage属性名称。

修改了一些资产类型字符串常量,以匹配相应的“资产信息”字段。

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

修改了批处理操作的结果格式,以汇总成功、警告和错误。

实施了batchSetAssetMetadata批量元数据操作。

对特定于应用程序的数据实施了支持。

createTemplateextendLayersextractText的布尔标记实施了支持,这些布尔标记用于上传作业以控制Photoshop处理过程(与对添加文件上传的更改类似)。

实施了setImageMapssetZoomTargets操作。

实施了ViewerPreset操作。 已识别的类型包括:

  • VideoPlayer (视频仅发布这些查看器。)
  • Brochure
  • BasicZoom
  • AdvancedZoom
  • Spin
  • Custom types

查看器外观支持两个参数:skinFgskinBg。 后端代码将执行维护向后兼容性所需的所有处理。

实施了getAssociatedAssets操作。

添加了ReprocessAssets作业类型,以允许重新处理以前上传的主源文件,包括重新处理PDF和重新优化图像。

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指定的大写双字母代码。

authHeader SOAP标头添加了可选区域设置参数,以设置API操作的区域设置。 如果此参数不存在,则将使用HTTP标头Accept-Language。 如果此标头不存在,则将使用IPS服务器的默认区域设置。

添加了对强类型元数据字段的获取/设置支持。

实现了对gzip响应控制的SOAP和HTTP标头支持。

authHeader添加了gzipResponse标记。 如果不存在,则API还将检查HTTP Accept-Encoding标头。

为强类型元数据字段条件的searchAssets添加了支持。

  • 对于所有字段类型,可以使用字符串比较运算符(Equals, NotEquals, Contains, NotContains, StartsWith, EndsWith)传递值
  • 对于布尔字段,boolVal可以与Equals op一起传递。
  • 对于Int字段,longVal可以使用数值比较运算符(Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals)进行传递,或者minLong/maxLong可以使用数值范围运算(Between, NotBetween)进行传递。
  • 对于浮点字段,doubleVal可以使用数值比较运算符(Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals)进行传递,或者minDouble/maxDouble可以使用数值范围运算(Between, NotBetween)进行传递。
  • 对于“日期”字段,您可以使用数值比较运算符(Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals)传递dateVal,也可以使用数值范围运算(Between, NotBetween)传递minDate/maxDate。

JobLog类型添加了jobSubTypeoriginalJobName字段的描述。

  • originalJobName 是提交到的作业名 submitJob 称(没有任何唯一性后缀或后续作业名称)。
  • jobSubType 当前仅供作 ImageServingPublishJob 业使用(其中它是、 fullincrement, fullwithsearch, fulloverride之一)。
  • description 当前是所有作业类型的空字符串,但最终将包含摘要作业信息,如上载路径。

此外,getJobLogsgetJobLogDetails中不包含以下字段。 在以前的版本中,它们仅在getJobLogDetails中可用。

  • endDate (如果作业已完成)。
  • fileDuplicateCount (以前始终 0 使用 getJobLogs)
  • fileUpdateCount (以前始终包含在 0 中, getJobLogs 且包含在中 fileSuccessCount;现在,它被拆分为单独的字段)。

已将assetHandle字段添加到JobLogDetail类型。

submitJob添加了可选描述参数。 此代码将在getScheduledJobsgetActiveJobsgetJobLogs中传递以用于检索。

已弃用SKU系统字段。 如果该字段作为SystemFieldCondition传递到searchAssets,则忽略该字段。

searchAssets添加了excludeAssetTypeArray过滤器。

MaskInfo类型添加到Asset

添加了新的资产类型,供IPS管理:

资源类型

说明

Illustrator

Adobe Illustrator文件。

PostScript

EPS和PostScript文件。

WordDoc

对于以.doc结尾的文件,使用Microsoft Word文档。

ExcelDoc

对于以.xls结尾的文件,使用Microsoft Excel文档。

PowerPointDoc

对于以.ppt结尾的文件,使用Microsoft PowerPoint文档。

RTFDoc

以.rtf结尾的文件的RTF文件。

UploadDirectoryJobUploadUrlsJob添加了其他选项,可单独控制Postscript、Illustrator和PDF文件的处理。 所有现有作业都将为3条处理管道中的每条提供必要的参数,以便它们能够像今天一样正常运行。 原始的PostScriptOptions块用于设置Illustrator和EPS/PS文件的处理。 或者,可以提供特定文件选项块以指定处理。 更改列表包括:

字段

参数

说明

PostScriptOptions

进度

  • 栅格 化(默认)

  • 仅管理资产,并且不会在上传时创建任何派生项。

  • 以规定的分辨率和色彩空间将EPS和PostScript文件渲染到图像中。

alpha

可选。

<boolean>

将文件栅格化为图像时生效。 如果以这种方式定义原始文件以覆盖徽标,则将创建透明的后台。

IllustratorOptions

进度

  • 栅格 化(默认)

  • 仅管理资产,并且不会在上传时创建任何派生项。

  • 以规定的分辨率和色彩空间将文件渲染到图像中。

resolution

<integer>

光栅化分辨率。

颜色空间

用于渲染的目标色彩空间。

alpha

可选。

将文件栅格化为图像时会产生影响。 如果以这种方式定义原始文件以创建叠加徽标,则创建透明背景。

PDFOptions

进度

  • 栅格 化(默认)

  • 仅管理资产,并且不会在上传时创建任何派生项。

  • 以规定的分辨率和色彩空间将文件渲染到图像中。

resolution

<integer>

光栅化分辨率。

颜色空间

用于渲染的目标色彩空间。

pdfCatalog

<boolean>

定义在渲染后是否将多页面PDF合并到eCatalog中(默认值为true)。

extractSearchWords

<boolean>

定义是否将PDF中的单词提取到数据库中,以便稍后提供给搜索服务器(默认为false)。

您也可以从getScheduledJobs中查询。

已修改webservice.gzip.response配置属性,以采用以下值之一:

说明

从未

请勿gzip响应。

soap

仅当authHeader/gzipResponse为true时,才响应Gzip。

接受

如果authHeader/gzipResponse为true,或者不存在gzipResponse标头且HTTP Accept-Encoding标头包含gzip,则会设置Gzip。 (默认).

始终

始终gzip响应,而不考虑标头值。 此值仅用于调试目的。

在此页面上