General Lesen

pixiImportGetXML

Liefert den Eintrag des XML-Importprotokolls (`C_XMLLog`) mit Request, Response, Status und Fehlerinformationen zu einem Protokollschlüssel.

Liest einen oder mehrere Datensätze aus der XML-Importprotokolltabelle C_XMLLog.

Eine Zeile wird geliefert, wenn XMLLogKey gleich @XMLLogKey oder @LogKeyXML ist.
Beide Parameter haben dieselbe Wirkung. @LogKeyXML ist ein alternativer Name für denselben Schlüssel. Werden beide mit unterschiedlichen Werten übergeben, können bis zu zwei Protokolleinträge geliefert werden.
Das Ergebnis enthält den Roh-Request und die Roh-Response, deren in XML umgewandelte Fassungen, den Verarbeitungsstatus, den Operationstyp, den Kanal, die Anzahl der Verarbeitungsversuche, Fehlertexte sowie Anlage- und Änderungsinformationen.

Eine Sortierung ist nicht festgelegt.

Hinweise

Die Tabelle wird mit NOLOCK gelesen. Einträge, die gerade verarbeitet werden, können in nicht festgeschriebenem Zustand geliefert werden.
Beide Parameter haben den Standardwert 0. Wird keiner übergeben, passt nur ein Protokolleintrag mit Schlüssel 0, der in der Regel nicht existiert. Das Ergebnis ist dann leer.
Die Definition von C_XMLLog liegt nicht vor. Die Datentypen der Spalten sind daher teilweise unbekannt. XmlRequestXml/XmlResponseXml und die ...CastError...-Spalten enthalten vermutlich das Ergebnis der Umwandlung des Rohtexts in XML sowie einen eventuellen Umwandlungsfehler.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`XMLLogKey`	int	0	Schlüssel des XML-Protokolleintrags (`C_XMLLog.XMLLogKey`), der geliefert werden soll. Beispiel: `123456`
`LogKeyXML`	int	0	Alternativer Parameter für den Protokollschlüssel. Er wird mit `XMLLogKey` per ODER verknüpft. Beispiel: `0`

Antwort

Result-Set 1 · Immer; leer, wenn kein Protokolleintrag zu einem der Schlüssel passt.

Die passenden Einträge des XML-Importprotokolls.

Spalte	Typ	Beschreibung
`XMLLogKey`	int	Schlüssel des Protokolleintrags.
`Source` Kann leer sein	string	Quelle der Importanfrage.
`XMLRequest` Kann leer sein	string	Roh-XML-Request wie gespeichert.
`XMLResponse` Kann leer sein	string	Roh-XML-Response wie gespeichert.
`Status` Kann leer sein	string	Verarbeitungsstatus des Protokolleintrags.
`OperationTypeRef` Kann leer sein	int	Verweis auf den Operationstyp des Imports.
`CreateEmp` Kann leer sein	string	Benutzer, der den Eintrag angelegt hat.
`CreateDate` Kann leer sein	dateTime	Anlagedatum und -uhrzeit.
`UpdateEmp` Kann leer sein	string	Benutzer, der den Eintrag zuletzt geändert hat.
`UpdateDate` Kann leer sein	dateTime	Datum und Uhrzeit der letzten Änderung.
`ChannelRef` Kann leer sein	int	Verweis auf den Vertriebskanal.
`AttemptsToProcess` Kann leer sein	int	Anzahl der Verarbeitungsversuche.
`Error` Kann leer sein	string	Fehlertext aus der Verarbeitung.
`XmlRequestXml` Kann leer sein	xml	In XML umgewandelter Request.
`XmlResponseXml` Kann leer sein	xml	In XML umgewandelte Response.
`XmlRequestCastErrorNr` Kann leer sein	int	Fehlernummer, falls die Umwandlung des Requests in XML fehlgeschlagen ist.
`XmlResponseCastErrorNr` Kann leer sein	int	Fehlernummer, falls die Umwandlung der Response in XML fehlgeschlagen ist.
`XmlRequestCastErrorMessage` Kann leer sein	string	Fehlermeldung, falls die Umwandlung des Requests in XML fehlgeschlagen ist.
`XmlResponseCastErrorMessage` Kann leer sein	string	Fehlermeldung, falls die Umwandlung der Response in XML fehlgeschlagen ist.

Beispielantwort

<SqlRowSet1>
  <row>
    <XMLLogKey>123456</XMLLogKey>
    <Source>Shop</Source>
    <XMLRequest>&lt;Order&gt;...&lt;/Order&gt;</XMLRequest>
    <XMLResponse>&lt;Result&gt;OK&lt;/Result&gt;</XMLResponse>
    <Status>OK</Status>
    <OperationTypeRef>1</OperationTypeRef>
    <CreateEmp>API</CreateEmp>
    <CreateDate>2024-03-15T10:22:31</CreateDate>
    <UpdateEmp>API</UpdateEmp>
    <UpdateDate>2024-03-15T10:22:33</UpdateDate>
    <ChannelRef>2</ChannelRef>
    <AttemptsToProcess>1</AttemptsToProcess>
    <Error/>
    <XmlRequestCastErrorNr>0</XmlRequestCastErrorNr>
    <XmlResponseCastErrorNr>0</XmlResponseCastErrorNr>
  </row>
</SqlRowSet1>

Beispiele

POST https://apigateway.descartes.com/tms/pixi/
Content-Type: text/xml; charset=utf-8
Authorization: Basic BASE64(USERNAME:PASSWORD)

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://apigateway.descartes.com/tms/pixi/">
  <SOAP-ENV:Body>
    <ns1:pixiImportGetXML>
      <!-- <XMLLogKey>123456</XMLLogKey> -->
      <!-- <LogKeyXML>0</LogKeyXML> -->
    </ns1:pixiImportGetXML>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

curl -X POST 'https://apigateway.descartes.com/tms/pixi/' \
  --user 'USERNAME:PASSWORD' \
  --header 'Content-Type: text/xml; charset=utf-8' \
  --data-binary @- <<'XML'
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://apigateway.descartes.com/tms/pixi/">
  <SOAP-ENV:Body>
    <ns1:pixiImportGetXML>
      <!-- <XMLLogKey>123456</XMLLogKey> -->
      <!-- <LogKeyXML>0</LogKeyXML> -->
    </ns1:pixiImportGetXML>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
XML

<?php

$soapClient = new SoapClient(null, [
    'login' => 'USERNAME',
    'password' => 'PASSWORD',
    'location' => 'https://apigateway.descartes.com/tms/pixi/',
    'uri' => 'https://apigateway.descartes.com/tms/pixi/',
]);

$arguments = [
    // 'XMLLogKey' => '123456',
    // 'LogKeyXML' => '0',
];

$soapArguments = [];
foreach ($arguments as $name => $value) {
    $soapArguments[] = new SoapVar($value, XSD_STRING, '', '', $name);
}

$response = $soapClient->__soapCall('pixiImportGetXML', $soapArguments);

Verwendete Tabellen

C_XMLLog · Lesen

SQL-Objekt:: dbo.pipiImportGetXML