Neue Ergänzungen und Änderungen new-additions-and-changes
Beschreibt neue und implementierte Änderungen für die IPS API v4.0.
Side-by-Side-API-Versionen mit separaten WSDLs und Schema-Namespaces implementiert.
- 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
.
PostScriptOptions/alpha
Feld hinzugefügt.
VideoRootUrl
- und SwfRootUrl
für getProperty
Vorgang hinzugefügt.
Es wurden optionale appName
- und appVersion
hinzugefügt, um aufrufende Anwendungen zu authHeader
. Protokollierung hinzugefügt zu ipsApiService.log
.
Dem WSDL-Generierungs-Servlet wurde ein optionaler serviceUrl
hinzugefügt. Dieser Parameter ist für Debugging-Proxys nützlich. Beispiel: http://<server>/scene7/webservice/IpsApi-2008-01-15.wsdl?serviceUrl=http://localhost:8081
getZipEntries
Vorgang implementiert.
Es wurden Suchbereiche implementiert und Vergleichswerte für Systemfeldbedingungen eingegeben.
Es wurde 'Asset'
Konstante vom Typ Asset-Zeichenfolge hinzugefügt, um Asset-übergreifende Metadatenfelder zu ermöglichen.
trashState
Parameter für searchAssets
implementiert.
getAssetPublishHistory
Vorgang implementiert.
Es wurde ein optionaler faultHttpStatusCode
-SOAP-Header hinzugefügt, um die Fehlerbehandlung in Flex zu aktivieren. Verwenden Sie für Flex <faultHttpStatusCode>200</faultHttpStatusCode>
. Der Standardstatus-Code für Fehlerantworten lautet 500 (Internal Server Error)
.
Es wurden Vorgänge zum Wiederherstellen von Assets aus dem Papierkorb und zum Leeren von Assets aus dem Papierkorb hinzugefügt.
CRUD-Vorgänge implementiert.
Aktivierte Markierung zu ImageMap
und saveImageMap
hinzugefügt.
Unterstützung für verbleibende Dateiaufträge optimieren wurde hinzugefügt.
Es wurden setAssetsPublishState
für Statusaktualisierungen für die Massenveröffentlichung hinzugefügt.
ImageServingPublishSettings
, getImageServingPublishSettings
, setImageServingPublishSettings
hinzugefügt.
Veralteter saveMetadataField
-Vorgang zugunsten neuer createMetadataField
- und updateMetadataField
.
deleteAssetsParam
Batch-Löschvorgang implementiert.
moveAssetsParam
Stapelverschiebungsvorgang implementiert.
deleteMetadataField
Vorgang implementiert.
Implementierte get/setImageRenderingPublishSettings
, get/set/create/updateVignettePublishFormat
Vorgänge.
getAssetCounts
implementiert.
setImageSetMembers
für das Einschließen von RenderSet
-Mitgliedern in ImageSet
Assets wird nun unterstützt.
replaceImage
Vorgang hinzugefügt.
copyImage
Vorgang hinzugefügt.
Es wurden setUrlModifier
Vorgangs- und urlModifier/urlPostApplyModifier
für LayerViewInfo
, TemplateInfo
und WatermarkInfo
hinzugefügt.
createDerivedAsset
Vorgang hinzugefügt. Derzeit muss die ownerHandle
auf ein Bild-Asset verweisen, und der Typ kann AdjustedView
oder LayerView
sein.
createTemplate
Vorgang hinzugefügt. Aufruf zum Erstellen von Vorlagen- oder Wasserzeichen-Assets
IPS-Unternehmenseinstellungen, CompanySettings
, portiert in die Web-Services-API.
Filterflag excludeByproducts
searchAssets
Vorgang hinzugefügt. Wenn Sie dieses Flag auf „true“ setzen, werden PSDlayer
Bilder und PDF-zerlegten Bilder ausgeführt.
getGenerationInfo
Vorgang hinzugefügt.
SystemMessage
Eigenschaftsname wurde getProperty
Vorgang hinzugefügt.
Einige Konstanten vom Typ Asset-Zeichenfolge wurden geändert, damit sie mit den entsprechenden Feldern von Asset-Informationen übereinstimmen.
- WordDoc: Word
- ExcelDoc: Excel
- PowerPointDoc: PowerPoint
- RTFDoc: rtf
Das Ergebnisformat der Batch-Vorgänge wurde geändert, um Erfolg, Warnungen und Fehler zusammenzufassen.
BatchbatchSetAssetMetadata
Metadatenvorgang implementiert.
Unterstützung für App-spezifische Daten implementiert.
Es wurde Unterstützung für boolesche Flags für createTemplate
, extendLayers
und extractText
für Upload-Aufträge implementiert, um den Prozess der Photoshop-Verarbeitung zu steuern (ähnlich wie bei Änderungen für das Hochladen von Dateien hinzufügen).
Implementierte setImageMaps
- und setZoomTargets
.
ViewerPreset
Vorgänge implementiert. Folgende Typen werden erkannt:
VideoPlayer
(Im Video werden nur diese Viewer veröffentlicht.)Brochure
BasicZoom
AdvancedZoom
Spin
Custom types
Viewer-Designs unterstützen zwei Parameter: skinFg
und skinBg
. Der Backend-Code übernimmt alle erforderlichen Verarbeitungsschritte, um die Abwärtskompatibilität aufrechtzuerhalten.
getAssociatedAssets
Vorgang implementiert.
Es wurde ReprocessAssets
Auftragstyp hinzugefügt, um die Neuverarbeitung von zuvor hochgeladenen Primärquelldateien zu ermöglichen, einschließlich des Neurippens von PDF und der Neuoptimierung von Bildern.
PropertySetType
Feldtyp wurde in propertyType
umbenannt. Diese Umbenennung wirkt sich auf den createPropertySetType
und getPropertySetType/getPropertySetTypes
Antwort aus.
Es wurde batchSetImageFields
Vorgang 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
getActivePublishContexts
Vorgang implementiert. Dieser Vorgang gibt ein Array von Veröffentlichungskontextnamen mit aktiven Veröffentlichungsservern für das angegebene Unternehmen zurück. Die Namen des aktuellen Veröffentlichungskontexts sind:
ImageServing
ImageRendering
Video
getSearchStrings
Vorgang implementiert. Gibt ein Array von Suchzeichenfolgen für das angegebene Asset zurück.
Es wurden Gebietsschema-Parameter für Aufträge und ein Mechanismus zum Festlegen des Gebietsschemas für API-Vorgänge hinzugefügt. Die Zeichenfolge des Gebietsschemas sollte als <language_code>[-<country_code>]
formatiert sein. Der Sprach-Code ist ein Code mit zwei Kleinbuchstaben gemäß ISO-639, und der optionale Ländercode ist ein Code mit zwei Großbuchstaben gemäß ISO-3166.
Dem authHeader
-SOAP-Header wurde ein optionaler Gebietsschemaparameter 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 auch dieser Header nicht vorhanden ist, wird das Standardgebietsschema für den IPS-Server verwendet.
Es wurde Unterstützung für GET/SET für stark typisierte Metadatenfelder hinzugefügt.
SOAP- und HTTP-Header-Unterstützung für die gzip-Antwortsteuerung implementiert.
gzipResponse
-Markierung wurde authHeader
hinzugefügt. Wenn sie nicht vorhanden ist, prüft die API die HTTP-Accept-Encoding
-Kopfzeile.
SearchAssets für stark typisierte Metadatenfeld-Bedingungen wird nun unterstützt.
- Bei allen Feldtypen kann der Wert mit einem Zeichenfolgenvergleichsoperator (
Equals, NotEquals, Contains, NotContains, StartsWith, EndsWith
) übergeben werden - Bei booleschen Feldern kann
boolVal
mit demEquals
op. übergeben werden. - Bei Int-Feldern können
longVal
mit einem numerischen Vergleichsoperator (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) oderminLong/maxLong
mit numerischen Bereichsvorgängen (Between, NotBetween
) übergeben werden. - Bei Float-Feldern können
doubleVal
mit einem numerischen Vergleichsoperator (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) oderminDouble/maxDouble
mit numerischen Bereichsvorgängen (Between, NotBetween
) übergeben werden. - Bei Datumsfeldern können Sie
dateVal
mit einem numerischen Vergleichsoperator (Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals
) übergeben oder minDate/maxDate mit numerischen Bereichsvorgängen (Between, NotBetween
).
Es wurden die Felder Beschreibung, jobSubType
und originalJobName
zum JobLog
hinzugefügt.
originalJobName
ist der Auftragsname, der ansubmitJob
gesendet wird (ohne Eindeutigkeitssuffixe oder Nachfolgeauftragsnamen).jobSubType
wird nur vonImageServingPublishJob
-Aufträgen verwendet (wobei es sich um einen der folgenden Aufträge handelt:full
,increment, fullwithsearch,
oderfulloverride
).description
ist eine leere Zeichenfolge für alle Vorgangstypen, enthält aber letztendlich zusammenfassende Vorgangsinformationen, wie z. B. den Upload-Pfad.
Darüber hinaus sind die folgenden Felder nicht in getJobLogs
und getJobLogDetails
enthalten. In früheren Versionen waren sie nur mit getJobLogDetails
verfügbar.
endDate
(wenn der Vorgang abgeschlossen ist).fileDuplicateCount
(zuvor war es immer mitgetJobLogs
0
)fileUpdateCount
(wurde zuvor immer mitgetJobLogs
0
und infileSuccessCount
eingeschlossen; jetzt ist er in separate Felder unterteilt).
Das Feld assetHandle wurde zum JobLogDetail
hinzugefügt.
Optionaler Beschreibungsparameter zu submitJob
hinzugefügt. Dieser Parameter wird zum Abrufen in getScheduledJobs
, getActiveJobs
und getJobLogs
übergeben.
Das Feld SKU-System ist veraltet. Das Feld wird ignoriert, wenn es als SystemFieldCondition
an searchAssets
übergeben wird.
excludeAssetTypeArray
Filter zu searchAssets
hinzugefügt.
MaskInfo
zum Asset
hinzugefügt.
Neue Asset-Typen für die Verwaltung durch IPS hinzugefügt:
Es wurden zusätzliche Optionen zum UploadDirectoryJob
und UploadUrlsJob
hinzugefügt, um die Verarbeitung von PostScript-, Illustrator- und PDF-Dateien unabhängig zu steuern. Alle vorhandenen Aufträge liefern die erforderlichen Parameter für jede der drei Verarbeitungs-Pipelines, damit sie genau wie heute funktionieren. Der ursprüngliche PostScriptOptions
wird verwendet, um die Verarbeitung für Illustrator- und EPS/PS-Dateien festzulegen. Optional können bestimmte Dateioptionenblöcke bereitgestellt werden, um die Verarbeitung anzugeben. Die Liste der Änderungen umfasst:
-
keine
-
Rastern Standard)
-
Verwalten Sie nur das Asset und erstellen Sie keine Ableitungen beim Hochladen.
-
Rendern Sie die EPS- und PostScript-Datei in einem Bild mit der vorgeschriebenen Auflösung und dem vorgeschriebenen Farbraum.
Alpha-
Optional.
- keine
- (Standard)
-
Verwalten Sie nur das Asset und erstellen Sie keine Ableitungen beim Hochladen.
-
Rendern Sie die Datei in einem Bild mit der vorgeschriebenen Auflösung und dem vorgeschriebenen Farbraum.
Alpha-
Optional.
-
keine
-
(Standard)
-
Verwalten Sie nur das Asset und erstellen Sie keine Ableitungen beim Hochladen.
-
Rendern Sie die Datei in einem Bild mit der vorgeschriebenen Auflösung und dem vorgeschriebenen Farbraum.
Sie können auch Abfragen über getScheduledJobs
durchführen.
Die Konfigurationseigenschaft webservice.gzip.response
wurde geändert, sodass sie einen der folgenden Werte annimmt: