Nuove aggiunte e modifiche new-additions-and-changes
Vengono descritte le modifiche nuove e implementate per l'API IPS v4.0.
Sono state implementate versioni API affiancate con WSDL e spazi dei nomi degli schemi separati.
- Versioni API precedenti:
IpsApi.wsdl, http://www.scene7.com/IpsApi/xsd
. - Versione SPS 4.0:
IpsApi-2008-01-15.wsdl, http://www.scene7.com/IpsApi/xsd/2008-01-15
.
Aggiunto campo PostScriptOptions/alpha
.
Sono state aggiunte le proprietà VideoRootUrl
e SwfRootUrl
per l'operazione getProperty
.
Sono stati aggiunti appName
e appVersion
parametri facoltativi a authHeader
per tenere traccia dell'applicazione chiamante. Aggiunta registrazione a ipsApiService.log
.
È stato aggiunto un parametro serviceUrl
facoltativo al servlet di generazione WSDL. Questo parametro è utile per i proxy di debug. Esempio: http://<server>/scene7/webservice/IpsApi-2008-01-15.wsdl?serviceUrl=http://localhost:8081
Implementata l'operazione getZipEntries
.
Sono stati implementati intervalli di ricerca e valori di confronto digitati per le condizioni dei campi di sistema.
È stata aggiunta la costante stringa del tipo di risorsa 'Asset'
, principalmente per consentire l'utilizzo di campi di metadati tra risorse.
Implementato parametro trashState
per searchAssets
.
Implementata l'operazione getAssetPublishHistory
.
È stata aggiunta l'intestazione opzionale SOAP faultHttpStatusCode
per abilitare la gestione degli errori in Flex. Per Flex, utilizzare <faultHttpStatusCode>200</faultHttpStatusCode>
. Il codice di stato predefinito per le risposte di errore è 500 (Internal Server Error)
.
Sono state aggiunte operazioni per ripristinare le risorse dal cestino e svuotare le risorse dal cestino.
Implementazione delle operazioni CRUD.
Flag abilitato aggiunto al tipo ImageMap
e all'operazione saveImageMap
.
È stato aggiunto il supporto per i processi di ottimizzazione dei file rimanenti.
Aggiunta di setAssetsPublishState
per gli aggiornamenti in blocco dello stato di pubblicazione.
Aggiunti ImageServingPublishSettings
, getImageServingPublishSettings
, setImageServingPublishSettings
.
Operazione saveMetadataField
obsoleta a favore delle nuove operazioni createMetadataField
e updateMetadataField
.
Implementata l'operazione di eliminazione batch deleteAssetsParam
.
Implementata l'operazione di spostamento batch moveAssetsParam
.
Implementata l'operazione deleteMetadataField
.
Sono state implementate get/setImageRenderingPublishSettings
, get/set/create/updateVignettePublishFormat
operazioni.
Implementato getAssetCounts
.
Aggiunta del supporto a setImageSetMembers
per l'inclusione di RenderSet
membri in ImageSet
risorse.
Aggiunta dell'operazione replaceImage
.
Aggiunta dell'operazione copyImage
.
Aggiunta dell'operazione setUrlModifier
e dei campi urlModifier/urlPostApplyModifier
per LayerViewInfo
, TemplateInfo
e WatermarkInfo
.
Aggiunta dell'operazione createDerivedAsset
. Attualmente ownerHandle
deve fare riferimento a una risorsa Immagine e il tipo può essere AdjustedView
o LayerView
.
Aggiunta dell'operazione createTemplate
. Richiama per creare risorse modello o filigrana.
Impostazioni società IPS, CompanySettings
, trasferite all'API dei servizi Web.
Flag di filtro excludeByproducts
aggiunto all'operazione searchAssets
. Se si imposta questo flag su true, vengono eseguite PSDlayer
immagini e immagini copiate da PDF.
Aggiunta dell'operazione getGenerationInfo
.
Aggiunta del nome della proprietà SystemMessage
all'operazione getProperty
.
Sono state modificate alcune costanti stringa di tipo risorsa per farle corrispondere ai campi Informazioni risorsa corrispondenti.
- WordDoc: Word
- ExcelDoc: Excel
- PowerPointDoc: PowerPoint
- RTFDoc: Rtf
Formato risultato modificato delle operazioni batch per riepilogare le operazioni riuscite, gli avvisi e gli errori.
Implementata l'operazione di metadati batch batchSetAssetMetadata
.
È stato implementato il supporto per i dati specifici dell’app.
È stato implementato il supporto dei flag booleani per createTemplate
, extendLayers
e extractText
per i processi di caricamento per controllare il processo di elaborazione di Photoshop (in modo simile alle modifiche per i caricamenti di file di aggiunta).
Sono state implementate setImageMaps
e setZoomTargets
operazioni.
Sono state implementate ViewerPreset
operazioni. I tipi riconosciuti sono:
VideoPlayer
(il video pubblica solo questi visualizzatori).Brochure
BasicZoom
AdvancedZoom
Spin
Custom types
Gli skin del visualizzatore supportano due parametri: skinFg
e skinBg
. Il codice back-end esegue tutte le operazioni di elaborazione necessarie per mantenere la compatibilità con le versioni precedenti.
Implementata l'operazione getAssociatedAssets
.
È stato aggiunto il tipo di processo ReprocessAssets
per consentire la rielaborazione dei file di origine primari caricati in precedenza, inclusi la ripulitura dei PDF e la riottimizzazione delle immagini.
Tipo di campo PropertySetType
rinominato propertyType
. Questa ridenominazione influisce sul parametro createPropertySetType
e sulla risposta getPropertySetType/getPropertySetTypes
.
È stata implementata l'operazione batchSetImageFields
per supportare l'impostazione dei dati utente dell'immagine e di altri campi immagine modificabili.
47 È stato aggiunto il campo fileSize a vari tipi di informazioni sulle risorse:
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
Implementata l'operazione getActivePublishContexts
. Questa operazione restituisce un array di nomi di contesto di pubblicazione con server di pubblicazione attivi per la società specificata. I nomi di contesto di pubblicazione correnti sono:
ImageServing
ImageRendering
Video
Implementata l'operazione getSearchStrings
. Restituisce un array di stringhe di ricerca per la risorsa specificata.
Sono stati aggiunti i parametri delle impostazioni locali per i processi e un meccanismo per impostare le impostazioni locali per le operazioni API. La stringa delle impostazioni locali deve essere formattata come <language_code>[-<country_code>]
. Il codice della lingua è un codice a due lettere minuscole come specificato dallo standard ISO-639 e il codice facoltativo del paese è un codice a due lettere maiuscole come specificato dallo standard ISO-3166.
È stato aggiunto un parametro locale facoltativo all'intestazione SOAP authHeader
per impostare le impostazioni locali per le operazioni API. Se questo parametro non è presente, viene utilizzata l'intestazione HTTP Accept-Language
. Se anche questa intestazione non è presente, viene utilizzata la lingua predefinita per il server IPS.
È stato aggiunto il supporto per get/set per campi di metadati fortemente tipizzati.
È stato implementato il supporto dell’SOAP e dell’intestazione HTTP per il controllo della risposta gzip.
Aggiunta del flag gzipResponse
a authHeader
. Se non è presente, l'API controlla l'intestazione HTTP Accept-Encoding
.
È stato aggiunto il supporto a searchAssets per le condizioni dei campi di metadati fortemente tipizzati.
- Per tutti i tipi di campo, il valore può essere passato con un operatore di confronto di stringhe (
Equals, NotEquals, Contains, NotContains, StartsWith, EndsWith
) - Per i campi booleani,
boolVal
può essere passato con l'operazioneEquals
. - Per i campi Int,
longVal
può essere passato con un operatore di confronto numerico (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) ominLong/maxLong
può essere passato con operazioni di intervallo numerico (Between, NotBetween
). - Per i campi mobili,
doubleVal
può essere passato con un operatore di confronto numerico (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) ominDouble/maxDouble
può essere passato con operazioni di intervallo numerico (Between, NotBetween
). - Per i campi Data, è possibile passare
dateVal
con un operatore di confronto numerico (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) oppure è possibile passare minDate/maxDate con operazioni di intervallo numerico (Between, NotBetween
).
Sono stati aggiunti i campi description, jobSubType
e originalJobName
al tipo JobLog
.
originalJobName
è il nome del processo inviato asubmitJob
(senza suffissi di univocità o nomi di processo successivi).jobSubType
è utilizzato solo daImageServingPublishJob
processi (dove è uno difull
,increment, fullwithsearch,
ofulloverride
).description
è una stringa vuota per tutti i tipi di processo, ma alla fine contiene informazioni di riepilogo sul processo, ad esempio il percorso di caricamento.
Inoltre, i campi seguenti non sono inclusi in getJobLogs
e getJobLogDetails
. Nelle versioni precedenti, erano disponibili solo con getJobLogDetails
.
endDate
(se il processo è stato completato).fileDuplicateCount
(in precedenza era sempre0
congetJobLogs
)fileUpdateCount
(in precedenza era sempre0
congetJobLogs
e incluso infileSuccessCount
; ora è suddiviso in campi separati).
Campo assetHandle aggiunto al tipo JobLogDetail
.
È stato aggiunto un parametro descrittivo facoltativo a submitJob
. Questo parametro viene passato per il recupero in getScheduledJobs
, getActiveJobs
e getJobLogs
.
Campo di sistema SKU obsoleto. Il campo viene ignorato se viene passato come SystemFieldCondition
a searchAssets
.
Aggiunto filtro excludeAssetTypeArray
a searchAssets
.
Aggiunto tipo MaskInfo
a Asset
.
Sono stati aggiunti nuovi tipi di risorse per la gestione tramite IPS:
Sono state aggiunte opzioni aggiuntive a UploadDirectoryJob
e UploadUrlsJob
per controllare l'elaborazione indipendente dei file Postscript, Illustrator e PDF. Tutti i processi esistenti forniscono i parametri necessari a ciascuna delle tre pipeline di elaborazione in modo che funzionino esattamente come oggi. Il blocco PostScriptOptions
originale viene utilizzato per impostare l'elaborazione per i file Illustrator e EPS/PS. In alternativa, è possibile fornire blocchi di opzioni di file specifici per specificare l’elaborazione. L’elenco delle modifiche include:
-
Nessuno
-
Rasterizza (impostazione predefinita)
-
Gestisci solo la risorsa e non creare derivati al caricamento.
-
Rendering dei file EPS e PostScript in un'immagine alla risoluzione e allo spazio colore prescritti.
alfa
Facoltativo.
- Nessuno
- Rasterizza (impostazione predefinita)
-
Gestisci solo la risorsa e non creare derivati al caricamento.
-
Rendering del file in un'immagine alla risoluzione e allo spazio colore prescritti.
alfa
Facoltativo.
-
Nessuno
-
Rasterizza (impostazione predefinita)
-
Gestisci solo la risorsa e non creare derivati al caricamento.
-
Rendering del file in un'immagine alla risoluzione e allo spazio colore prescritti.
È inoltre possibile eseguire una query da getScheduledJobs
.
La proprietà di configurazione webservice.gzip.response
è stata modificata in modo da accettare uno dei seguenti valori: