Expand-OrderNotes #
Intern – Diese Funktion ist nicht exportiert und nur modulintern verfügbar.
Ü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 #
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’.