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.
IpsApi.wsdl, http://www.scene7.com/IpsApi/xsd
.IpsApi-2008-01-15.wsdl, http://www.scene7.com/IpsApi/xsd/2008-01-15
.Aggiunto PostScriptOptions/alpha
campo.
Aggiunto VideoRootUrl
e SwfRootUrl
proprietà per getProperty
operazione.
Opzionale aggiunto appName
e appVersion
parametri a authHeader
per tenere traccia dell'applicazione chiamante. Registrazione aggiunta a ipsApiService.log
.
È stata aggiunta un’opzione serviceUrl
parametro per il servlet di generazione WSDL. Questo parametro è utile per i proxy di debug. Ad esempio: http://<server>/scene7/webservice/IpsApi-2008-01-15.wsdl?serviceUrl=http://localhost:8081
Implementato getZipEntries
operazione.
Sono stati implementati intervalli di ricerca e valori di confronto digitati per le condizioni dei campi di sistema.
Aggiunto 'Asset'
costante stringa di tipo risorsa, principalmente per consentire campi di metadati tra risorse diverse.
Implementato trashState
parametro per searchAssets
.
Implementato getAssetPublishHistory
operazione.
Opzionale aggiunto faultHttpStatusCode
Intestazione SOAP per abilitare la gestione degli errori in Flex. Per Flex, utilizza <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.
È stato aggiunto il flag abilitato a ImageMap
tipo e saveImageMap
operazione.
È stato aggiunto il supporto per i processi di ottimizzazione dei file rimanenti.
Aggiunto setAssetsPublishState
per aggiornamenti in blocco dello stato di pubblicazione.
Aggiunto ImageServingPublishSettings
, getImageServingPublishSettings
, setImageServingPublishSettings
.
Obsoleto saveMetadataField
operazione a favore di nuovi createMetadataField
e updateMetadataField
operazioni.
Implementato deleteAssetsParam
operazione di eliminazione batch.
Implementato moveAssetsParam
operazione di spostamento batch.
Implementato deleteMetadataField
operazione.
Implementato get/setImageRenderingPublishSettings
, get/set/create/updateVignettePublishFormat
operazioni.
Implementato getAssetCounts
.
Supporto aggiunto a setImageSetMembers
per includere RenderSet
membri in ImageSet
risorse.
Aggiunto replaceImage
operazione.
Aggiunto copyImage
operazione.
Aggiunto setUrlModifier
funzionamento e urlModifier/urlPostApplyModifier
campi per LayerViewInfo
, TemplateInfo
, e WatermarkInfo
.
Aggiunto createDerivedAsset
operazione. Attualmente il ownerHandle
deve fare riferimento a una risorsa Immagine e il tipo può essere AdjustedView
o LayerView
.
Aggiunto createTemplate
operazione. Richiama per creare risorse modello o filigrana.
impostazioni aziendali IPS, CompanySettings
, portato all’API dei servizi Web.
Aggiunto excludeByproducts
filtra flag per searchAssets
operazione. Impostazione di questo flag su esecuzioni vere PSDlayer
immagini e immagini copiate da PDF.
Aggiunto getGenerationInfo
operazione.
Aggiunto SystemMessage
nome proprietà a getProperty
operazione.
Sono state modificate alcune costanti stringa di tipo risorsa per farle corrispondere ai campi Informazioni risorsa corrispondenti.
Formato risultato modificato delle operazioni batch per riepilogare le operazioni riuscite, gli avvisi e gli errori.
Implementato batchSetAssetMetadata
operazione batch di metadati.
È stato implementato il supporto per i dati specifici dell’app.
È stato implementato il supporto dei flag booleani per createTemplate
, extendLayers
, e extractText
processi di caricamento per controllare il processo di elaborazione Photoshop (simile alle modifiche per gli upload di file di aggiunta).
Implementato setImageMaps
e setZoomTargets
operazioni.
Implementato 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.
Implementato getAssociatedAssets
operazione.
Aggiunto ReprocessAssets
tipo di processo per consentire la rielaborazione dei file di origine primari caricati in precedenza, inclusa la copia dei PDF e la riottimizzazione delle immagini.
Rinominato PropertySetType
tipo di campo a propertyType
. Questa ridenominazione influisce sul createPropertySetType
Parametro e getPropertySetType/getPropertySetTypes
risposta.
Implementato batchSetImageFields
operazione per supportare l'impostazione di dati utente 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
Implementato getActivePublishContexts
operazione. 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
Implementato getSearchStrings
operazione. 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 opzionale al authHeader
Intestazione SOAP per impostare le impostazioni locali per le operazioni API. Se questo parametro non è presente, l’intestazione HTTP Accept-Language
viene utilizzato. 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 SOAP e HTTP header per il controllo della risposta gzip.
Aggiunto gzipResponse
contrassegna per authHeader
. Se non è presente, l’API controlla il Accept-Encoding
intestazione.
È stato aggiunto il supporto a searchAssets per le condizioni dei campi di metadati fortemente tipizzati.
Equals, NotEquals, Contains, NotContains, StartsWith, EndsWith
)boolVal
può essere trasmesso con Equals
Op.longVal
può essere trasmesso con un operatore di confronto numerico ( Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) o minLong/maxLong
può essere trasmesso con operazioni di intervallo numerico ( Between, NotBetween
).doubleVal
può essere trasmesso con un operatore di confronto numerico ( Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) o minDouble/maxDouble
può essere trasmesso con operazioni di intervallo numerico ( Between, NotBetween
).dateVal
con operatore di confronto numerico ( Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) oppure è possibile passare minDate/maxDate con operazioni di intervallo numerico ( Between, NotBetween
).È stata aggiunta la descrizione jobSubType
, e originalJobName
campi per JobLog
tipo.
originalJobName
è il nome del processo inviato a submitJob
(senza suffissi di univocità o nomi di processo successivi).jobSubType
viene utilizzato solo da ImageServingPublishJob
lavori (dove è uno dei full
, increment, fullwithsearch,
o fulloverride
).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 seguenti campi non sono inclusi in entrambi getJobLogs
e getJobLogDetails
. Nelle versioni precedenti, erano disponibili solo con getJobLogDetails
.
endDate
(se il processo è stato completato).fileDuplicateCount
(prima era sempre 0
con getJobLogs
)fileUpdateCount
(in precedenza era sempre 0
con getJobLogs
e inclusi in fileSuccessCount
; ora è suddiviso in campi separati).È stato aggiunto il campo assetHandle a JobLogDetail
tipo.
È stato aggiunto un parametro descrittivo opzionale a submitJob
. Questo parametro viene trasmesso 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 excludeAssetTypeArray
filtra per searchAssets
.
Aggiunto MaskInfo
digita in Asset
.
Sono stati aggiunti nuovi tipi di risorse per la gestione tramite IPS:
Tipo di risorsa |
Descrizione |
---|---|
Illustrator |
file Adobe Illustrator. |
PostScript |
File EPS e PostScript. |
WordDoc |
Documento Microsoft® Word per file che terminano con .doc. |
ExcelDoc |
Documento Microsoft® Excel per file che terminano con .xls. |
PowerPointDoc |
Documento Microsoft® PowerPoint per file che terminano con .ppt. |
RTFDoc |
File RTF per i file caricati che terminano con .rtf. |
Sono state aggiunte opzioni aggiuntive a UploadDirectoryJob
e UploadUrlsJob
per controllare l'elaborazione dei file Postscript, Illustrator e PDF in modo indipendente. Tutti i processi esistenti forniscono i parametri necessari a ciascuna delle tre pipeline di elaborazione in modo che funzionino esattamente come oggi. L'originale PostScriptOptions
Questo blocco viene utilizzato per impostare l’elaborazione dei file Illustrator e EPS/PS. In alternativa, è possibile fornire blocchi di opzioni di file specifici per specificare l’elaborazione. L’elenco delle modifiche include:
Campo |
Parametro |
Valore |
Descrizione |
---|---|---|---|
PostScriptOptions |
process |
|
|
alfa Facoltativo. |
<boolean> |
Esegue la rasterizzazione del file in un'immagine. Crea uno sfondo trasparente se il file originale è definito in questo modo per sovrapporre i logo. |
|
IllustratorOptions |
processo |
|
|
resolution |
<integer> |
Risoluzione di rasterizzazione. |
|
colorspace |
|
Spazio colore di destinazione per il rendering. |
|
alfa Facoltativo. |
|
Esegue la rasterizzazione del file in un'immagine. Crea uno sfondo trasparente se il file originale è definito in questo modo per la creazione di logo sovrapposti. |
|
PDFOptions |
processo |
|
|
resolution |
<integer> |
Risoluzione di rasterizzazione. |
|
colorspace |
|
Spazio colore di destinazione per il rendering. |
|
pdfCatalog |
<boolean> |
Definisce se combinare un PDF di più pagine in un eCatalog dopo il rendering (il valore predefinito è true). |
|
extractSearchWords |
<boolean> |
Definisce se le parole del PDF vengono estratte nel database per essere successivamente fornite a un server di ricerca (il valore predefinito è false). |
Puoi anche eseguire query da getScheduledJobs
.
Modificato il webservice.gzip.response
proprietà di configurazione per accettare uno dei seguenti valori:
Valore |
Descrizione |
---|---|
never |
Non ricevere risposta Gzip. |
soap |
Risposta Gzip solo se authHeader/gzipResponse è true. |
accept |
Gzip se authHeader/gzipResponse è true oppure se non è presente alcuna intestazione gzipResponse e l'intestazione HTTP Accept-Encoding include gzip. (Predefinito). |
always |
Risposta gzip sempre, indipendentemente dai valori di intestazione. Utilizza questo valore solo a scopo di debug. |