New-Article

EulandaXtools — Funktionsreferenz

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