新增和變更

說明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 欄位。

新增 VideoRootUrlSwfRootUrl 屬性 getProperty 操作。

新增選填 appNameappVersion params至 authHeader 來追蹤呼叫應用程式。 將記錄新增至 ipsApiService.log.

新增選填 serviceUrl 參數到WSDL生成servlet。 此參數對除錯代理很實用。 例如︰http://<server>/scene7/webservice/IpsApi-2008-01-15.wsdl?serviceUrl=http://localhost:8081

已實作 getZipEntries 操作。

為系統欄位條件實作搜尋範圍和輸入比較值。

新增 'Asset' 資產類型字串常數,主要用於允許跨資產中繼資料欄位。

已實作 trashState 參數 searchAssets.

已實作 getAssetPublishHistory 操作。

新增選填 faultHttpStatusCode SOAP標題,以在Flex中啟用錯誤處理。 若為Flex,請使用 <faultHttpStatusCode>200</faultHttpStatusCode>. 故障響應的預設狀態代碼為 500 (Internal Server Error).

新增從清單還原資產和從清單中清除資產的作業。

實施CRUD操作。

將已啟用的標幟新增至 ImageMap 類型和 saveImageMap 操作。

新增對「最佳化剩餘檔案」作業的支援。

新增 setAssetsPublishState 進行大量發佈狀態更新。

新增 ImageServingPublishSettings, getImageServingPublishSettings, setImageServingPublishSettings.

已棄用 saveMetadataField 支援新的 createMetadataFieldupdateMetadataField 操作。

已實作 deleteAssetsParam 批次刪除操作。

已實作 moveAssetsParam 批移動操作。

已實作 deleteMetadataField 操作。

已實作 get/setImageRenderingPublishSettings, get/set/create/updateVignettePublishFormat 操作。

已實作 getAssetCounts.

新增支援至 setImageSetMembers 包括 RenderSet 成員 ImageSet 資產。

新增 replaceImage 操作。

新增 copyImage 操作。

新增 setUrlModifier 操作與 urlModifier/urlPostApplyModifier 欄位 LayerViewInfo, TemplateInfo,和 WatermarkInfo.

新增 createDerivedAsset 操作。 目前 ownerHandle 必須參考影像資產,且類型可能 AdjustedViewLayerView.

新增 createTemplate 操作。 呼叫以建立範本或浮水印資產。

IPS公司設定, CompanySettings,已移植至網站服務API。

新增 excludeByproducts 篩選標幟 searchAssets 操作。 將此標幟設為true會執行 PSDlayer 影像和PDF撕破的影像。

新增 getGenerationInfo 操作。

新增 SystemMessage 屬性名稱為 getProperty 操作。

已修改某些資產類型字串常數,以符合對應的「資產資訊」欄位。

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

修改批處理操作的結果格式,以匯總成功、警告和錯誤。

已實作 batchSetAssetMetadata 批次中繼資料操作。

實作應用程式特定資料的支援。

實作對布林值標幟的支援 createTemplate, extendLayers,和 extractText 上傳作業以控制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 設定API操作的區域設定的SOAP標題。 如果此參數不存在,則會顯示HTTP標題 Accept-Language 中所有規則的URL區段。 如果此標頭不存在,則使用IPS伺服器的預設區域設定。

新增強類型化中繼資料欄位的取得/設定支援。

為gzip回應控制實作SOAP和HTTP標題支援。

新增 gzipResponse 標幟為 authHeader. 如果不存在,API會檢查HTTP Accept-Encoding 頁首。

新增對searchAssets的支援,以提供強制類型中繼資料欄位條件。

  • 對於所有欄位類型,值可以使用字串比較運算子( Equals, NotEquals, Contains, NotContains, StartsWith, EndsWith)
  • 對於布林欄位, boolVal 可與 Equals 行動。
  • 對於整欄位, 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)。

