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 der Equals op übergeben werden.
  • Bei Int-Feldern kann longVal mit einem numerischen Vergleichsoperator ( Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals) oder minLong/maxLong mit einem numerischen Bereichsvorgang ( Between, NotBetween) übergeben werden.
  • Bei Gleitkommafeldern kann doubleVal mit einem numerischen Vergleichsoperator ( Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals) oder minDouble/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 an submitJob gesendet wird (ohne Eindeutigkeitssuffixe oder Nachfolgenauftragsnamen).
  • jobSubType wird nur von ImageServingPublishJob Aufträgen verwendet (wobei es einer von full, increment, fullwithsearch, oder fulloverride 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 immer 0 mit getJobLogs)
  • fileUpdateCount (zuvor war es immer 0 mit getJobLogs und war in fileSuccessCount 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:

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

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:

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

<boolean>
Wird beim Rastern der Datei in ein Bild wirksam. Es erzeugt einen transparenten Hintergrund, wenn die ursprüngliche Datei so definiert ist, dass Logos überlagert werden.
IllustratorOptions
process
  • 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.

resolution
<integer>
Rastern der Auflösung.
colorspace
Zielfarbraum für die Wiedergabe.

alpha

Optional.

Wird beim Rastern der Datei in ein Bild wirksam. Erstellt einen transparenten Hintergrund, wenn die ursprüngliche Datei so definiert ist, um überlagerte Logos zu erstellen.
PDFOptions
process
  • 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.

resolution
<integer>
Rastern der Auflösung.
colorspace
Zielfarbraum für die Wiedergabe.
pdfCatalog
<boolean>
Definiert, ob nach dem Rendern eine mehrseitige PDF in einen eCatalog kombiniert werden soll (Standard ist "true").
extractSearchWords
<boolean>
Definiert, ob Wörter aus der PDF zur späteren Bereitstellung an einen Suchserver in die DB extrahiert werden (der Standardwert ist "false").

Sie können auch über "getScheduledJobs"abfragen.

Die Konfigurationseigenschaft webservice.gzip.response wurde geändert, um einen der folgenden Werte zu übernehmen:

Wert
Beschreibung
never
Keine gzip-Antwort.
soap
Gzip-Antwort nur dann, wenn authHeader/gzipResponse "true"ist.
accept
Gzip , wenn authHeader/gzipResponse wahr ist oder kein gzipResponse-Header vorhanden ist und der HTTP Accept-Encoding-Header gzip enthält. (Standard).
always
Immer gzip-Antwort, unabhängig von Header-Werten. Verwenden Sie diesen Wert nur zum Debugging.
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681