updateTagFieldValues

Aktualisiert Tag-Wörterbuchwerte für ein Tag-Feld.

Syntax

Autorisierte Benutzertypen

  • IpsAdmin
  • IpsCompanyAdmin
  • ImagePortalAdmin

Parameter

Eingabe (updateTagFieldValuesParam)

Name Typ Erforderlich Beschreibung
companyHandle xsd:string Ja Handle des Unternehmens.
fieldHandle xsd:string Ja Tag-Feld-Handle.
updateArray Typen:TagValueUpdateArray Ja Array von Tag-Feldwerten, die Sie aktualisieren möchten.

Hinweis: Aktualisiert nur Tag-Zeichenfolgenwerte. Die Asset-Zuordnungen sind davon nicht betroffen.

Ausgabe (updateTagFieldValuesReturn)

Name Typ Erforderlich Beschreibung
successCount xsd:int Ja Die Anzahl der erfolgreich aktualisierten Tag-Felder.
warningCount xsd:int Ja Die Anzahl der Warnungen, die generiert wurden, wenn der Vorgang versuchte, Tag-Felder zu aktualisieren.
errorCount xsd:int Ja Die Anzahl der Fehler, die bei dem Versuch erzeugt wurden, Tag-Felder zu aktualisieren.
warningDetailArray types:TagValueUpdateFaultArray Nein Das Array von Details, die mit den Assets verknüpft sind, die Warnungen generiert haben, wenn der Vorgang versucht hat, Tag-Felder zu aktualisieren.
errorDetailArray types:TagValueUpdateFaultArray Nein Das Array von Details, die mit den Assets verknüpft sind, die Fehler generiert haben, wenn der Vorgang versucht hat, Tag-Felder zu aktualisieren.

Beispiele

Anforderung

<updateTagFieldValuesParam xmlns="http://www.scene7.com/IpsApi/xsd/2010-01-31">
   <companyHandle>c|3</companyHandle>
   <fieldHandle>m|3|ASSET|SingleFixedTag</fieldHandle>
   <updateArray>
      <items>
         <oldValue>Nurth</oldValue>
         <newValue>North</newValue>
      </items>
      <items>
         <oldValue>Suth</oldValue>
         <newValue>South</newValue>
      </items>
      <items>
         <oldValue>East</oldValue>
         <newValue>West</newValue>
      </items>
      <items>
         <oldValue>Banana</oldValue>
         <newValue>Pear</newValue>
      </items>
   </updateArray>
</updateTagFieldValuesParam>

Antwort

<updateTagFieldValuesReturn xmlns="http://www.scene7.com/IpsApi/xsd/2010-01-31">
   <successCount>2</successCount>
   <warningCount>0</warningCount>
   <errorCount>2</errorCount>
   <errorDetailArray>
      <items>
         <value>East</value>
         <code>30001</code>
         <reason>New tag value 'West' already exists.</reason>
      </items>
      <items>
         <value>Banana</value>
         <code>30001</code>
         <reason>Tag value 'Banana' not found.</reason>
      </items>
   </errorDetailArray>
</updateTagFieldValuesReturn>

Auf dieser Seite