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.