Show TOC

UPDATE_INSERT-Anweisung definierenLocate this document in the navigation structure

Verwendung

Verwenden Die das Statement UPDATE_INSERT, um Tabellenwerte zu ändern und hinzuzufügen.

Format der UPDATE_INSERT-Anweisung

<StatementName>

<dbTableName action="UPDATE_INSERT">

<table>realDbTableName</table>

<access>

<col1>val1</col1>

<col2>val2new</col2>

</access>

<key1>

<col2>val2old</col2>

<col4>val4</col4>

</key1>

<key2>

<col2>val2old2</col2>

</key2>

</dbTableName>

</StatementName>

Vorgehensweise
  1. Geben Sie im <access>-Element die neuen Spaltenwerte an.

    Geben Sie genau ein <access>-Element an.

  2. Geben Sie im <key>-Element die Bedingung an, unter der die Datensätze gefunden werden können, deren Spaltenwerte geändert werden sollen.
    • Um Ihre Bedingung zu formulieren, können Sie beliebig viele <key>-Elemente verwenden.
    • Spaltenwerte innerhalb eines <key>-Elements werden mit einem logischen UND kombiniert, verschiedene <key>-Elemente mit einem logischen ODER.
    • Definieren Sie das <key>-Element nicht oder definieren Sie ein leeres <key>-Element, bedeutet das, dass keine Bedingung spezifiziert ist und die gesamte Tabelle verändert werden soll. Wenn Sie diesen Fall ausschließen wollen, dann wählen Sie in der Adapterkonfiguration Key-Tags erforderlich.

      Haben Sie keine Bedingung in den <key>-Elementen formuliert, haben aber Key-Tags erforderlich gewählt, dann führt dies zu einem Fehler in der Message-Verarbeitung mit entsprechender Fehlerausgabe.

    Wenn bei dieser Aktion keine Änderung an der Datenbanktabelle vorgenommen werden kann (die formulierte Bedingung also auf keinen Tabelleneintrag zutrifft), werden die im <access>-Element beschriebenen Werte der Tabelle hinzugefügt, gemäß der Beschreibung für das Statement INSERT. <key>-Elemente werden in diesem Fall ignoriert.

    Siehe: INSERT-Anweisung definieren

Ergebnis

Das Antwortdokument hat folgendes Format, wobei einer der beiden Werte 0 ist, da immer entweder eine UPDATE- oder eine INSERT-Aktion durchgeführt wird:

<update_count>count</update_count>

<insert_count>count</insert_count>