說明IPS API v4.0的新變更和實作變更。
以個別的WSDL和架構命名空間實作並排的API版本。
IpsApi.wsdl, http://www.scene7.com/IpsApi/xsd
.IpsApi-2008-01-15.wsdl, http://www.scene7.com/IpsApi/xsd/2008-01-15
.新增 PostScriptOptions/alpha
欄位。
新增 VideoRootUrl
和 SwfRootUrl
屬性 getProperty
操作。
新增選填 appName
和 appVersion
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
支援新的 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
操作。
已修改某些資產類型字串常數,以符合對應的「資產資訊」欄位。
修改批處理操作的結果格式,以匯總成功、警告和錯誤。
已實作 batchSetAssetMetadata
批次中繼資料操作。
實作應用程式特定資料的支援。
實作對布林值標幟的支援 createTemplate
, extendLayers
,和 extractText
上傳作業以控制Photoshop處理程式(類似於新增檔案上傳的變更)。
已實作 setImageMaps
和 setZoomTargets
操作。
已實作 ViewerPreset
操作。 識別的類型為:
VideoPlayer
(影片只會發佈這些檢視器。)Brochure
BasicZoom
AdvancedZoom
Spin
Custom types
檢視器外觀支援兩個參數: skinFg
和 skinBg
. 後端程式碼會執行維持回溯相容性所需的所有處理作業。
已實作 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
是所有作業類型的空字串,但最終包含摘要作業資訊,例如上傳路徑。此外,下列欄位不會同時包含在兩者中 getJobLogs
和 getJobLogDetails
. 舊版僅提供 getJobLogDetails
.
endDate
(如果作業已完成)。fileDuplicateCount
(之前 0
with getJobLogs
)fileUpdateCount
(之前一律 0
with getJobLogs
和 fileSuccessCount
;現在會分割為個別欄位)。將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結尾的檔案。 |
新增其他選項至 UploadDirectoryJob
和 UploadUrlsJob
獨立控制Postscript、Illustrator和PDF檔案的處理。 所有現有作業都會為這三個處理管道中的每一個提供必要的參數,讓它們能如今般運作。 原始 PostScriptOptions
區塊可用來設定Illustrator和EPS/PS檔案的處理。 可選擇提供特定檔案選項塊以指定處理。 變更清單包括:
欄位 |
參數 |
值 |
說明 |
---|---|---|---|
PostScriptOptions |
process |
|
|
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回應。 此值僅用於偵錯用途。 |