Get-ReportTemplate

EulandaXtools — Funktionsreferenz

Get-ReportTemplate

ÜBERSICHT

Liest die Format-Strings (DocumentName, Subject, BodyText) eines EULANDA-Reports aus der SQL-Registry.

SYNTAX

Get-ReportTemplate [-DataObject] <string> [-ReportName] <string> [-Conn] <__ComObject>
    [<CommonParameters>]

BESCHREIBUNG

Greift über die EULANDA SQL-API (cnf_RegPathReadString) auf die Report-Konfiguration im Pfad \OBJECTS\DATAOBJECTS\{DataObject}\Reports\{ReportName} zu und liefert die drei Template-Felder als Hashtable zurück. Diese Felder enthalten Platzhalter-Tokens (z.B. %KopfNummer%, %Adresse.Ident%) die mit Expand-PlaceholderString aufgelöst werden können.

Die SQL-API berücksichtigt automatisch User-Bereiche und Key-Overrides.

PARAMETER

-DataObject

Type: string

Der vollständige DataObject-Name, z.B. 'Eulanda.Rechnung', 'Eulanda.Auftrag', 'Eulanda.Lieferschein', 'Eulanda.Angebot'.

-ReportName

Type: string

Der Report-Name innerhalb des DataObjects, z.B. 'user.Rechnung.Rechnung', 'cnsoft.Auftrag.Auftragsbestaetigung'.

-Conn

Type: __ComObject

Eine aktive ADODB-Verbindung zur EULANDA-Datenbank.

AUSGABEN

hashtable

Hashtable mit den Schlüsseln DocumentName, Subject und BodyText. Gibt $null zurück wenn der Report nicht gefunden wird (alle Felder leer).

BEISPIELE

$tpl = Get-ReportTemplate -DataObject 'Eulanda.Rechnung' -ReportName 'user.Rechnung.Rechnung' -Conn $conn
$tpl.DocumentName  # -> '%VorgangName%-%kopfnummer%'
$tpl.Subject       # -> 'EULANDA E-Rechnung %KopfNummer% ...'
# Zusammenspiel mit Get-PlaceholderContext und Expand-PlaceholderString
$tpl = Get-ReportTemplate -DataObject 'Eulanda.Rechnung' -ReportName 'user.Rechnung.Rechnung' -Conn $conn
$vars = Get-PlaceholderContext -Context 'Invoice' -InvoiceId 57 -Conn $conn
$dateiname = Expand-PlaceholderString -Template $tpl.DocumentName -Variables $vars