Neue Ergänzungen und Änderungen

Letzte Aktualisierung: 2022-11-11
  • Erstellt für:
  • Developer
    Admin

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.

Hinzugefügt PostScriptOptions/alpha -Feld.

Hinzugefügt VideoRootUrl und SwfRootUrl Eigenschaften für getProperty Vorgang.

Optional hinzugefügt appName und appVersion params in authHeader , um die aufrufende Anwendung zu verfolgen. Protokollierung zu hinzugefügt ipsApiService.log.

Eine optionale serviceUrl param zum WSDL-Generierungsservlet. 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

implementiert getZipEntries Vorgang.

Es wurden Suchbereiche implementiert und Vergleichswerte für Systemfeldbedingungen eingegeben.

Hinzugefügt 'Asset' String-Konstante für den Asset-Typ, um in erster Linie Asset-übergreifende Metadatenfelder zuzulassen.

implementiert trashState param für searchAssets.

implementiert getAssetPublishHistory Vorgang.

Optional hinzugefügt faultHttpStatusCode SOAP-Header zur Aktivierung der Fehlerbehandlung in Flex. Verwenden Sie für Flex <faultHttpStatusCode>200</faultHttpStatusCode>. Der Standardstatuscode für Fehlerantworten lautet 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.

Das aktivierte Flag wurde hinzugefügt zu ImageMap Typ und saveImageMap Vorgang.

Unterstützung für Optimieren von Aufträgen für verbleibende Dateien hinzugefügt.

Hinzugefügt setAssetsPublishState für Massenaktualisierungen des Veröffentlichungsstatus.

Hinzugefügt ImageServingPublishSettings, getImageServingPublishSettings, setImageServingPublishSettings.

Veraltet saveMetadataField Vorhaben zugunsten neuer createMetadataField und updateMetadataField Vorgänge.

implementiert deleteAssetsParam Batch-Löschvorgang.

implementiert moveAssetsParam Vorgang "Batch Move".

implementiert deleteMetadataField Vorgang.

implementiert get/setImageRenderingPublishSettings, get/set/create/updateVignettePublishFormat Vorgänge.

implementiert getAssetCounts.

Hinzugefügte Unterstützung für setImageSetMembers einschließlich RenderSet Mitglieder in ImageSet Assets.

Hinzugefügt replaceImage Vorgang.

Hinzugefügt copyImage Vorgang.

Hinzugefügt setUrlModifier Betrieb und urlModifier/urlPostApplyModifier Felder für LayerViewInfo, TemplateInfound WatermarkInfo.

Hinzugefügt createDerivedAsset Vorgang. Derzeit ist das ownerHandle muss auf ein Bild-Asset verweisen und der Typ kann AdjustedView oder LayerView.

Hinzugefügt createTemplate Vorgang. Rufen Sie auf, um Vorlagen- oder Wasserzeichen-Assets zu erstellen.

Einstellungen des IPS-Unternehmens, CompanySettings, portiert auf die Web-Services-API.

Hinzugefügt excludeByproducts Filtermarkierung auf searchAssets Vorgang. Festlegen dieser Markierung auf "true"wird ausgeführt PSDlayer Bilder und PDF gerippte Bilder.

Hinzugefügt getGenerationInfo Vorgang.

Hinzugefügt SystemMessage Eigenschaftsname in getProperty Vorgang.

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.

implementiert batchSetAssetMetadata Vorgang für Batch-Metadaten.

Die Unterstützung für App-spezifische Daten wurde implementiert.

Implementierte Unterstützung für boolesche Flags für createTemplate, extendLayersund extractText für Upload-Aufträge zur Steuerung der Photoshop-Verarbeitung (ähnlich wie Änderungen beim Hinzufügen von Datei-Uploads).

implementiert setImageMaps und setZoomTargets Vorgänge.

implementiert ViewerPreset Vorgänge. 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.

implementiert getAssociatedAssets Vorgang.

Hinzugefügt ReprocessAssets Auftragstyp, um die erneute Verarbeitung von zuvor hochgeladenen Primärquelldateien zu ermöglichen, einschließlich des erneuten Abrufs von PDF und der Neuoptimierung von Bildern.

Umbenannt PropertySetType Feldtyp zu propertyType. Diese Umbenennung wirkt sich auf die createPropertySetType Parameter und getPropertySetType/getPropertySetTypes Antwort.

