Datenorientierte APIs

Datenorientierte APIs ermöglichen es Ihnen, das gesamte Datenmodell anzusprechen.

Übersicht über das Datenmodell

Adobe Campaign bietet keine dedizierte Lese-API pro Entität (keine getRecipient- oder getDelivery-Funktion usw.). Verwenden Sie die Lese- und Änderungsmethoden für die Daten von QUERY & WRITER , um auf die Daten des Modells zuzugreifen.

Mit Adobe Campaign können Sie Sammlungen verwalten: -Abfragen ermöglichen die Wiederherstellung einer Reihe von Informationen, die auf der Basis gesammelt wurden. Im Gegensatz zum Zugriff im SQL-Modus geben Adobe Campaign-APIs eine XML-Baumstruktur anstelle von Datenspalten zurück. Adobe Campaign erstellt so zusammengesetzte Dokumente mit allen erfassten Daten.

Dieser Betriebsmodus bietet keine Eins-zu-Eins-Zuordnung zwischen den Attributen und Elementen der XML-Dokumente und den Spalten der Tabellen in der Datenbank.

XML-Dokumente werden in Feldern vom Typ MEMO der Datenbank gespeichert.

Beschreibung des Modells

Sie müssen mit dem Adobe Campaign-Datenmodell vertraut sein, um die Datenbankfelder in Ihren Skripten ansprechen zu können.

Eine Darstellung des Datenmodells finden Sie in der Beschreibung des Adobe Campaign-Datenmodells.

Informationen zum Generieren der Struktur finden Sie in diesem Artikel: So generieren Sie ein Datenmodell oder ein Datenwörterbuch.

Abfrage und Writer

Das folgende Einführungsschema beschreibt den Austausch auf niedriger Ebene zum Lesen (ExecuteQuery) und Schreiben (Writer) zwischen Datenbank und Kunde (Webseiten oder Adobe Campaign-Clientkonsole).

ExecuteQuery

Für Spalten und Bedingungen können Sie Abfragen verwenden.

Auf diese Weise können Sie die zugrunde liegende SQL isolieren. Die Abfragesprache hängt nicht von der zugrunde liegenden Engine ab: Einige Funktionen werden neu zugeordnet, was mehrere SELECT SQL-Bestellungen generieren kann.

Weitere Informationen hierzu finden Sie unter Beispiel für die Methode 'ExecuteQuery' des Schemas 'xtk:queryDef'.

Die Methode ExecuteQuery wird unter ExecuteQuery (xtk:queryDef) beschrieben.

Schreiben

Mit Schreibbefehlen können Sie einfache oder komplexe Dokumente mit Einträgen in einer oder mehreren Tabellen der Basis schreiben.

Mit Transaktions-APIs können Sie Abstimmungen über den Befehl updateOrInsert verwalten: Mit einem Befehl können Sie Daten erstellen oder aktualisieren. Sie können auch die Änderungszusammenführung (merge) konfigurieren: In diesem Betriebsmodus können Sie Teilaktualisierungen zulassen.

Die XML-Struktur bietet eine logische Ansicht der Daten und ermöglicht es Ihnen, die physische Struktur der SQL-Tabelle zu umgehen.

Die Write-Methode wird unter Write/WriteCollection (xtk:session) beschrieben.

ExecuteQuery (xtk:queryDef)

Auf diese Weise können Sie Abfragen aus Daten durchführen, die mit einem Schema verknüpft sind. Es benötigt eine Authentifizierungszeichenfolge (muss angemeldet sein) und ein XML-Dokument, das die als Parameter zu übermittelnde Abfrage beschreibt. Der Parameter return ist ein XML-Dokument, das das Ergebnis der Abfrage im Format des Schemas enthält, auf das sich die Abfrage bezieht.

Definition der Methode "ExecuteQuery"im Schema "xtk:queryDef":

<method name="ExecuteQuery" const="true">
  <parameters>
    <param desc="Output XML document" name="output" type="DOMDocument" inout="out"/>
  </parameters>
