General Lesen

pixiInfoSettingsHist

Liefert die Änderungshistorie der Pixi-Einstellungen in einem Datumsbereich, neueste Änderungen zuerst, optional auf eine Anzahl Zeilen begrenzt.

Liest das Änderungsprotokoll der Einstellungen aus der Tabelle SettingsHist und liefert eine Zeile je protokollierter Änderung.

Das wirksame Änderungsdatum eines Eintrags ist UpdateDate bzw. CreateDate, falls UpdateDate leer ist. Dieselbe Logik gilt für den Mitarbeiter: UpdateEmp, sonst CreateEmp.
Es werden nur Einträge geliefert, deren wirksames Änderungsdatum zwischen FromDate und ToDate liegt (jeweils einschließlich).
Wird FromDate weggelassen, ist NULL oder liegt das Jahr vor 1990, wird 1970-01-01 verwendet, d. h. es gibt keine untere Grenze.
Wird ToDate weggelassen, ist NULL oder liegt das Jahr vor 1990, wird das aktuelle Datum mit Uhrzeit verwendet.
Die Sortierung erfolgt absteigend nach dem wirksamen Änderungsdatum (neueste zuerst).
Ist Rows größer als 0, werden nur so viele Zeilen geliefert (per SET ROWCOUNT). Bei 0 (Standard) werden alle passenden Zeilen geliefert.

Hinweise

Die Tabelle wird WITH(NOLOCK) gelesen, daher können nicht festgeschriebene Änderungen erscheinen.
ToDate wird inklusive Uhrzeit verglichen. Ein Wert wie 2024-03-31 (Mitternacht) schließt spätere Änderungen dieses Tages aus; für den ganzen Tag 2024-03-31T23:59:59 oder den Folgetag übergeben.
Der Filter auf einen ISNULL-Ausdruck verhindert die Indexnutzung auf den Datumsspalten; bei großen Historientabellen empfehlen sich enge Datumsbereiche oder eine Begrenzung über Rows.
Die genauen Datentypen der Spalten von SettingsHist sind im Code nicht ersichtlich.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`FromDate`	datetime dateTime	NULL	Beginn des Datumsbereichs (einschließlich) für das wirksame Änderungsdatum. `NULL` oder ein Jahr vor 1990 bedeutet keine untere Grenze (`1970-01-01`). Beispiel: `2024-01-01T00:00:00`
`ToDate`	datetime dateTime	NULL	Ende des Datumsbereichs (einschließlich) für das wirksame Änderungsdatum. `NULL` oder ein Jahr vor 1990 bedeutet das aktuelle Datum mit Uhrzeit. Beispiel: `2024-03-31T23:59:59`
`Rows`	int	0	Maximale Anzahl zurückgegebener Zeilen. `0` oder kleiner liefert alle passenden Zeilen. Beispiel: `100`

Antwort

Result-Set 1 · Immer (kann leer sein)

Protokollierte Änderungen von Einstellungen im Datumsbereich, neueste zuerst.

Spalte	Typ	Beschreibung
`SettingName` Kann leer sein	string	Name der geänderten Einstellung.
`OldSettingValue` Kann leer sein	string	Wert der Einstellung vor der Änderung.
`NewSettingValue` Kann leer sein	string	Wert der Einstellung nach der Änderung.
`UpdateDate` Kann leer sein	dateTime	Wirksames Änderungsdatum: `UpdateDate` des Historieneintrags, sonst `CreateDate`.
`CreateEmp` Kann leer sein	string	Mitarbeiter, der die Änderung vorgenommen hat: `UpdateEmp` des Historieneintrags, sonst `CreateEmp`.
`HistRemark` Kann leer sein	string	Zum Historieneintrag gespeicherte Bemerkung.

Beispielantwort

<SqlRowSet1>
  <row>
    <SettingName>DefaultShippingMethod</SettingName>
    <OldSettingValue>DHL</OldSettingValue>
    <NewSettingValue>UPS</NewSettingValue>
    <UpdateDate>2024-03-15T10:42:00</UpdateDate>
    <CreateEmp>MM</CreateEmp>
    <HistRemark>Changed via settings dialog</HistRemark>
  </row>
  <row>
    <SettingName>InvoiceCopies</SettingName>
    <OldSettingValue>1</OldSettingValue>
    <NewSettingValue>2</NewSettingValue>
    <UpdateDate>2024-02-01T08:15:30</UpdateDate>
    <CreateEmp>AB</CreateEmp>
    <HistRemark/>
  </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:pixiInfoSettingsHist>
      <!-- <FromDate>2024-01-01T00:00:00</FromDate> -->
      <!-- <ToDate>2024-03-31T23:59:59</ToDate> -->
      <!-- <Rows>100</Rows> -->
    </ns1:pixiInfoSettingsHist>
  </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:pixiInfoSettingsHist>
      <!-- <FromDate>2024-01-01T00:00:00</FromDate> -->
      <!-- <ToDate>2024-03-31T23:59:59</ToDate> -->
      <!-- <Rows>100</Rows> -->
    </ns1:pixiInfoSettingsHist>
  </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 = [
    // 'FromDate' => '2024-01-01T00:00:00',
    // 'ToDate' => '2024-03-31T23:59:59',
    // 'Rows' => '100',
];

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

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

Verwendete Tabellen

SettingsHist · Lesen

SQL-Objekt:: dbo.pipiInfoSettingsHist