Export-InvoicePdf #

ÜBERSICHT #

Exportiert eine einzelne Rechnung aus EULANDA über OLE als PDF-Datei.

SYNTAX #

Export-InvoicePdf [-Conn] <System.__ComObject> [[-PdfFile] <string>] [[-WorkingDir] <string>]
    [[-InvoiceNo] <nullable[int]>] [[-InvoiceID] <nullable[int]>] [<CommonParameters>]

BESCHREIBUNG #

Die Funktion ‘Export-InvoicePdf’ verwendet die EULANDA-OLE-Schnittstelle, um eine einzelne Rechnung als PDF zu exportieren. Die Verbindung zur Datenbank erfolgt über ein offenes COM-Connection-Objekt (ADODB.Connection). Die zu exportierende Rechnung kann über ihre ID oder Nummer identifiziert werden.

Der Zielpfad kann absolut oder relativ zum Arbeitsverzeichnis angegeben werden. Wird kein Pfad übergeben, entscheidet EULANDA selbst über den Dateinamen. Als Arbeitsverzeichnis wird standardmäßig ein Unterverzeichnis unterhalb des System-Temp-Ordners verwendet ‘.\xfacture’.

PARAMETER #

-Conn #

Type: System.__ComObject

Offene ADO-Verbindung zur EULANDA-Datenbank (ADODB.Connection). Die Datenbank muss mit ‘Eulanda_’ beginnen.

-PdfFile #

Type: string
Default: $null

Optionaler Zielpfad für die zu erstellende PDF-Datei. Relativ oder absolut. Wird kein Pfad angegeben, wählt EULANDA den Dateinamen automatisch.

-WorkingDir #

Type: string
Default: $null

Optionales Arbeitsverzeichnis. Wenn nicht angegeben, wird ein Verzeichnis unterhalb von ‘%temp%’ verwendet. Wird ‘.’ angegeben, so wird das aktuelle Verzeichnis verwendet.

-InvoiceNo #

Type: nullable[int]
Default: $null

Rechnungsnummer laut EULANDA. Mindestens -InvoiceNo oder -InvoiceID muss angegeben werden.

-InvoiceID #

Type: nullable[int]
Default: $null

Interne Rechnungs-ID aus der Datenbank. Mindestens -InvoiceNo oder -InvoiceID muss angegeben werden.

AUSGABEN #

Gibt den vollständigen Pfad zur tatsächlich erzeugten PDF-Datei zurück.

BEISPIELE #

# Erzeugt eine PDF für Rechnung 12345 im aktuellen Verzeichnis.
Export-InvoicePdf -Conn $Conn -InvoiceNo 12345 -PdfFile 'rechnung123.pdf'

# Erzeugt eine PDF im Standard-Ausgabeverzeichnis mit automatisch generiertem Namen.
Export-InvoicePdf -Conn $Conn -InvoiceID 42

HINWEISE #

OLE funktioniert nur mit starken EInschränkungen. So darf während des Exports in der im Hintergrund laufenden EULANDA.exe-Anwendung keine Tastatureingabe erwartet werden. Dies bedeutet wenn beim Start des Prozesses Meldungen wie “Datensicherung wurde seit X-Tagen nicht gemacht” oder “Die Seriennummer ist abgelaufen” etc. aufpoppen, dann “verhungert der Prozess”. Dies muss über andere Prozesse überwacht werden.