</method>
HINWEIS

Dies ist eine "const"-Methode. Die Eingabeparameter sind in einem XML-Dokument im Format des Schemas "xtk:queryDef" enthalten.

Format des XML-Dokuments der Eingabeabfrage

Die Struktur des XML-Dokuments der Abfrage wird im Schema "xtk:queryDef " beschrieben. In diesem Dokument werden die Klauseln einer SQL-Abfrage beschrieben: "select", "where", "order by", "group by", "having".

<queryDef schema="schema_key" operation="operation_type">
  <select>
    <node expr="expression1">
    <node expr="expression2">
    ...
  </select>
  <where> 
    <condition expr="expression1"/> 
    <condition expr="expression2"/>
    ... 
  </where>
  <orderBy>
    <node expr="expression1">
    <node expr="expression2">
    ...
  </orderBy>
  <groupBy>
    <node expr="expression1">
    <node expr="expression2">
    ...
  </groupBy>
  <having>
    <condition expr="expression1"/> 
    <condition expr="expression2"/>
    ...
  </having>
</queryDef>

Eine Unterabfrage ( <subquery> ) kann in einem <condition> -Element definiert werden. Die Syntax für eine <subquery> -Element basiert auf der Syntax eines <querydef>.

Beispiel eines <subquery> : </subquery>

<condition setOperator="NOT IN" expr="@id" enabledIf="$(/ignored/@ownerType)=1">
  <subQuery schema="xtk:operatorGroup">
     <select>
       <node expr="[@operator-id]" />
     </select>
     <where>
       <condition expr="[@group-id]=$long(../@owner-id)"/>
     </where>
   </subQuery>
</condition>  
  

Eine Abfrage muss auf ein Startschema aus dem Attribut schema verweisen.

Der gewünschte Vorgangstyp wird im Attribut operation eingegeben und enthält einen der folgenden Werte:

  • get: ruft einen Datensatz aus der Tabelle ab und gibt einen Fehler zurück, wenn die Daten nicht vorhanden sind.
  • getIfExists: Ruft einen Datensatz aus der Tabelle ab und gibt ein leeres Dokument zurück, wenn die Daten nicht vorhanden sind;
  • auswählen: erstellt einen Cursor, um mehrere Datensätze zurückzugeben, und gibt ein leeres Dokument zurück, wenn keine Daten vorhanden sind;
  • count: gibt eine Datenanzahl zurück.

Die Syntax XPath wird verwendet, um Daten basierend auf dem Eingabeschema zu lokalisieren. Weitere Informationen zu XPaths finden Sie unter Datenschemata.

Beispiel mit dem 'get'-Vorgang

Ruft den Vor- und Nachnamen eines Empfängers ( Schema "nms:recipient") mit einem Filter für die E-Mail ab.

<queryDef schema="nms:recipient" operation="get">
  <!-- fields to retrieve -->
  <select>
    <node expr="@firstName"/>
    <node expr="@lastName"/>
  </select> 

  <!-- condition on email -->
  <where>  
    <condition expr="@email= 'john.doe@aol.com'"/>
  </where>
</queryDef>

Beispiel mit dem Vorgang "select"

Gibt die Liste der Empfänger zurück, die nach einem Ordner gefiltert wurden, sowie die E-Mail-Domain, deren Sortierung am Geburtsdatum in absteigender Reihenfolge erfolgt.

<queryDef schema="nms:recipient" operation="select">
  <select>
    <node expr="@email"/>
    <!-- builds a string with the concatenation of the last name and first name separated by a dash -->      
    <node expr="@lastName+'-'+@firstName"/>
    <!-- get year of birth date -->
    <node expr="Year(@birthDate)"/>
  </select> 

  <where>  
     <condition expr="[@folder-id] = 1234 and @domain like 'Adobe%'"/>
  </where>

  <!-- order by birth date -->
  <orderBy>
    <node expr="@birthDate" sortDesc="true"/> <!-- by default sortDesc="false" -->
  </orderBy>
