New-SalesOrderLineItem #

ÜBERSICHT #

Fügt eine neue Auftragsposition zu einem bestehenden Auftrag in EULANDA hinzu.

SYNTAX #

New-SalesOrderLineItem [-SalesOrderId] <int> [-ArticleId] <int> [-Quantity] <double> [[-Fields]
    <hashtable>] [-Conn] <__ComObject> [<CommonParameters>]

BESCHREIBUNG #

Die Funktion ‘New-SalesOrderLineItem’ ruft die interne EULANDA-API ‘cn_CreAfp’ auf, um eine neue Auftragsposition (‘AUFTRAGPOS’) zu einem bestehenden Auftrag (‘AUFTRAG’) mit Artikel und Menge hinzuzufügen.

Optional können zusätzliche Felder übergeben werden, die im Anschluss per ‘UPDATE’ direkt in der Tabelle ‘AUFTRAGPOS’ gesetzt werden. Die Funktion konvertiert Werte automatisch in passende SQL-Datentypen (z.B.. Datum, bool, Zahlen).

PARAMETER #

-SalesOrderId #

Type: int

Die ID des vorhandenen Auftrags (Pflichtfeld), zu dem die Position hinzugefügt werden soll.

-ArticleId #

Type: int

Die ID des Artikels, der in dieser Position eingefügt werden soll (Pflichtfeld).

-Quantity #

Type: double

Die Menge des Artikels in dieser Position. Wird in SQL als Invariant-Decimal geschrieben (mit Punkt, nicht Komma).

-Fields #

Type: hashtable
Default: $null

Optionales Hashtable mit weiteren Spalten, die nach Anlage per ‘UPDATE’ gesetzt werden. Unterstützt Typen: ‘string’, ‘bool’, ‘datetime’, ’numeric’.

-Conn #

Type: __ComObject

Ein COM-basiertes ADO-Objekt mit offener Verbindung zur EULANDA-Datenbank.

AUSGABEN #

int

Die ID der neu angelegten Auftragsposition als ‘int’.

BEISPIELE #

$Fields = @{
  POSNUMMER = 10
  VKRAB     = 5.20
  LANGTEXT  = "Ersatzteil ABC"
}
$id = New-SalesOrderLineItem -SalesOrderId 4711 -ArticleId 1000 -Quantity 3 -Fields $Fields -Conn $Conn

HINWEISE #

• Nutzt die interne EULANDA-Prozedur ‘cn_CreAfp’.
• Unterstützt automatische Typkonvertierung für SQL-kompatible UPDATE-Felder.
• Rückgabe ist die ID aus der Tabelle ‘AUFTRAGPOS’.
• Der SQL-Befehl wird dynamisch zusammengesetzt.