Update-SalesOrderLineItems

ÜBERSICHT

Aktualisiert die Auftragspositionen eines vorhandenen Auftrags in EULANDA.

SYNTAX

Update-SalesOrderLineItems [-XmlFile] <string> [-Conn] <__ComObject> [-ReplaceLineItems]
    [-CreateArticle] [<CommonParameters>]

BESCHREIBUNG

Diese Funktion ersetzt oder ergänzt die Positionen eines bestehenden Auftrags. Sie liest die interne Auftrags-ID automatisch aus der XML-Datei anhand der im Knoten hinterlegten Käuferbestellnummer. Der Auftrag muss im System existieren, sonst wird eine Exception geworfen.

Die Funktion wurde ursprünglich für eine Integration mit einer externen Auftragserfassung vorgesehen. Diese bekommt einen leeren Auftrag, der am Handy oder Tablet im Ausseneinsatz erfasst wird.

PARAMETER

-XmlFile

Type: string

Pfad zur EULANDA-AUFTRAG-XML-Datei.

-Conn

Type: __ComObject

Eine aktive COM-Verbindung zur EULANDA-Datenbank.

-ReplaceLineItems

Type: switch

Wenn gesetzt, werden alle vorhandenen Positionen des Auftrags gelöscht, bevor neue Positionen angelegt werden. Dies kann insbesondere dann sinnvoll sein, wenn beim Außeneinsatz ausschließlich tatsächlich erfasste Leistungen berechnet werden sollen, im System jedoch bereits Vorschlagspositionen vorhanden sind.

In einem solchen Szenario könnten die bestehenden Positionen zuvor als Sichtvorlage (z. B. HTML oder PDF) an den Außendienstmitarbeiter übermittelt werden, damit dieser einen Überblick über die vorgesehenen Aufgaben hat.

-CreateArticle

Type: switch

Wenn gesetzt, werden Artikel, die in der Datenbank nicht gefunden werden, automatisch neu angelegt. Ohne diesen Schalter wird eine Exception geworfen, sobald ein Artikel nicht zugeordnet werden kann.

AUSGABEN

[int[]]

Gibt die IDs der neu angelegten Auftragspositionen zurück.

BEISPIELE

# Alle Positionen neu anlegen und alte löschen
$xml = 'C:\EulandaXtools\orders.xml'
Update-SalesOrderLineItems -Conn $conn -XmlFile $xml -ReplaceLineItems

# Nur zusätzliche Positionen hinzufügen
$xml = 'C:\EulandaXtools\orders.xml'
Update-SalesOrderLineItems -Conn $conn -XmlFile $xml