</queryDef>

Ausdrücke können einfache Felder oder komplexe Ausdrücke sein, wie arithmetische Vorgänge oder die Verkettung von Zeichenfolgen.

Um die Anzahl der zurückzugebenden Datensätze zu begrenzen, fügen Sie das Attribut lineCount zum Element <querydef> hinzu.

So begrenzen Sie die Anzahl der von der Abfrage zurückgegebenen Datensätze auf 100:

<queryDef schema="nms:recipient" operation="select" lineCount="100">
...

Um die nächsten 100 Datensätze abzurufen, führen Sie dieselbe Abfrage erneut aus und fügen Sie das Attribut startLine hinzu.

<queryDef schema="nms:recipient" operation="select" lineCount="100" startLine="100">
...

Beispiel mit dem 'count'-Vorgang

So zählen Sie die Anzahl an Datensätzen in einer Abfrage:

<queryDef schema="nms:recipient" operation="count"">
  <!-- condition on the folder and domain of the e-mail -->
  <where>  
    <condition expr="[@folder-id] = 1234" and @domain like 'Adobe%'"/>
  </where>
</queryDef>
HINWEIS

Auch hier verwenden wir die Bedingung aus dem vorherigen Beispiel. Die <select>- und -Klauseln werden nicht verwendet. </select>

Nach welchen Kriterien werden die Daten gruppiert

So rufen Sie E-Mail-Adressen ab, auf die mehrmals verwiesen wird:

<queryDef schema="nms:recipient" operation="select">
  <select>
    <node expr="@email"/>
    <node expr="count(@email)"/>
  </select>

  <!-- e-mail grouping clause -->
  <groupby>
    <node expr="@email"/>
  </groupby>

  <!-- grouping condition -->
  <having>
    <condition expr="count(@email) > 1"/>
  </having>

</queryDef>

Die Abfrage kann vereinfacht werden, indem das Attribut groupBy direkt zum zu gruppierenden Feld hinzugefügt wird:

<select>
  <node expr="@email" groupBy="true"/>
</select>
HINWEIS

Es ist nicht mehr erforderlich, das Element <groupby> zu füllen.

Bracken in Bedingungen

Im Folgenden finden Sie zwei Beispiele für die Verwendung von Klammern für dieselbe Bedingung.

  • Die einfache Version in einem einzelnen Ausdruck:

    <where>
      <condition expr="(@age > 15 or @age <= 45) and  (@city = 'Newton' or @city = 'Culver City') "/>
    </where>
    
  • Die strukturierte Version mit <condition> -Elementen:

    <where>
      <condition bool-operator="AND">
        <condition expr="@age > 15" bool-operator="OR"/>
        <condition expr="@age <= 45"/>
      </condition>
      <condition>
        <condition expr="@city = 'Newton'" bool-operator="OR"/>
        <condition expr="@city = 'Culver City'"/>
      </condition>
    </where>
    

Der Operator "OR"kann durch den Vorgang "IN"ersetzt werden, wenn mehrere Bedingungen für dasselbe Feld gelten:

<where>
  <condition>
    <condition expr="@age IN (15, 45)"/>
    <condition expr="@city IN ('Newton', 'Culver City')"/>
  </condition>
</where>

