General Lesen

pixiGetClientVersion

Liefert die aktuelle Version und die minimal erlaubte Version einer oder aller Pixi-Client-Anwendungen.

Liest die Versionsinformationen der Pixi-Client-Anwendungen aus der Tabelle ExeClientVersion.

Wird Client weggelassen, als NULL oder als Leerstring übergeben, wird für jeden in der Tabelle hinterlegten Client eine Zeile geliefert.
Wird Client angegeben, wird nur die Zeile geliefert, deren ClientName dem übergebenen Wert entspricht. Existiert kein Client mit diesem Namen, ist die Ergebnismenge leer.

Eine Sortierung wird nicht vorgenommen.

Hinweise

Die Tabelle wird mit NOLOCK gelesen, daher können nicht festgeschriebene Änderungen sichtbar sein. Der Vergleich auf ClientName folgt der Sortierung (Collation) der Datenbank (in der Regel ohne Beachtung der Groß-/Kleinschreibung). Die Spaltentypen sind aus dem Code nicht ersichtlich; vermutlich handelt es sich um Versionszeichenketten.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`Client`	varchar(64) string	NULL	Name der Client-Anwendung. Leerstring oder `NULL` liefert alle Clients. Beispiel: `PixiClient`

Antwort

Result-Set 1 · Immer; alle Clients, wenn `Client` leer oder NULL ist, sonst nur der passende Client.

Versionsinformationen je Client-Anwendung.

Spalte	Typ	Beschreibung
`ClientName`	string	Name der Client-Anwendung.
`LatestVersion` Kann leer sein	string	Aktuellste verfügbare Version des Clients.
`MinAllowedVersion` Kann leer sein	string	Minimal noch erlaubte Version des Clients.

Beispielantwort

<SqlRowSet1>
  <row>
    <ClientName>PixiClient</ClientName>
    <LatestVersion>24.10.1</LatestVersion>
    <MinAllowedVersion>24.04.0</MinAllowedVersion>
  </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:pixiGetClientVersion>
      <!-- <Client>PixiClient</Client> -->
    </ns1:pixiGetClientVersion>
  </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:pixiGetClientVersion>
      <!-- <Client>PixiClient</Client> -->
    </ns1:pixiGetClientVersion>
  </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 = [
    // 'Client' => 'PixiClient',
];

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

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

Verwendete Tabellen

ExeClientVersion · Lesen

SQL-Objekt:: dbo.pipiGetClientVersion