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.