Diese Syntax vereinfacht die Abfrage, wenn mehr als zwei Daten in der Bedingung verwendet werden.

  • Links 1-1 oder N1: Wenn die Tabelle über den Fremdschlüssel verfügt (der Link beginnt in der Tabelle), können die Felder der verknüpften Tabelle gefiltert oder direkt abgerufen werden.

    Beispiel eines Filters für die Ordnername:

    <where>
      <condition expr="[folder/@label] like 'Segment%'"/>
    </where>
    

    So rufen Sie die Felder des Ordners aus dem Schema "nms:recipient"ab:

    <select>
      <!-- label of recipient folder -->
      <node expr="[folder/@label]"/>
      <!-- displays the string count of the folder -->
      <node expr="partition"/>
    </select>
    
  • Sammlungslinks (1N): Die Filterung der Felder einer Kollektionstabelle muss über den Operator EXISTS oder NOT EXISTS erfolgen.

    So filtern Sie die Empfänger, die den Informationsdienst 'Newsletter' abonniert haben:

    <where>
      <condition expr="subscription" setOperator="EXISTS">
        <condition expr="@name = 'Newsletter'"/>
      </condition>
    </where>
    

    Es wird nicht empfohlen, die Felder eines Kollektionslinks direkt aus der <select>-Klausel abzurufen, da die Abfrage ein Kardinalprodukt zurückgibt. Sie wird nur verwendet, wenn die verknüpfte Tabelle nur einen Datensatz enthält (Beispiel: <node expr="">).

    Beispiel für den Kollektionslink "Abonnement":

    <select>
      <node expr="subscription/@label"/>
    </select>
    

    Es ist möglich, eine Unterliste abzurufen, die die Elemente eines Kollektionslinks in der <select>-Klausel enthält. Die XPaths der referenzierten Felder sind kontextuell aus dem Kollektionselement.

    Die Elemente zum Filtern ( <orderby> ) und zur Einschränkung ( <where> ) können dem Kollektionselement hinzugefügt werden.

    In diesem Beispiel gibt die Abfrage für jeden Empfänger die E-Mail-Adresse und die Liste der Informationsdienste zurück, die der Empfänger abonniert:

    <queryDef schema="nms:recipient" operation="select">
      <select>
        <node expr="@email"/>
    
        <!-- collection table (unbound type) -->
        <node expr="subscription">  
          <node expr="[service/@label]"/>    
          <!-- sub-condition on the collection table -->
          <where>  
            <condition expr="@expirationDate >= GetDate()"/>
          </where>
          <orderBy>
            <node expr="@expirationDate"/> 
          </orderBy>
        </node>
      </select> 
    </queryDef>
    

Binden der Parameter der 'where'- und 'select'-Klausel

Durch die Bindung von Parametern kann die Engine die Werte der in der Abfrage verwendeten Parameter festlegen. Dies ist sehr nützlich, da die Engine für die Maskierung von Werten verantwortlich ist und es den zusätzlichen Vorteil eines Caches gibt, damit die Parameter abgerufen werden können.

Wenn eine Abfrage erstellt wird, werden die "gebundenen" Werte durch ein Zeichen (? in ODBC, #[index]# in postgres…) im Text der SQL-Abfrage.

<select>
  <!--the value will be bound by the engine -->
  <node expr="@startDate = #2002/02/01#"/>                   
  <!-- the value will not be bound by the engine but visible directly in the query -->
  <node expr="@startDate = #2002/02/01#" noSqlBind="true"/> 
</select>

Um das Binden eines Parameters zu vermeiden, muss das Attribut "noSqlBind"mit dem Wert "true"ausgefüllt werden.

WICHTIG

Wenn die Abfrage "order-by"- oder "group-by"-Anweisungen enthält, können die Datenbank-Engines keine Werte "binden". Sie müssen das Attribut @noSqlBind="true" in den Anweisungen "select" und/oder "where" der Abfrage platzieren.

Tipp zur Erstellung von Abfragen:

Um die Syntax einer Abfrage zu vereinfachen, können Sie die Abfrage mit dem generischen Abfrageeditor in der Adobe Campaign-Clientkonsole ( Tools/ Generischer Abfrageeditor…) schreiben. Menü). Gehen Sie dazu wie folgt vor:

  1. Wählen Sie die abzurufenden Daten aus:

  2. Definieren Sie die Filterbedingung:

  3. Führen Sie die Abfrage aus und drücken Sie Strg+F4, um den Quellcode der Abfrage anzuzeigen.

