DokumentationDynamic Media Image Production System-API

batchSetImageFields batchsetimagefields

Last update: Thu Dec 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Entwickler
  • Admin

Legt bildspezifische Felder für ein oder mehrere Bild-Assets fest.

Syntax

Autorisierte Benutzertypen section-6b087bdcb7874c13acf76e113a093054

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImagePortalContribUser

Parameter section-4969815cf67c4d11b13bb2017b3604e8

Eingabe (batchSetImageFields)

Name
Typ
Erforderlich
Beschreibung
companyHandle
xsd:string
Ja
Das -Handle an das Unternehmen, das die Bild-Assets enthält.
updateArray
types:ImageFieldUpdateArray
Ja
Das Array von Bildfeldern wird aktualisiert.

Ausgabe (batchSetImageFields)

Name
Typ
Erforderlich
Beschreibung
successCount
xsd:int
Ja
Die Anzahl der erfolgreich festgelegten Bildfelder.
warningCount
xsd:int
Ja
Die Anzahl der Warnhinweise, die generiert wurden, als der Vorgang versucht hat, die Bildfelder festzulegen.
errorCount
xsd:int
Ja
Die Anzahl der Fehler, die beim Versuch erzeugt wurden, die Bildfelder festzulegen.
warningDetailArray
types:AssetOperationFaultArray
Nein
Das Array von Details, die mit den Assets verknüpft sind und Warnungen generiert haben, wenn der Vorgang versucht hat, die Aktualisierungen anzuwenden.
errorDetailArray
types:AssetOperationFaultArray
Nein
Das Array von Details, die mit den Assets verknüpft sind und Fehler generiert haben, als der Vorgang versucht hat, die Aktualisierungen anzuwenden.

Beispiele section-0476e3d6516a4f8bbaac9de983bc6d1e

In diesem Beispiel werden Daten in den Feldern zweier Bilder in einem Aktualisierungs-Array festgelegt. Im Array werden die Bilder durch ihre Asset-Handles angegeben und enthalten Auflösungen in Pixel, x- und y-Position-Ankerkoordinaten und Benutzerdaten. Die Antwort zeigt an, dass die Felder für beide Bilder erfolgreich festgelegt wurden.

Anfrage

<batchSetImageFieldsParam xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <companyHandle>c|21</companyHandle>
   <updateArray>
      <items>
         <assetHandle>a|140626|1|102524</assetHandle>
         <resolution>72</resolution>
         <anchorX>50</anchorX>
         <anchorY>100</anchorY>
         <userData>nada1</userData>
      </items>
      <items>
         <assetHandle>a|96680|1|64865</assetHandle>
         <resolution>150</resolution>
         <anchorX>100</anchorX>
         <anchorY>50</anchorY>
         <userData>nada2</userData>
      </items>
   </updateArray>
</batchSetImageFieldsParam>

Antwort

<batchSetImageFieldsReturn xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <successCount>2</successCount>
   <warningCount>0</warningCount>
   <errorCount>0</errorCount>
</batchSetImageFieldsReturn>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681