Get-OrderLineItemData #
ÜBERSICHT #
Lädt strukturierte Auftragspositionen aus der EULANDA-Datenbank.
SYNTAX #
Get-OrderLineItemData [[-Conn] <__ComObject>] [[-OrderId] <nullable[int]>] [[-OrderNo]
<nullable[int]>] [<CommonParameters>]
BESCHREIBUNG #
Diese Funktion liest alle Positionsdaten eines Auftrag aus der Tabelle ‘AuftragPos’ und verknüpften Tabellen. Die Ausgabe ist ein Array von Hashtables unter dem Schlüssel ‘AuftragPos’.
Die Positionsdaten werden dabei aufbereitet: #
- Preise werden auf Einzelstückbasis normalisiert ‘PreisEh = 1.0.
- Rabatte werden getrennt als Wert und Prozentsatz ausgewiesen.
- Sprachabhängige ‘Langtexte’ werden extrahiert und bereinigt.
- Die Felder ‘VkVRab’, ‘VkRab’, ‘RabattBetrag’ und ‘RabattBetragGes’ berücksichtigen die Preiseinheit.
- Die Mengeneinheit ‘MengenEh’ wird auf den UN/ECE-Code normalisiert.
- Die Steuerkategorie wird nach EN16931 Steuerschema (z.B.. „S“, „E“, „Z“) bestimmt.
Optional nicht gesetzte Rabattfelder und Aufschlagskennungen werden entfernt. XML-Felder werden geprüft und führen im Fehlerfall zu einem Abbruch mit Fehlermeldung.
PARAMETER #
-Conn #
Type: __ComObject
Eine aktive ADODB-Verbindung zur EULANDA-Datenbank. Das Connection-Objekt kann über ‘Get-ConnByUdl’ erstellt werden.
-OrderId #
Type: nullable[int]
Default: $null
Gibt die ID des Auftrags an. Dies ist der Primärschlüssel in ‘Auftrag’. Hat Vorrang, sollte auch ‘-OrderNo’ gesetzt sein.
-OrderNo #
Type: nullable[int]
Default: $null
Gibt die Auftragsnummer des Datenbankfeldes ‘KopfNummer’ an. Wird auch ‘-OrderId’ übergeben, hat die Id Vorrang.
AUSGABEN #
hashtable
Ein Dictionary mit einem Schlüssel ‘AuftragPos’, der ein Array strukturierter Positionsdaten enthält.
BEISPIELE #
# Lädt alle Positionen des Auftrags mit Kopf-ID 12345.
Get-OrderLineItemData -Conn $db -OrderId 12345
# Lädt die Positionsdaten des Auftrag mit KopfNummer 20231234.
Get-OrderLineItemData -Conn $db -OrderNo 20231234
HINWEISE #
- Die Funktion berechnet Rabatte und Preise stets auf Einzelbasis.
- Die Positionsbeschreibung ‘Langtext’ wird sprachsensitiv extrahiert.
- Felder wie GTIN, Kundenartikelnummer, Ursprung, Warennummer können bei Bedarf ergänzt werden.
- Diese Funktion ist für den Export in strukturierte XML geeignet.