Export-EulandaReport #
ÜBERSICHT #
Rendert einen EULANDA-Report als PDF, TIFF oder anderes Format über ReportXtools.exe.
SYNTAX #
Export-EulandaReport [-Udl] <string> [-Report] <string> [-Object] <string> [-IdList] <string>
[[-Path] <string>] [[-Printer] <string>] [[-Duplex] <string>] [[-Lang] <string>] [[-Letterhead]
<string>] [[-LetterheadFallback] <string>] [[-Profile] <string>] [[-Format] <string>]
[[-Backside] <string>] [[-AddPages] <string>] [-Vacant] [[-Title] <string>] [[-Author]
<string>] [[-Subject] <string>] [[-Keywords] <string>] [[-Watermark] <string>] [[-JpegQuality]
<int>] [[-Compression] <string>] [[-Scale] <double>] [[-Paper] <string>] [[-Tray] <string>]
[[-TrayRest] <string>] [[-Color] <string>] [[-Pages] <string>] [[-Copies] <int>] [-Collate]
[[-Orientation] <string>] [[-PrintScale] <string>] [<CommonParameters>]
BESCHREIBUNG #
Allgemeine Funktion zum Erzeugen von Reports aus EULANDA SQL-Registry-Templates. Nutzt ReportXtools.exe im Unterordner pdf des Moduls.
Unterstützt alle Ausgabeformate (PDF, TIFF, PNG, DOCX etc.), PDF-Metadaten, Wasserzeichen, Briefkopf-Overlay, Rückseiten und zusätzliche Seiten.
Bei Angabe von -Printer wird das erzeugte PDF automatisch gedruckt. Wird nur -Printer ohne -Path angegeben, wird eine temporäre Datei erzeugt, gedruckt und anschließend gelöscht.
PARAMETER #
-Udl #
Type: string
Pfad zur UDL-Datei für die Datenbankverbindung. Pflichtparameter.
-Report #
Type: string
Name des Report-Templates in der SQL-Registry (z.B. “cnsoft.Rechnung.Rechnung”).
-Object #
Type: string
Name des Datenobjekts (z.B. “EULANDA.Rechnung”).
-IdList #
Type: string
Komma-getrennte Liste der Objekt-IDs (z.B. “12345” oder “1,2,3”).
-Path #
Type: string
Vollständiger Ausgabepfad inkl. Dateiendung (z.B. “C:\Belege\RE-123.pdf”). Mindestens -Path oder -Printer muss angegeben werden.
-Printer #
Type: string
Name des Zieldruckers. Wenn angegeben, wird das erzeugte Dokument gedruckt. Ohne -Path wird eine temporäre Datei erzeugt und nach dem Druck gelöscht.
-Duplex #
Type: string
Duplexmodus beim Drucken. Nur in Kombination mit -Printer relevant. Zulässige Werte: none, horizontal, vertical.
-Lang #
Type: string
Zielsprache als 2-Buchstaben-ISO-Code (z.B. “DE”, “EN”, “FR”).
-Letterhead #
Type: string
Name des Briefkopf-Templates oder “none” zum Unterdrücken.
-LetterheadFallback #
Type: string
Briefkopf, den ReportXtools nimmt, wenn nach Formular und Druckerprofil keiner übrig bleibt (Kunden mit vorgedrucktem Papier, Xfacture#81). Greift nie bei -Letterhead none oder einem genannten Briefkopf. Nur ab der ReportXtools-Fassung, die den Schalter kennt; mit einer älteren Exe wird er übergangen (Meldung im Verbose-Strom), alles bleibt wie bisher.
-Profile #
Type: string
Name des Druckerprofils aus der SQL-Registry.
-Format #
Type: string
Ausgabeformat. Standard: pdf (wPDF6).
-Backside #
Type: string
Pfad zu einer PDF-Datei, die als Rückseite nach jeder Seite eingefügt wird.
-AddPages #
Type: string
Semikolon-getrennte PDF-Pfade, die am Ende angefügt werden.
-Vacant #
Type: switch
Fügt eine Leerseite ein, wenn die Seitenzahl ungerade ist (Duplex-Ausrichtung).
-Title #
Type: string
PDF-Metadaten: Dokumenttitel.
-Author #
Type: string
PDF-Metadaten: Autor.
-Subject #
Type: string
PDF-Metadaten: Betreff.
-Keywords #
Type: string
PDF-Metadaten: Schlüsselwörter.
-Watermark #
Type: string
Text für diagonales Wasserzeichen (z.B. “Entwurf”, “Probedruck”).
-JpegQuality #
Type: int
JPEG-Kompressionsqualität (1-100) für RBuilder-PDF.
-Compression #
Type: string
Komprimierungsstufe: none, fast, default, max.
-Scale #
Type: double
Skalierungsfaktor für Bildformate (z.B. 2.0).
-Paper #
Type: string
Papierformat beim Drucken: A4, A5, A6, Letter, Legal, DL, C5, C6, ein Maß wie 62x29mm oder auto für das Format der PDF-Seite. Ohne Angabe A4 wie bisher. Nur mit -Printer; geht an Send-PdfToPrinter, ReportXtools ab 1.8.
-Tray #
Type: string
Schacht (Name oder Nummer) für alle Seiten oder mit -TrayRest für die erste Seite, etwa Briefpapier.
-TrayRest #
Type: string
Schacht ab Seite 2, etwa Normalpapier hinter dem Briefpapier.
-Color #
Type: string
auto oder mono (schwarzweiß).
-Pages #
Type: string
Seitenbereich wie 1-3,5 oder odd/even.
-Copies #
Type: int
Default: 1
Kopien im selben Druckauftrag (1 bis 99).
-Collate #
Type: switch
Kopien sortiert ausgeben.
-Orientation #
Type: string
auto, portrait oder landscape.
-PrintScale #
Type: string
Skalierung beim Drucken: fit (auf den bedruckbaren Bereich, Vorgabe), actual (100 Prozent, für Etiketten) oder shrink (nur verkleinern). Heißt nicht Scale, weil -Scale der Faktor für Bildformate ist.
AUSGABEN #
string
Bei -Path: Pfad zur erzeugten Datei. Bei nur -Printer: $true bei Erfolg, $false bei Fehler.
BEISPIELE #
# Einzelne Rechnung als PDF
Export-EulandaReport -Udl "C:\Data\Prod.udl" `
-Report "cnsoft.Rechnung.Rechnung" -Object "EULANDA.Rechnung" `
-IdList "37476" -Path "C:\Belege\RE-37476.pdf"
# Adressliste mit mehreren IDs
Export-EulandaReport -Udl "C:\Data\Prod.udl" `
-Report "cnsoft.Adresse.Liste" -Object "EULANDA.Adresse" `
-IdList "1,2,3" -Path "C:\Listen\Adressen.pdf"
# Rechnung direkt drucken
Export-EulandaReport -Udl "C:\Data\Prod.udl" `
-Report "cnsoft.Rechnung.Rechnung" -Object "EULANDA.Rechnung" `
-IdList "37476" -Printer "HP LaserJet" -Duplex vertical
# Rechnung auf Briefpapier aus Schacht 2, Folgeseiten aus Schacht 1, zwei Kopien
Export-EulandaReport -Udl "C:\Data\Prod.udl" `
-Report "cnsoft.Rechnung.Rechnung" -Object "EULANDA.Rechnung" `
-IdList "37476" -Printer "Kyocera ECOSYS" -Tray "Kassette 2" -TrayRest "Kassette 1" -Copies 2 -Collate
# PDF erzeugen UND drucken
Export-EulandaReport -Udl "C:\Data\Prod.udl" `
-Report "cnsoft.Rechnung.Rechnung" -Object "EULANDA.Rechnung" `
-IdList "37476" -Path "C:\Belege\RE-37476.pdf" -Printer "HP LaserJet"
# Monatsexport per Pipeline
$ids | ForEach-Object {
Export-EulandaReport -Udl "Prod.udl" -IdList $_ `
-Report "cnsoft.Rechnung.Rechnung" -Object "EULANDA.Rechnung" `
-Path "C:\Belege\RE-$_.pdf"
}
# TIFF-Export mit Wasserzeichen
Export-EulandaReport -Udl "C:\Data\Prod.udl" `
-Report "cnsoft.Rechnung.Rechnung" -Object "EULANDA.Rechnung" `
-IdList "37476" -Path "C:\Belege\RE-37476.tiff" -Format tiff `
-Watermark "Entwurf"
HINWEISE #
Benötigt ReportXtools.exe im Unterordner pdf des Moduls.