Format des Ausgabedokuments

Der Parameter return ist ein XML-Dokument im Format des Schemas, das der Abfrage zugeordnet ist.

Beispiel einer Rückgabe aus dem Schema "nms:recipient"bei einem "get"-Vorgang:

<recipient email="john.doe@adobe.com" lastName"Doe" firstName="John"/>

Bei einem "select"-Vorgang ist das zurückgegebene Dokument eine Auflistung von Elementen:

<!-- the name of the first element does not matter -->
<recipient-collection>   
  <recipient email="john.doe@adobe.com" lastName"Doe" firstName="John"/>
  <recipient email="peter.martinez@adobe.com" lastName"Martinez" firstName="Peter"/>
  <recipient...
</recipient-collection>  

Beispiel eines für den Vorgang vom Typ "count" zurückgegebenen Dokuments:

<recipient count="3"/>

Alias

Mit einem Alias können Sie den Speicherort der Daten im Ausgabedokument ändern. Das Attribut alias muss einen XPath im entsprechenden Feld angeben.

<queryDef schema="nms:recipient" operation="get">
  <select>
    <node expr="@firstName" alias="@firstName"/>
    <node expr="@lastName"/>
    <node expr="[folder/@label]" alias="@My_folder"/>
  </select> 
</queryDef>

Rückgabe:

<recipient My_folder="Recipients" First name ="John" lastName="Doe"/>

Statt:

<recipient firstName="John" lastName="Doe">
  <folder label="Recipients"/>
</recipient>

Beispiel für SOAP-Nachrichten

  • Abfrage:

    <?xml version='1.0' encoding='ISO-8859-1'?>
    <SOAP-ENV:Envelope xmlns:xsd='http://www.w3.org/2001/XMLSchema' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:ns='http://xml.apache.org/xml-soap' xmlns:SOAP-ENV='http://schemas.xmlsoap.org/soap/envelope/'>
      <SOAP-ENV:Body>
        <ExecuteQuery xmlns='urn:xtk:queryDef' SOAP-ENV:encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'>
          <__sessiontoken xsi:type='xsd:string'/>
          <entity xsi:type='ns:Element' SOAP-ENV:encodingStyle='http://xml.apache.org/xml-soap/literalxml'>
            <queryDef operation="get" schema="nms:recipient" xtkschema="xtk:queryDef">
              <select>
                <node expr="@email"/>
                <node expr="@lastName"/>
                <node expr="@firstName"/>
              </select>
              <where>
                <condition expr="@id = 3599"/>
              </where>
            </queryDef>
          </entity>
        </ExecuteQuery>
      </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>
    
  • Antwort:

    <?xml version='1.0' encoding='ISO-8859-1'?>
    <SOAP-ENV:Envelope xmlns:xsd='http://www.w3.org/2001/XMLSchema' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:ns='http://xml.apache.org/xml-soap' xmlns:SOAP-ENV='http://schemas.xmlsoap.org/soap/envelope/'>
      <SOAP-ENV:Body>
        <ExecuteQueryResponse xmlns='urn:xtk:queryDef' SOAP-ENV:encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'>
          <pdomOutput xsi:type='ns:Element' SOAP-ENV:encodingStyle='http://xml.apache.org/xml-soap/literalxml'>
            <recipient email="john.doe@adobe.com" lastName"Doe" firstName="John"/>
          </pdomOutput>
        </ExecuteQueryResponse>
      </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>
    

Write / WriteCollection (xtk:session)

Diese Dienste werden zum Einfügen, Aktualisieren oder Löschen einer Entität ("Write"-Methode) oder einer Sammlung von Entitäten ("WriteCollection"-Methode) verwendet.

Die zu aktualisierenden Entitäten sind mit einem Datenschema verknüpft. Die Eingabeparameter sind eine Authentifizierungszeichenfolge (muss angemeldet sein) und ein XML-Dokument, das die zu aktualisierenden Daten enthält.

