Neue Ergänzungen und Änderungen new-additions-and-changes
Beschreibt neue und implementierte Änderungen für die IPS-API v4.0.
Implementierung von nebeneinander liegenden API-Versionen mit separaten WSDLs und Schema-Namespaces.
- Frühere API-Versionen:
IpsApi.wsdl, http://www.scene7.com/IpsApi/xsd
. - SPS 4.0-Version:
IpsApi-2008-01-15.wsdl, http://www.scene7.com/IpsApi/xsd/2008-01-15
.
Das Feld PostScriptOptions/alpha
wurde hinzugefügt.
Die Eigenschaften VideoRootUrl
und SwfRootUrl
für den Vorgang getProperty
wurden hinzugefügt.
Die optionalen Parameter appName
und appVersion
wurden zu authHeader
hinzugefügt, um aufrufende Anwendungen zu verfolgen. Protokollierung zu ipsApiService.log
hinzugefügt.
Dem WSDL-Generierungsservlet wurde ein optionaler Parameter serviceUrl
hinzugefügt. Dieser Parameter ist für das Debugging von Proxys nützlich. Beispiel: http://<server>/scene7/webservice/IpsApi-2008-01-15.wsdl?serviceUrl=http://localhost:8081
Der getZipEntries
-Vorgang wurde implementiert.
Es wurden Suchbereiche implementiert und Vergleichswerte für Systemfeldbedingungen eingegeben.
String-Konstante vom Typ 'Asset'
Asset-Typ wurde hinzugefügt, um in erster Linie Asset-übergreifende Metadatenfelder zu ermöglichen.
Implementierung des trashState
-Parameters für searchAssets
.
Der getAssetPublishHistory
-Vorgang wurde implementiert.
Der optionale Header faultHttpStatusCode
SOAP wurde hinzugefügt, um die Fehlerbehebung in Flex zu ermöglichen. Verwenden Sie für Flex <faultHttpStatusCode>200</faultHttpStatusCode>
. Der Standardstatuscode für Fehlerantworten ist 500 (Internal Server Error)
.
Es wurden Vorgänge zum Wiederherstellen von Assets aus dem Papierkorb und leere Assets aus dem Papierkorb hinzugefügt.
Implementierung von CRUD-Vorgängen.
Dem Vorgang ImageMap
und saveImageMap
wurde eine aktivierte Markierung hinzugefügt.
Unterstützung für Optimieren von Aufträgen für verbleibende Dateien hinzugefügt.
Für Massenaktualisierungen zum Veröffentlichungsstatus wurde setAssetsPublishState
hinzugefügt.
ImageServingPublishSettings
, getImageServingPublishSettings
, setImageServingPublishSettings
hinzugefügt.
Veraltete saveMetadataField
-Operation zugunsten neuer createMetadataField
- und updateMetadataField
-Vorgänge.
Der Batch-Löschvorgang wurde implementiert. deleteAssetsParam
Implementierung des Batch-Verschiebungsvorgangs moveAssetsParam
.
Der deleteMetadataField
-Vorgang wurde implementiert.
Implementierte Vorgänge get/setImageRenderingPublishSettings
, get/set/create/updateVignettePublishFormat
.
getAssetCounts
wurde implementiert.
Unterstützung für setImageSetMembers
hinzugefügt, um RenderSet
Mitglieder in ImageSet
-Assets aufzunehmen.
Vorgang replaceImage
wurde hinzugefügt.
Vorgang copyImage
wurde hinzugefügt.
Die Felder setUrlModifier
und urlModifier/urlPostApplyModifier
wurden für LayerViewInfo
, TemplateInfo
und WatermarkInfo
hinzugefügt.
Vorgang createDerivedAsset
wurde hinzugefügt. Derzeit muss der ownerHandle
auf ein Bild-Asset verweisen und der Typ kann AdjustedView
oder LayerView
sein.
Vorgang createTemplate
wurde hinzugefügt. Aufrufen, um Vorlagen- oder Wasserzeichen-Assets zu erstellen.
IPS-Unternehmenseinstellungen, CompanySettings
, portiert auf die Web-Services-API.
excludeByproducts
Filterkennzeichnung zum searchAssets
-Vorgang hinzugefügt. Wenn dieses Flag auf "true"gesetzt wird, werden PSDlayer
Bilder und PDF gerippte Bilder ausgeführt.
Vorgang getGenerationInfo
wurde hinzugefügt.
Der Eigenschaftsname SystemMessage
wurde zum Vorgang getProperty
hinzugefügt.
Es wurden einige String-Konstanten vom Typ Asset geändert, die mit den entsprechenden Asset Info -Feldern übereinstimmen.
- WordDoc: Word
- ExcelDoc: Excel
- PowerPointDoc: PowerPoint
- RTFDoc: Rtf
Das Ergebnisformat von Batch-Vorgängen wurde geändert, um Erfolg, Warnungen und Fehler zusammenzufassen.
Implementierte Batch-Metadatenoperation batchSetAssetMetadata
.
Die Unterstützung für App-spezifische Daten wurde implementiert.
Die Unterstützung für boolesche Flags für Upload-Aufträge mit createTemplate
, extendLayers
und extractText
wurde implementiert, um die Verarbeitung von Photoshop-Aufträgen zu steuern (ähnlich wie bei Änderungen beim Hochladen von Dateien).
Implementierung der Vorgänge setImageMaps
und setZoomTargets
.
Implementierung von ViewerPreset
-Vorgängen. Die erkannten Typen sind:
VideoPlayer
(Video veröffentlicht diese Viewer nur.)Brochure
BasicZoom
AdvancedZoom
Spin
Custom types
Viewer-Skins unterstützen zwei Parameter: skinFg
und skinBg
. Der Backend-Code führt die gesamte erforderliche Verarbeitung aus, um die Abwärtskompatibilität zu gewährleisten.
Der getAssociatedAssets
-Vorgang wurde implementiert.
Der Auftragstyp ReprocessAssets
wurde hinzugefügt, um die erneute Verarbeitung zuvor hochgeladener Primärquelldateien zu ermöglichen, einschließlich des erneuten Abschneidens von PDF und der Neuoptimierung von Bildern.
Der Feldtyp PropertySetType
wurde in propertyType
umbenannt. Diese Umbenennung wirkt sich auf die Antwort createPropertySetType
und getPropertySetType/getPropertySetTypes
aus.
Der Vorgang batchSetImageFields
wurde implementiert, um das Festlegen von Bildbenutzerdaten und anderen bearbeitbaren Bildfeldern zu unterstützen.
47 Das Feld fileSize wurde zu verschiedenen Asset-Informationstypen hinzugefügt:
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
Der getActivePublishContexts
-Vorgang wurde implementiert. Dieser Vorgang gibt ein Array von Veröffentlichungskontextnamen mit aktiven Veröffentlichungsservern für das angegebene Unternehmen zurück. Aktuelle Veröffentlichungskontextnamen sind:
ImageServing
ImageRendering
Video
Der getSearchStrings
-Vorgang wurde implementiert. Es wird ein Array von Suchzeichenfolgen für das angegebene Asset zurückgegeben.
Es wurden Gebietsschema-Parameter für Aufträge und ein Mechanismus zum Festlegen des Gebietsschemas für API-Vorgänge hinzugefügt. Die Gebietsschema-Zeichenfolge sollte als <language_code>[-<country_code>]
formatiert sein. Der Sprachcode ist ein aus zwei Buchstaben bestehender Code in Kleinbuchstaben gemäß ISO-639 und der optionale Ländercode ist ein aus zwei Buchstaben bestehender Code in Großbuchstaben gemäß ISO-3166.
Der Kopfzeile authHeader
SOAP optionaler Parameter für das Gebietsschema wurde hinzugefügt, um das Gebietsschema für API-Vorgänge festzulegen. Wenn dieser Parameter nicht vorhanden ist, wird der HTTP-Header Accept-Language
verwendet. Wenn diese Kopfzeile ebenfalls nicht vorhanden ist, wird das standardmäßige Gebietsschema für den IPS-Server verwendet.
Unterstützung für stark typisierte Metadatenfelder hinzugefügt.
Die SOAP- und HTTP-Header-Unterstützung für die gzip-Antwortsteuerung wurde implementiert.
Markierung gzipResponse
wurde zu authHeader
hinzugefügt. Ist er nicht vorhanden, prüft die API den HTTP-Header Accept-Encoding
.
Unterstützung für searchAssets für stark typisierte Metadatenfeldbedingungen hinzugefügt.
- Für alle Feldtypen kann der Wert mit einem Zeichenfolgenvergleichsoperator (
Equals, NotEquals, Contains, NotContains, StartsWith, EndsWith
) übergeben werden. - Bei booleschen Feldern kann
boolVal
mit derEquals
op übergeben werden. - Bei Int-Feldern kann
longVal
mit einem numerischen Vergleichsoperator (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) oderminLong/maxLong
mit einem numerischen Bereichsvorgang (Between, NotBetween
) übergeben werden. - Bei Gleitkommafeldern kann
doubleVal
mit einem numerischen Vergleichsoperator (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) oderminDouble/maxDouble
mit einem numerischen Bereichsvorgang (Between, NotBetween
) übergeben werden. - Für Datumsfelder können Sie
dateVal
mit einem numerischen Vergleichsoperator (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) übergeben oder minDate/maxDate mit einem numerischen Bereichsvorgang (Between, NotBetween
) übergeben.
Die Felder jobSubType
und originalJobName
wurden zum Typ JobLog
hinzugefügt.
originalJobName
ist der Auftragsname, der ansubmitJob
gesendet wird (ohne Eindeutigkeitssuffixe oder Nachfolgenauftragsnamen).jobSubType
wird nur vonImageServingPublishJob
Aufträgen verwendet (wobei es einer vonfull
,increment, fullwithsearch,
oderfulloverride
ist).description
ist eine leere Zeichenfolge für alle Auftragstypen, enthält jedoch letztendlich Zusammenfassungsauftragsinformationen, z. B. den Upload-Pfad.
Darüber hinaus sind die folgenden Felder nicht sowohl in getJobLogs
als auch in getJobLogDetails
enthalten. In früheren Versionen waren sie nur mit getJobLogDetails
verfügbar.
endDate
(wenn der Auftrag abgeschlossen wurde).fileDuplicateCount
(zuvor war es immer0
mitgetJobLogs
)fileUpdateCount
(zuvor war es immer0
mitgetJobLogs
und war infileSuccessCount
enthalten; jetzt wird es in separate Felder aufgeteilt).
Das Feld assetHandle wurde dem Typ JobLogDetail
hinzugefügt.
Optionaler Beschreibungsparameter zu submitJob
hinzugefügt. Dieser Parameter wird zum Abrufen in getScheduledJobs
, getActiveJobs
und getJobLogs
übergeben.
Das SKU-Systemfeld wurde veraltet. Das Feld wird ignoriert, wenn es als SystemFieldCondition
an searchAssets
übergeben wird.
excludeAssetTypeArray
Filter zu searchAssets
hinzugefügt.
MaskInfo
-Typ zu Asset
hinzugefügt.
Es wurden neue Asset-Typen für die Verwaltung durch IPS hinzugefügt:
Es wurden zusätzliche Optionen zu UploadDirectoryJob
und UploadUrlsJob
hinzugefügt, um die unabhängige Verarbeitung von Postscript-, Illustrator- und PDF-Dateien zu steuern. Alle vorhandenen Aufträge stellen die erforderlichen Parameter für jede der drei Verarbeitungs-Pipelines bereit, damit sie genau wie heute funktionieren. Der ursprüngliche Block PostScriptOptions
wird verwendet, um die Verarbeitung für Illustrator- und EPS/PS-Dateien festzulegen. Optional können bestimmte Dateioptionen-Blöcke bereitgestellt werden, um die Verarbeitung anzugeben. Die Liste der Änderungen umfasst:
-
Keine
-
Rasterize (Standard)
-
Verwalten Sie das Asset nur und erstellen Sie beim Hochladen keine Ableitungen.
-
Rendern Sie die EPS- und PostScript-Datei in einem Bild mit der vorgeschriebenen Auflösung und dem erforderlichen Farbraum.
alpha
Optional.
- Keine
- Rasterize (Standard)
-
Verwalten Sie das Asset nur und erstellen Sie beim Hochladen keine Ableitungen.
-
Rendern Sie die Datei in ein Bild mit der vorgeschriebenen Auflösung und dem erforderlichen Farbraum.
alpha
Optional.
-
Keine
-
Rasterize (Standard)
-
Verwalten Sie das Asset nur und erstellen Sie beim Hochladen keine Ableitungen.
-
Rendern Sie die Datei in ein Bild mit der vorgeschriebenen Auflösung und dem erforderlichen Farbraum.
Sie können auch über "getScheduledJobs
"abfragen.
Die Konfigurationseigenschaft webservice.gzip.response
wurde geändert, um einen der folgenden Werte zu übernehmen: