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'operazione Equals.
  • Per i campi Int, longVal può essere passato con un operatore di confronto numerico ( Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals) o minLong/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) o minDouble/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 a submitJob (senza suffissi di univocità o nomi di processo successivi).
  • jobSubType è utilizzato solo da ImageServingPublishJob processi (dove è uno di 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 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 sempre 0 con getJobLogs)
  • fileUpdateCount (in precedenza era sempre 0 con getJobLogs e incluso in fileSuccessCount; 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:

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 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:

Campo
Parametro
Valore
Descrizione
PostScriptOptions
process
  • 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.

<booleano>
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
  • 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.

resolution
<numero intero>
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
  • 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.

resolution
<numero intero>
Risoluzione di rasterizzazione.
colorspace
Spazio colore di destinazione per il rendering.
pdfCatalog
<booleano>
Definisce se combinare un PDF di più pagine in un eCatalog dopo il rendering (il valore predefinito è true).
extractSearchWords
<booleano>
Definisce se le parole del PDF vengono estratte nel database per essere successivamente fornite a un server di ricerca (il valore predefinito è false).

È inoltre possibile eseguire una query da getScheduledJobs.

La proprietà di configurazione webservice.gzip.response è stata modificata in modo da 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. Impostazione predefinita.
always
Risposta gzip sempre, indipendentemente dai valori di intestazione. Utilizza questo valore solo a scopo di debug.
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681