Dieses Dokument wird durch Anweisungen zur Konfiguration der Schreibverfahren ergänzt.

Der Aufruf gibt außer Fehlern keine Daten zurück.

Definition der Methoden "Write"und "WriteCollection"im Schema "xtk:session":

<method name="Write" static="true">
  <parameters>
    <param name="doc" type="DOMDocument" desc="Difference document"/>
  </parameters>
</method>
<method name="WriteCollection" static="true">
  <parameters>
    <param name="doc" type="DOMDocument" desc="Difference collection document"/>
  </parameters>
</method>
HINWEIS

Dies ist eine "statische"Methode. Die Eingabeparameter sind in einem XML-Dokument im Format des zu aktualisierenden Schemas enthalten.

Übersicht

Die Abstimmung der Daten basiert auf der Definition der im zugehörigen Schema eingegebenen Schlüssel. Beim Schreiben wird basierend auf den im Eingabedokument eingegebenen Daten nach dem ersten geeigneten Schlüssel gesucht. Die Entität wird je nach ihrer Existenz in der Datenbank hinzugefügt oder aktualisiert.

Der Schlüssel des Schemas der zu aktualisierenden Entität wird anhand des Attributs xtkschema abgeschlossen.

Der Abstimmschlüssel kann daher mit dem Attribut _key erzwungen werden, das die Liste der XPaths enthält, aus denen der Schlüssel besteht (durch Kommas getrennt).

Sie können den Vorgangstyp erzwingen, indem Sie das Attribut _operation mit den folgenden Werten ausfüllen:

  • insert: erzwingt das Einfügen des Datensatzes (der Abstimmschlüssel wird nicht verwendet);
  • insertOrUpdate: aktualisiert oder fügt den Datensatz je nach Abstimmschlüssel ein (Standardmodus),
  • update: aktualisiert den Datensatz; nichts ausführt, wenn die Daten nicht vorhanden sind,
  • Löschen: löscht die Datensätze,
  • none: wird nur zur Abstimmung der Relationen verwendet, ohne Aktualisierung oder Einfügung.

Beispiel mit der Methode "Write"

Aktualisieren oder Einfügen eines Empfängers (impliziter Vorgang "insertOrUpdate") mit E-Mail-Adresse, Geburtsdatum und Ort:

<recipient xtkschema="nms:recipient" email="john.doe@adobe.com" birthDate="1956/05/04" folder-id=1203 _key="@email, [@folder-id]">
  <location city="Newton"/>
</recipient>

Empfänger löschen:

<recipient xtkschema="nms:recipient" _operation="delete" email="rene.dupont@adobe.com" folder-id=1203 _key="@email, [@folder-id]"/>
HINWEIS

Bei einem Löschvorgang darf das Eingabedokument nur die Felder enthalten, aus denen der Abstimmschlüssel besteht.

Beispiel mit der Methode 'WriteCollection'

Aktualisieren oder einfügen für mehrere Empfänger:

<recipient-collection xtkschema="nms:recipient">    
  <recipient email="john.doe@adobe.com" firstName="John" lastName="Doe" _key="@email"/>
  <recipient email="peter.martinez@adobe.com" firstName="Peter" lastName="Martinez" _key="@email"/>
  <recipient ...
</recipient-collection>

Beispiel 1

Zuordnung des Ordners zu einem Empfänger basierend auf seinem internen Namen (@name).

<recipient _key="[folder/@name], @email" email="john.doe@adobe.net" lastName="Doe" firstName="John" xtkschema="nms:recipient">
  <folder name="Folder2" _operation="none"/>
</recipient>

Die Attribute "_key"und "_operation"können in einem verknüpften Element eingegeben werden. Das Verhalten dieses Elements ist mit dem des Hauptelements des Eingabeschemas identisch.

Die Definition des Schlüssels der Hauptentität ("nms:recipient") besteht aus einem Feld aus einer verknüpften Tabelle (Element <folder> Schema "xtk:folder") und der E-Mail.

