General Lesen

pixiGetPixiVersion

Liefert die Einträge des Datenbank-Änderungsprotokolls mit Revisionsnummer, höchste Revision zuerst, zur Ermittlung der installierten Pixi-Version.

Liest das Datenbank-Änderungsprotokoll (DB_change_log) und liefert alle Einträge, deren revision nicht NULL ist.

Der Aufruf hat keine Parameter.
Die Zeilen werden absteigend nach revision sortiert. Die Sortierung erfolgt numerisch je Segment: Die Revisionszeichenkette wird an . aufgeteilt und jedes Segment wird links mit Nullen auf 7 Stellen aufgefüllt, sodass 6.10.2 vor 6.9.15 steht.
Die erste Zeile enthält somit die höchste Revision und kann als aktuelle Pixi-Version verwendet werden.

Hinweise

Die Tabelle wird mit NOLOCK gelesen; nicht festgeschriebene Einträge können daher sichtbar sein.
Es werden alle passenden Zeilen ohne Paging geliefert; das Ergebnis kann umfangreich sein. Wird nur die aktuelle Version benötigt, genügt die erste Zeile.
Segmente mit mehr als 7 Zeichen werden nicht aufgefüllt und können die Sortierung verfälschen. Nicht-numerische Segmente werden als Text sortiert.
Die Spaltentypen sind aus dem Code nicht ersichtlich, da die Definition von DB_change_log nicht beiliegt.

Parameter

Dieser Call hat keine Parameter.

Antwort

Result-Set 1 · Immer

Änderungsprotokolleinträge mit Revision, absteigend nach Revision sortiert (segmentweise numerisch).

Spalte	Typ	Beschreibung
`objectName` Kann leer sein	string	Name des geänderten Datenbankobjekts.
`revision`	string	Revisions- bzw. Versionsnummer der Änderung, punktgetrennt, z. B. `6.20.3`.
`scriptName` Kann leer sein	string	Name des Update-Skripts, das die Änderung eingespielt hat.
`updateEmp` Kann leer sein	string	Mitarbeiter bzw. Benutzer, der die Änderung eingespielt hat.
`updateDate` Kann leer sein	dateTime	Datum und Uhrzeit, zu der die Änderung eingespielt wurde.

Beispielantwort

<SqlRowSet1>
  <row>
    <objectName>pipiGetItemInfo</objectName>
    <revision>23.11.2</revision>
    <scriptName>update_23.11.2.sql</scriptName>
    <updateEmp>dbo</updateEmp>
    <updateDate>2023-11-14T09:12:45.000+01:00</updateDate>
  </row>
  <row>
    <objectName>pipiReadOrder</objectName>
    <revision>23.11.1</revision>
    <scriptName>update_23.11.1.sql</scriptName>
    <updateEmp>dbo</updateEmp>
    <updateDate>2023-11-02T08:30:10.000+01:00</updateDate>
  </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:pixiGetPixiVersion/>
  </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:pixiGetPixiVersion/>
  </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 = [
];

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

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

Verwendete Tabellen

DB_change_log · Lesen

SQL-Objekt:: dbo.pipiGetPixiVersion