Get-PlaceholderContext

EulandaXtools — Funktionsreferenz

Get-PlaceholderContext

ÜBERSICHT

Baut eine flache Variables-Hashtable für Expand-PlaceholderString aus Beleg- und Firmenstammdaten der EULANDA-Datenbank.

SYNTAX

Get-PlaceholderContext [-Context] <string> [-InvoiceId] <int> [-InvoiceNo] <int> [-OrderId] <int>
    [-OrderNo] <int> [-Conn] <__ComObject> [<CommonParameters>]

BESCHREIBUNG

Lädt je nach Kontext (Invoice, Order) die Beleg- und Adressdaten über die bestehenden Get-InvoiceData bzw. Get-OrderData Funktionen und ergänzt die Firmenstammdaten über Get-CompanyMasterData. Die verschachtelten Hashtables werden mit Punkt-Notation flach gemappt, sodass sie direkt als Variables-Parameter für Expand-PlaceholderString verwendbar sind.

Variablennamen folgen der Delphi-Konvention (ReplaceObjectValues):

PARAMETER

-Context

Type: string

Der Belegtyp. Bestimmt welche Get-*Data-Funktion aufgerufen wird.

-InvoiceId

Type: int

Die interne ID der Rechnung (Primärschlüssel). Nur für Context 'Invoice'.

-InvoiceNo

Type: int

Die Rechnungsnummer (KopfNummer). Nur für Context 'Invoice'.

-OrderId

Type: int

Die interne ID des Auftrags (Primärschlüssel). Nur für Context 'Order'.

-OrderNo

Type: int

Die Auftragsnummer (KopfNummer). Nur für Context 'Order'.

-Conn

Type: __ComObject

Eine aktive ADODB-Verbindung zur EULANDA-Datenbank.

AUSGABEN

hashtable

Flache Hashtable mit allen Platzhalter-Variablen für den jeweiligen Kontext. Gibt $null zurück wenn der Beleg nicht gefunden wird.

BEISPIELE

$vars = Get-PlaceholderContext -Context 'Invoice' -InvoiceId 57 -Conn $conn
Expand-PlaceholderString -Template 'Rechnung %KopfNummer% an %Adresse.Ident%' -Variables $vars
$vars = Get-PlaceholderContext -Context 'Order' -OrderNo 20212869 -Conn $conn
Expand-PlaceholderString -Template 'Auftrag %KopfNummer% vom %FDdd.mm.yyyy:Datum%' -Variables $vars