DokumentationCampaignCampaign Classic v7 – Dokumentation

Datenorientierte APIs data-oriented-apis

Last update: Wed Sep 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Entwickler

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

Übersicht über das Datenmodell overview-of-the-datamodel

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.

Adobe Campaign ermöglicht die Verwaltung von Kollektionen: Abfragen ermöglichen den Abruf von auf der Basis erfassten Informationen. 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 description-of-the-model

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.

Abfrage und Writer query-and-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 executequery

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

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

Weiterführende Informationen dazu finden Sie im Abschnitt Beispiel für die Methode "ExecuteQuery"des Schemas "xtk:queryDef".

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

Schreiben write

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: Mit 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) executequery--xtk-querydef-

Mit dieser Methode 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>
NOTE
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 format-of-the-xml-document-of-the-input-query

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 in das 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.
  • select: 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 suchen. Weitere Informationen zu XPaths finden Sie unter Datenschemata.

Beispiel mit dem "get"-Vorgang example-with-the--get--operation

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" example-with-the--select--operation

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 Vorgang "count" example-with-the--count--operation

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 email -->
  <where>
    <condition expr="[@folder-id] = 1234" and @domain like 'Adobe%'"/>
  </where>
</queryDef>
NOTE
Auch hier verwenden wir die Bedingung aus dem vorherigen Beispiel. Die <select> - und -Klauseln werden nicht verwendet. </select>

Datengruppierung data-grouping

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>

  <!-- email 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>
NOTE
Es ist nicht mehr erforderlich, das Element <groupby> zu füllen.

Bremsung unter Bedingungen bracketing-in-conditions

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

  • Die einfache Version in einem einzelnen Ausdruck:

    code language-xml 
    <where>
  <condition expr="(@age > 15 or @age <= 45) and  (@city = 'Newton' or @city = 'Culver City') "/>
</where>

  • Die strukturierte Version mit <condition> -Elementen:

    code language-xml 
    <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 den Fremdschlüssel enthält (der Link beginnt in der Tabelle), können die Felder der verknüpften Tabelle direkt gefiltert oder abgerufen werden.

    Beispiel eines Filters für die Ordnername:

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

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

    code language-xml 
    <select>
  <!-- label of recipient folder -->
  <node expr="[folder/@label]"/>
  <!-- displays the string count of the folder -->
  <node expr="partition"/>
</select>

  • Kollektionslinks (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:

    code language-xml 
    <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":

    code language-xml 
    <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:

    code language-xml 
    <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>

Parameter der 'where'- und 'select'-Klausel binden binding-the-parameters-of-the--where--and--select--clause

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.

IMPORTANT
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.

Ausgabedokumentformat output-document-format

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 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>

Gibt Folgendes zurück:

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

Statt:

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

Beispiel SOAP Nachrichten example-of-soap-messages

  • Abfrage:

    code language-xml 
    <?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:

    code language-xml 
    <?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) 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>
NOTE
Dies ist eine "statische"Methode. Die Eingabeparameter sind in einem XML-Dokument im Format des zu aktualisierenden Schemas enthalten.

Übersicht overview

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 basierend auf dem Attribut 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: forciert 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; macht nichts, wenn die Daten nicht vorhanden sind;
  • delete: löscht die Datensätze,
  • none: Wird nur für die Abstimmung von Links verwendet, ohne Aktualisierung oder Einfügung.

Beispiel mit der Methode "Write" example-with-the--write--method

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]"/>
NOTE
Bei einem Löschvorgang darf das Eingabedokument nur die Felder enthalten, aus denen der Abstimmschlüssel besteht.

Beispiel mit der Methode "WriteCollection" example-with-the--writecollection--method

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 example-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.

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

Beispiel 2 example-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 example-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>
NOTE
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-Erfassungselemente xml-collection-elements

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 SOAP Nachrichten example-of-soap-messages-1

  • Abfrage:

    code language-xml 
    <?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:

    code language-xml 
    <?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:

    code language-xml 
    <?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>
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1