Expand-OrderNotes

ÜBERSICHT

Fügt der übergebenen Auftragsliste strukturierte Vortext-Informationen aus der Tabelle 'AuftragText' hinzu.

SYNTAX

Expand-OrderNotes [[-OrderList] <ref>] [[-Conn] <__ComObject>] [[-OrderId] <nullable[int]>]
    [[-OrderNo] <nullable[int]>] [<CommonParameters>]

BESCHREIBUNG

Diese Funktion erweitert eine bestehende Hashtable 'OrderList' um strukturierte Vortexteinträge aus der Datenbank. Die Vortextdaten stammen aus der Tabelle 'AuftragText' mit 'TextTyp = 1'. Jeder Eintrag enthält einen 'SubjectCode', optional einen 'ContentCode' sowie den eigentlichen Textinhalt.

Der Vortext wird als Array von Hashtables im Format @{ '@SubjectCode' = 'ABC'; '#text' = '...' } eingefügt. Falls bereits ein Vortext vorhanden ist, wird dieser um die neuen Einträge ergänzt.

PARAMETER

-OrderList

Type: ref

[ref] auf eine bereits vorhandene Hashtable mit dem Knoten '.Auftrag', der um 'Vortext' erweitert wird.

-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 Auftrag 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 diese Vorrang.

AUSGABEN

void

Die Funktion gibt keinen Wert zurück, sondern modifiziert direkt die übergebene Hashtable (OrderList) über einen Referenzparameter ([ref]).

BEISPIELE

# Fügt der übergebenen Auftragsliste die Vortextzeilen aus der Tabelle 'AuftragText' hinzu, die zu Auftrag 12345 gehören.
Expand-OrderNotes -OrderList ([ref]$List) -Conn $Conn -OrderId 12345

VERWANDTE LINKS

Expand-InvoiceNotes

HINWEISE

• Nutzt 'TextTyp = 1' der Datenbank zur Auswahl der Vortexteinträge
• 'Ultrakurztext' wird für das Attribut '@SubjectCode' verwendet, 'Data' für '#text' und optional '@ContentCode'.