新增說明, jobSubType,和 originalJobName 欄位 JobLog 類型。

  • originalJobName 是提交到的作業名 submitJob (沒有任何唯一性尾碼或後續作業名稱)。
  • jobSubType 僅由使用 ImageServingPublishJob 工作(其中 full, increment, fullwithsearch,fulloverride)。
  • description 是所有作業類型的空字串,但最終包含摘要作業資訊,例如上傳路徑。

此外,下列欄位不會同時包含在兩者中 getJobLogsgetJobLogDetails. 舊版僅提供 getJobLogDetails.

  • endDate (如果作業已完成)。
  • fileDuplicateCount (之前 0 with getJobLogs)
  • fileUpdateCount (之前一律 0 with getJobLogsfileSuccessCount;現在會分割為個別欄位)。

將assetHandle欄位新增至 JobLogDetail 類型。

將選用說明參數新增至 submitJob. 此參數會傳遞至,以供擷取 getScheduledJobs, getActiveJobs,和 getJobLogs.

已棄用SKU系統欄位。 如果欄位以 SystemFieldCondition to searchAssets.

新增 excludeAssetTypeArray 篩選 searchAssets.

新增 MaskInfo 類型 Asset.

新增資產類型,供IPS管理:

資產類型

說明

Illustrator

Adobe Illustrator檔案。

PostScript

EPS和PostScript檔案。

WordDoc

Microsoft®以.doc結尾的檔案的Word文檔。

ExcelDoc

Microsoft® Excel文檔,用於結尾為.xls的檔案。

PowerPointDoc

Microsoft®以.ppt結尾的檔案的PowerPoint文檔。

RTFDoc

RTF檔案,用於以.rtf結尾的檔案。

新增其他選項至 UploadDirectoryJobUploadUrlsJob 獨立控制Postscript、Illustrator和PDF檔案的處理。 所有現有作業都會為這三個處理管道中的每一個提供必要的參數,讓它們能如今般運作。 原始 PostScriptOptions 區塊可用來設定Illustrator和EPS/PS檔案的處理。 可選擇提供特定檔案選項塊以指定處理。 變更清單包括:

欄位

參數

說明

PostScriptOptions

process

  • 光柵化 (預設)

  • 僅管理資產,不要在上傳時建立任何衍生工具。

  • 以規定的解析度和色域將EPS和PostScript檔案轉譯為影像。

alpha

選填。

<boolean>

將檔案柵格化為影像時生效。 如果以這種方式定義原始檔案以覆蓋標誌,則會建立透明背景。

IllustratorOptions

過程

  • 光柵化 (預設)

  • 僅管理資產,不要在上傳時建立任何衍生工具。

  • 以規定的解析度和顏色空間將檔案渲染到影像中。

resolution

<integer>

模擬解析度。

colorspace

用於渲染的目標顏色空間。

α

選填。

將檔案柵格化為影像時生效。 如果以此方式定義原始檔案以建立覆蓋標誌,則建立透明背景。

PDFOptions

過程

  • 光柵化 (預設)

  • 僅管理資產,不要在上傳時建立任何衍生工具。

  • 以規定的解析度和顏色空間將檔案渲染到影像中。

resolution

<integer>

模擬解析度。

colorspace

用於渲染的目標顏色空間。

pdfCatalog

<boolean>

定義呈現後是否要將多個頁面PDF結合為eCatalog(預設為true)。

extractSearchWords

<boolean>

定義是否將PDF中的字詞提取到資料庫中,以供稍後提供給搜索伺服器(預設為false)。

您也可以從 getScheduledJobs.

修改 webservice.gzip.response configuration屬性,以取得下列其中一個值:

說明

never

請勿gzip回應。

soap

只有在authHeader/gzipResponse為true時,Gzip回應才會。

accept

如果authHeader/gzipResponse為true,或沒有gzipResponse標頭,且HTTP Accept-Encoding標頭包含gzip,則Gzip會。 (預設).

always

無論標題值為何,一律gzip回應。 此值僅用於偵錯用途。

本頁內容