Suppliers Schreiben

pixiDispoClearSOrderlinesOnNEW

Löscht alle Positionen und anschließend die leeren Lieferantenbestellungen im Status NEW, die vom angegebenen Benutzer angelegt wurden.

Bereinigt Lieferantenbestellungen (Disposition), die sich noch im Status NEW (StatusId = 1) befinden, für einen anlegenden Benutzer.

Die Einstellung LogControl_DoNotDeleteOrderlinesOnNew wird gelesen. Ist sie 1, führt der Aufruf nichts aus.
@CreateEmp wird über inf.UserGetByName in eine Benutzer-ID aufgelöst. Ein Ersatzbenutzer wird nicht verwendet.
Alle Zeilen in pixi.SupplierOrderLine werden gelöscht, die zu Lieferantenbestellungen mit StatusId = 1 und RecordCreatedByUserId gleich dieser Benutzer-ID gehören.
Die Lieferantenbestellungen mit StatusId = 1, die von diesem Benutzer angelegt wurden und keine Positionen mehr haben, werden gelöscht.

Betroffen sind nur Bestellungen des angegebenen Benutzers. Bestellungen anderer Benutzer und Bestellungen in anderen Status bleiben unverändert. Der Aufruf liefert keine Ergebnismenge.

Hinweise

Existiert @CreateEmp nicht in UCS_USERS, ist die Benutzer-ID NULL und es wird nichts gelöscht. Eine Rückmeldung erfolgt in diesem Fall nicht.
Fehlt die Einstellung LogControl_DoNotDeleteOrderlinesOnNew, gilt sie als 0, und die Löschung wird ausgeführt.
Beide DELETE-Anweisungen laufen ohne explizite Transaktion. Die Unterabfragen lesen mit NOLOCK.
Die Bestellungen werden mit einer NOT IN-Prüfung gegen alle SupplierOrderId-Werte aus pixi.SupplierOrderLine gelöscht. Hat eine Position eine SupplierOrderId mit NULL, wird keine Bestellung gelöscht.
Eine frühere Löschung der Historie (SOrderlinesHist) ist auskommentiert und wird nicht ausgeführt.
Die Löschung ist endgültig. Der Aufruf liefert keine Zeilen und keine Zeilenanzahl.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`CreateEmp`	varchar(50) string	API	Benutzername (aus `UCS_USERS`), dessen Lieferantenbestellungen im Status NEW samt Positionen gelöscht werden. Beispiel: `API`

Antwort

Dieser Call liefert kein Result-Set.

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:pixiDispoClearSOrderlinesOnNEW>
      <!-- <CreateEmp>API</CreateEmp> -->
    </ns1:pixiDispoClearSOrderlinesOnNEW>
  </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:pixiDispoClearSOrderlinesOnNEW>
      <!-- <CreateEmp>API</CreateEmp> -->
    </ns1:pixiDispoClearSOrderlinesOnNEW>
  </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 = [
    // 'CreateEmp' => 'API',
];

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

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

Verwendete Tabellen

SupplierOrderLine · Schreiben supplierOrder · Schreiben Settings · Lesen UCS_USERS · Lesen

SQL-Objekt:: dbo.pipiDispoClearSOrderlinesOnNEW