Expand-InvoiceNotes #

Intern – Diese Funktion ist nicht exportiert und nur modulintern verfügbar.

ÜBERSICHT #

Fügt der übergebenen Rechnungsliste strukturierte Vortext-Informationen aus der Tabelle ‘RechnungText’ hinzu.

SYNTAX #

Expand-InvoiceNotes [[-InvoiceList] <ref>] [[-Conn] <__ComObject>] [[-InvoiceId] <nullable[int]>]
    [[-InvoiceNo] <nullable[int]>] [<CommonParameters>]

BESCHREIBUNG #

Diese Funktion erweitert eine bestehende Hashtable ‘InvoiceList’ um strukturierte Vortexteinträge aus der Datenbank. Die Vortextdaten stammen aus der Tabelle ‘RechnungText’ 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 #

-InvoiceList #

Type: ref

[ref] auf eine bereits vorhandene Hashtable mit dem Knoten ‘.Rechnung’, der um ‘Vortext’ erweitert wird.

-Conn #

Type: __ComObject

Eine aktive ADODB-Verbindung zur EULANDA-Datenbank. Das Connection-Objekt kann über ‘Get-ConnByUdl’ erstellt werden.

-InvoiceId #

Type: nullable[int]
Default: $null

Gibt die ID der Rechnung an. Dies ist der Primärschlüssel in ‘Rechnung’. Hat Vorrang, sollte auch ‘-InvoiceNo’ gesetzt sein.

-InvoiceNo #

Type: nullable[int]
Default: $null

Gibt die Rechnungsnummer des Datenbankfeldes ‘KopfNummer’ an. Wird auch ‘-InvoiceId’ übergeben, hat die Id Vorrang.

AUSGABEN #

void

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

BEISPIELE #

# Fügt der übergebenen Rechnungsliste die Vortextzeilen aus der Tabelle 'RechnungText' hinzu, die zu Rechnung 12345 gehören.
Expand-InvoiceNotes -InvoiceList ([ref]$List) -Conn $Conn -InvoiceId 12345

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’.