implementiert batchSetImageFields -Operation, 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

implementiert getActivePublishContexts Vorgang. 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

implementiert getSearchStrings Vorgang. 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>]. 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 optionale Parameter locale wurde zum authHeader SOAP-Kopfzeile zum Festlegen des Gebietsschemas für API-Vorgänge. 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.

SOAP- und HTTP-Header-Unterstützung für die gzip-Antwortsteuerung implementiert.

Hinzugefügt gzipResponse Markierung auf authHeader. Ist dies nicht der Fall, prüft die API das HTTP Accept-Encoding -Kopfzeile.

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)
  • Für boolesche Felder: boolVal kann mit der Equals op.
  • Für Eingabefelder: longVal kann mit einem numerischen Vergleichsoperator ( Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals) oder minLong/maxLong kann mit numerischen Bereichsvorgängen ( Between, NotBetween).
  • Für Gleitkommafelder: doubleVal kann mit einem numerischen Vergleichsoperator ( Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals) oder minDouble/maxDouble kann mit numerischen Bereichsvorgängen ( Between, NotBetween).
  • Für Datumsfelder können Sie dateVal mit einem numerischen Vergleichsoperator ( Equals, NotEquals, LessThan, LessThanEquals, GreaterThan, GreaterThanEquals) oder Sie können minDate/maxDate mit numerischen Bereichsvorgängen ( Between, NotBetween).

Beschreibung hinzugefügt, jobSubTypeund originalJobName Felder zu JobLog Typ.

  • originalJobName ist der Auftragsname, der an übermittelt wird. submitJob (ohne Eindeutigkeitssuffixe oder Nachfolgenauftragsnamen).
  • jobSubType wird nur von ImageServingPublishJob Aufträge (wobei es sich um einen von full, increment, fullwithsearch, oder fulloverride).
  • description ist eine leere Zeichenfolge für alle Auftragstypen, enthält jedoch letztendlich Zusammenfassungsauftragsinformationen wie den Upload-Pfad.

Darüber hinaus sind die folgenden Felder nicht in beiden getJobLogs und getJobLogDetails. In früheren Versionen waren sie nur mit getJobLogDetails.

  • endDate (wenn der Auftrag abgeschlossen wurde).
  • fileDuplicateCount (zuvor war es immer 0 mit getJobLogs)
  • fileUpdateCount (zuvor war immer 0 mit getJobLogs und in fileSuccessCount; jetzt in separate Felder aufgeteilt).

Das Feld assetHandle wurde zu JobLogDetail Typ.

Optionaler Beschreibungsparameter zu submitJob. Dieser Parameter wird zum Abrufen in weitergeleitet. getScheduledJobs, getActiveJobsund getJobLogs.

Das SKU-Systemfeld wurde veraltet. Das Feld wird ignoriert, wenn es als SystemFieldCondition nach searchAssets.

Hinzugefügt excludeAssetTypeArray filtern searchAssets.

Hinzugefügt MaskInfo type to Asset.

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.

Zusätzliche Optionen zu UploadDirectoryJob und UploadUrlsJob zur unabhängigen Steuerung der Verarbeitung von Postscript-, Illustrator- und PDF-Dateien. Alle vorhandenen Aufträge stellen die erforderlichen Parameter für jede der drei Verarbeitungs-Pipelines bereit, damit sie genau wie heute funktionieren. Das Original PostScriptOptions -Block 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

  • Rastern (Standard)

  • Verwalten Sie das Asset nur und erstellen Sie beim Hochladen keine Ableitungen.

  • Rendern Sie die EPS- und PostScript-Datei in ein Bild mit der vorgeschriebenen Auflösung und dem erforderlichen Farbraum.

alpha

Optional.

<boolesch>

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

verarbeiten

  • Keine
  • Rastern (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

verarbeiten

  • Keine

  • Rastern (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

<boolesch>

Definiert, ob nach dem Rendern eine mehrseitige PDF in einen eCatalog kombiniert werden soll (Standard ist "true").

extractSearchWords

<boolesch>

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 eine Abfrage über getScheduledJobs.

Die webservice.gzip.response Konfigurationseigenschaft einen der folgenden Werte annehmen:

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.

Auf dieser Seite