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.

BatchbatchSetAssetMetadataMetadatenvorgang 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 dem Equals op. übergeben werden.
  • Bei Int-Feldern können longVal mit einem numerischen Vergleichsoperator ( Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals) oder minLong/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) oder minDouble/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 an submitJob gesendet wird (ohne Eindeutigkeitssuffixe oder Nachfolgeauftragsnamen).
  • jobSubType wird nur von ImageServingPublishJob-Aufträgen verwendet (wobei es sich um einen der folgenden Aufträge handelt: full, increment, fullwithsearch, oder fulloverride).
  • 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 mit getJobLogs 0)
  • fileUpdateCount (wurde zuvor immer mit getJobLogs 0 und in fileSuccessCount 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:

Asset-Typ
Beschreibung
Illustrator
Adobe Illustrator-Datei.
PostScript
EPS- und PostScript-Dateien.
WordDoc-
Microsoft® Word-Dokument für Dateien, die auf .doc enden.
ExcelDoc-
Microsoft® Excel-Dokument für Dateien, die auf .xls enden.
PowerPointDoc-
Microsoft® PowerPoint-Dokument für Dateien, die auf .ppt enden.
RTFDoc-
RTF-Datei für hochgeladene Dateien mit der Endung .rtf.

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:

Feld
Parameter
Wert
Beschreibung
PostScriptOptions
process
  • 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.

<boolean>
Wird beim Rastern der Datei in einem Bild wirksam. Es wird ein transparenter Hintergrund erstellt, wenn die Originaldatei auf diese Weise für das Überlagern von Logos definiert wird.
IllustratorOptions
  • 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.

resolution
<integer>
Auflösung wird gerastert
colorspace
Zielfarbraum für die Wiedergabe.

Alpha-

Optional.

Wird beim Rastern der Datei in einem Bild wirksam. Erstellt einen transparenten Hintergrund, wenn die Originaldatei auf diese Weise zum Erstellen von Überlagerungen von Logos definiert wird.
PDFOptions-
  • 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.

resolution
<integer>
Auflösung wird gerastert
colorspace
Zielfarbraum für die Wiedergabe.
pdfCatalog-
<boolean>
Definiert, ob nach dem Rendering ein mehrseitiges PDF zu einem E-Katalog kombiniert werden soll (der Standardwert ist „true„).
extractSearchWords-
<boolean>
Legt fest, ob Wörter von der PDF in die Datenbank extrahiert werden, damit sie später an einen Suchserver übergeben werden (Standard ist „false„).

Sie können auch Abfragen über getScheduledJobs durchführen.

Die Konfigurationseigenschaft webservice.gzip.response wurde geändert, sodass sie einen der folgenden Werte annimmt:

Wert
Beschreibung
never
Keine Gzip-Antwort.
soap
Gzip-Antwort nur, wenn authHeader/gzipResponse wahr ist.
accept
Gzip , wenn authHeader/gzipResponse wahr ist oder keine gzipResponse-Kopfzeile vorhanden ist und die HTTP Accept-Encoding-Kopfzeile gzip enthält. (Standard).
always
Immer gzip -Antwort, unabhängig von Kopfzeilenwerten. Verwenden Sie diesen Wert nur zu Debugging-Zwecken.
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681