Get-EulandaImportKeyCandidates #

ÜBERSICHT #

Liefert die kuratierte Liste der für einen Import sinnvollen Schlüssel-Spalten je EULANDA-Tabelle.

SYNTAX #

Get-EulandaImportKeyCandidates [-TableName] <string> [<CommonParameters>]

BESCHREIBUNG #

Beim Excel-Import ist die Schlüssel-Spalte (Key) über die ein bestehender Datensatz identifiziert und aktualisiert wird. Nicht jede Spalte ist dafür geeignet - die Eulanda-DB hat einige “mehrdeutige” Felder, die für Anzeige/Suche praktisch sind, aber keine Eindeutigkeit garantieren.

Diese Funktion liefert pro Tabelle die in der Praxis tauglichen Kandidaten. Der Plugin-Aufrufer (EulandaXcel) zeigt die Liste in einer Combo; der Headless-Aufrufer kann die Liste für eigene Validierung nutzen.

Konvention der Properties:

Name : Spalten-Name (case-konsistent mit dem Schema)
IsRecommended : $true für den Standard-Key der Tabelle
IsAmbiguous : $true wenn die Spalte zwar funktionieren kann, aber in vielen DBs nicht zwingend eindeutig ist (z.B. Barcode/ArtMatch). Der Anwender ist dafür verantwortlich, dass die Werte in SEINER DB eindeutig sind.
Hint : kurze Beschreibung für die UI

Aktuell unterstützte Tabellen: Artikel, Adresse.

PARAMETER #

-TableName #

Type: string

EULANDA-Tabellenname (case-insensitiv).

AUSGABEN #

[PSCustomObject[]] - leeres Array wenn die Tabelle nicht in der

kuratierten Liste ist. Caller kann dann auf ein generisches Schema-Listing zurückfallen (Get-EulTableSchema).

BEISPIELE #

Get-EulandaImportKeyCandidates -TableName 'Artikel'
# Name=ArtNummer  IsRecommended=$true  IsAmbiguous=$false
# Name=Barcode    IsRecommended=$false IsAmbiguous=$true
# Name=ArtMatch   IsRecommended=$false IsAmbiguous=$true
# Name=ID         IsRecommended=$false IsAmbiguous=$false

HINWEISE #

Hardcoded-Liste, weil Eulanda-spezifisch. Wer eigene Tabellen importieren will, ergänzt hier - oder übergibt KeyColumns explizit an Import-EulFromExcel.