New-Article #

ÜBERSICHT #

Legt einen neuen Artikel in der EULANDA-Datenbank an.

SYNTAX #

New-Article [[-Fields] <hashtable>] [[-Conn] <__ComObject>] [<CommonParameters>]

BESCHREIBUNG #

Diese Funktion erstellt einen neuen Datensatz in der Tabelle ‘ARTIKEL’ auf Basis übergebener Felder. Pflichtfeld ist ‘ARTNUMMER’ Optional können weitere Felder wie ‘GTIN’, ‘IDENT’, ‘VKVRAB’, ‘VERPACKEH’, ‘MENGENEH’, ‘PREISEH’ usw. übergeben werden.

Vor dem Einfügen werden ‘ARTNUMMER’ und ‘ARTMATCH’ standardisiert (Großschreibung, Umlaute ersetzt, Leerzeichen entfernt). Das Feld ‘BruttoFlg’ wird auf 1 gesetzt, falls vorhanden und wahr, sonst auf 0. ‘PREISEH’ wird auf 1 gesetzt, wenn nicht definiert.

Ein Mapping sorgt dafür, dass XML-Feldnamen wie ‘GTIN’ oder ‘VKVRAB’ korrekt in die SQL-Spalten ‘BARCODE’ und ‘VK’ übersetzt werden.

PARAMETER #

-Fields #

Type: hashtable

Hashtable mit Feldern zur Artikelanlage. Mindestanforderung ist ‘ARTNUMMER’. Optional: ‘GTIN’ ‘VKVRAB’, ‘IDENT’, etc.

-Conn #

Type: __ComObject

Ein COM-basiertes ADO-Verbindungsobjekt zur EULANDA-Datenbank.

AUSGABEN #

nullable[int]

Rückgabe ist $null bei fehlendem Pflichtfeld oder Fehler, oder fehlerhafter Datenverbindung.

BEISPIELE #

$Fields = @{
  ARTNUMMER = "4711"
  GTIN      = "4000000004711"
  IDENT     = "Testartikel"
  VKVRAB    = "12.34"
}
$id = New-Article -Fields $Fields -Conn $Conn

HINWEISE #

• ‘ARTNUMMER’ ist Pflichtfeld.
• ‘VKVRAB’ wird als VK-Preis gespeichert.
• Fehlerhafte SQL-Felder werden escaped, Funktionsaufrufe sind nicht erlaubt.