General Lesen

pixiGetVersions

Liefert die aktuelle und die minimal zulässige Programmversion der Pixi-Client-Anwendungen, optional für einen Client-Namen.

Liest die Versionsinformationen der Client-Programme aus der Tabelle ExeClientVersion.

Wird ClientName weggelassen oder NULL übergeben, werden alle Zeilen der Tabelle geliefert.
Wird ClientName angegeben, werden nur die Zeilen geliefert, deren ClientName exakt dem Wert entspricht.

Jede Zeile enthält den Client-Namen, die neueste verfügbare Version und die minimal zulässige Version, die ein Client haben muss. Eine Sortierung wird nicht festgelegt.

Hinweise

Die Tabelle wird mit NOLOCK gelesen, nicht festgeschriebene Änderungen können sichtbar sein.
Das Ergebnis hat kein ORDER BY; die Reihenfolge der Zeilen ist nicht garantiert.
Ein unbekannter ClientName liefert eine leere Ergebnismenge, keinen Fehler.
Die Datentypen der Spalten sind im Code nicht ersichtlich; sie stammen aus der Tabelle ExeClientVersion.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`ClientName`	varchar(50) string	NULL	Name der Client-Anwendung als Filter (exakte Übereinstimmung). `NULL` liefert alle Clients. Beispiel: `PixiClient`

Antwort

Result-Set 1 · Immer (leer, wenn keine passende Zeile existiert)

Versionsinformationen je Client-Anwendung.

Spalte	Typ	Beschreibung
`ClientName`	string	Name der Client-Anwendung.
`LatestVersion` Kann leer sein	string	Neueste verfügbare Version des Client-Programms.
`MinAllowedVersion` Kann leer sein	string	Minimal zulässige Version des Client-Programms.

Beispielantwort

<SqlRowSet1>
  <row>
    <ClientName>PixiClient</ClientName>
    <LatestVersion>24.3.1.0</LatestVersion>
    <MinAllowedVersion>23.11.0.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:pixiGetVersions>
      <!-- <ClientName>PixiClient</ClientName> -->
    </ns1:pixiGetVersions>
  </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:pixiGetVersions>
      <!-- <ClientName>PixiClient</ClientName> -->
    </ns1:pixiGetVersions>
  </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 = [
    // 'ClientName' => 'PixiClient',
];

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

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

Verwendete Tabellen

ExeClientVersion · Lesen

SQL-Objekt:: dbo.pipiGetVersions