Get-EulTable #
ÜBERSICHT #
Liest Daten aus einer EULANDA-Tabelle als PSObject-Array.
SYNTAX #
Get-EulTable [-Conn] <__ComObject> [-Table] <string> [[-Columns] <string[]>] [[-Where] <string>]
[[-OrderBy] <string>] [[-Top] <int>] [<CommonParameters>]
BESCHREIBUNG #
Generischer SELECT-Wrapper für Plugin-Skripte. Liefert Zeilen einer Tabelle als typisierte PSCustomObject-Liste. Spalten, WHERE-Filter, ORDER BY und TOP können optional eingegrenzt werden.
Der SELECT wird gegen die übergebene ADODB.Connection ausgeführt (Caller-owns-Connection). Werte vom Typ DBNull werden zu $null normalisiert, damit nachgelagerte Excel-Exporte sauber laufen.
Tabellenname, Spalten und WHERE-Klausel werden NICHT validiert – Plugin-Autor ist für Vertrauenswürdigkeit der Eingabe verantwortlich. Eulanda-Plugin-Kontext, kein End-User-SQL.
PARAMETER #
-Conn #
Type: __ComObject
ADODB.Connection-Objekt zur EULANDA-Datenbank. Caller-owns-Connection, wird NICHT geschlossen.
-Table #
Type: string
Tabellenname (z.B. ‘Artikel’, ‘Adresse’).
-Columns #
Type: string[]
Spaltenliste. Default: ‘*’ (alle Spalten).
-Where #
Type: string
Optionale WHERE-Klausel OHNE Schlüsselwort. Beispiel: “ArtNummer LIKE ‘A%’ AND Aktiv_Flg = 1”.
-OrderBy #
Type: string
Optionale ORDER BY-Klausel OHNE Schlüsselwort. Beispiel: “ArtNummer ASC”.
-Top #
Type: int
Default: 0
Maximale Zeilenanzahl. 0 = unbegrenzt (Default).
AUSGABEN #
[PSCustomObject[]] – eine Zeile je Datensatz, Spaltennamen als
Property-Namen.
BEISPIELE #
$conn = Get-ConnByUdl -Udl 'C:\Eulanda\EULANDA_1 Mustermann.udl'
Get-EulTable -Conn $conn -Table 'Artikel' -Top 10 |
Format-Table ArtNummer, Kurztext1, Vk
Get-EulTable -Conn $conn -Table 'Artikel' `
-Columns 'ID', 'ArtNummer', 'Kurztext1', 'Vk' `
-Where "Aktiv_Flg = 1 AND ArtNummer LIKE 'A%'" `
-OrderBy 'ArtNummer ASC'
HINWEISE #
Phase 4 Tier 1 – DB-Bausteine für Excel-Pipeline. Wird von Export-EulToExcel (Tier 2) und ABO-/Reporting-Skripten genutzt.