DokumentationDynamic Media Image Production System-API

batchSetImageFields

Letzte Aktualisierung: 19. Dezember 2024
  • Themen:

Erstellt für:

  • Entwickler
  • Admin

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

Syntax

Autorisierte Benutzertypen

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

Parameter

Eingabe (batchSetImageFields)

NameTypErforderlichBeschreibung
companyHandlexsd:stringJaDas -Handle an das Unternehmen, das die Bild-Assets enthält.
updateArraytypes:ImageFieldUpdateArrayJaDas Array von Bildfeldern wird aktualisiert.

Ausgabe (batchSetImageFields)

NameTypErforderlichBeschreibung
successCountxsd:intJaDie Anzahl der erfolgreich festgelegten Bildfelder.
warningCountxsd:intJaDie Anzahl der Warnhinweise, die generiert wurden, als der Vorgang versucht hat, die Bildfelder festzulegen.
errorCountxsd:intJaDie Anzahl der Fehler, die beim Versuch erzeugt wurden, die Bildfelder festzulegen.
warningDetailArraytypes:AssetOperationFaultArrayNeinDas Array von Details, die mit den Assets verknüpft sind und Warnungen generiert haben, wenn der Vorgang versucht hat, die Aktualisierungen anzuwenden.
errorDetailArraytypes:AssetOperationFaultArrayNeinDas Array von Details, die mit den Assets verknüpft sind und Fehler generiert haben, als der Vorgang versucht hat, die Aktualisierungen anzuwenden.

Beispiele

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