HINWEIS

Der im Ordnerelement eingegebene Vorgang "none" definiert eine Abstimmung im Ordner ohne Aktualisierung oder Einfügen.

Beispiel 2

Aktualisieren des Unternehmens (verknüpfte Tabelle im Schema "cus:Firma") von einem Empfänger:

<recipient _key="[folder/@name], @email" email="john.doe@adobe.net" lastName="Doe" firstName="John" xtkschema="nms:recipient">
  <company name="adobe" code="ERT12T" _key="@name" _operation="update"/>
</recipient>

Beispiel 3

Hinzufügen eines Empfängers zu einer Gruppe mit der Gruppierungstabelle ("nms:rcpGrpRel"):

<recipient _key="@email" email="martin.ledger@adobe.net" xtkschema="nms:recipient">
  <rcpGrpRel _key="[rcpGroup/@name]">
    <rcpGroup name="GRP1"/>
  </rcpGrpRel>
</recipient>
HINWEIS

Die Definition des Schlüssels wird nicht im Element <rcpgroup> eingegeben, da ein impliziter Schlüssel, der auf dem Gruppennamen basiert, im Schema "nms:group"definiert ist.

XML-Kollektionselemente

Standardmäßig müssen alle Kollektionselemente ausgefüllt werden, um die XML-Kollektionselemente zu aktualisieren. Daten aus der Datenbank werden durch Daten aus dem Eingabedokument ersetzt. Wenn das Dokument nur die zu aktualisierenden Elemente enthält, müssen Sie das Attribut "_operation"für alle zu aktualisierenden Kollektionselemente angeben, um eine Zusammenführung mit den XML-Daten der Datenbank zu erzwingen.

Beispiel für SOAP-Nachrichten

  • Abfrage:

    <?xml version='1.0' encoding='ISO-8859-1'?>
    <SOAP-ENV:Envelope xmlns:xsd='http://www.w3.org/2001/XMLSchema' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:ns='http://xml.apache.org/xml-soap' xmlns:SOAP-ENV='http://schemas.xmlsoap.org/soap/envelope/'>
      <SOAP-ENV:Body>
        <Write xmlns='urn:xtk:persist' SOAP-ENV:encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'>
          <__sessiontoken xsi:type='xsd:string'/>
          <domDoc xsi:type='ns:Element' SOAP-ENV:encodingStyle='http://xml.apache.org/xml-soap/literalxml'>
            <recipient xtkschema="nms:recipient" email="rene.dupont@adobe.com" firstName="René" lastName="Dupont" _key="@email">
          </domDoc>
        </Write>
      </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>
    
  • Antwort:

    <?xml version='1.0' encoding='ISO-8859-1'?>
    <SOAP-ENV:Envelope xmlns:xsd='http://www.w3.org/2001/XMLSchema' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:ns='http://xml.apache.org/xml-soap' xmlns:SOAP-ENV='http://schemas.xmlsoap.org/soap/envelope/'>
      <SOAP-ENV:Body>
        <WriteResponse xmlns='urn:' SOAP-ENV:encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'>
        </WriteResponse>
      </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>
    

    Rückgabe mit Fehler:

    <?xml version='1.0'?>
    <SOAP-ENV:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENV='http://schemas.xmlsoap.org/soap/envelope/'>
      <SOAP-ENV:Body>
        <SOAP-ENV:Fault>
          <faultcode>SOAP-ENV:Server</faultcode>
          <faultstring xsi:type="xsd:string">Error while executing the method 'Write' of service 'xtk:persist'.</faultstring>
          <detail xsi:type="xsd:string">PostgreSQL error: ERROR:  duplicate key violates unique constraint &quot;nmsrecipient_id&quot;Impossible to save document of type 'Recipients (nms:recipient)'</detail>
        </SOAP-ENV:Fault>
      </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>
    

Auf dieser Seite