Save-EulPluginTemplate #

ÜBERSICHT #

Speichert eine Plugin-Vorlage als Werte-Sammlung in der EULANDA-SQL- Registry. Generisch für beliebige Plugins.

SYNTAX #

Save-EulPluginTemplate [-Conn] <__ComObject> [-PluginName] <string> [-Table] <string> [-Name]
    <string> [-Values] <hashtable>

BESCHREIBUNG #

Pendant zu Get-EulPluginTemplate. Ablageort: \USER\.ALLUSER\PlugIn\<PluginName>\Templates\<Table>\<Name>\.

Werte werden anhand ihres PowerShell-Typs in passende Registry-Typen umgesetzt:

[int] -> REG_DWORD
[bool] -> REG_DWORD (0/1)
[string] -> REG_SZ
[string[]] / sonstige Arrays -> REG_SZ als JSON-Array
Hashtable / PSObject -> REG_SZ als JSON
$null oder leerer String -> Wert wird gelöscht

Bestehendes Template gleichen Namens wird komplett ersetzt: alle Werte die in -Values nicht enthalten sind, werden vorher gelöscht. So gibt es keinen Halbzustand aus altem + neuem Save-Aufruf.

Plugin-Code definiert das fachliche Schema selbst — dieser Helper kennt weder “SupplierMatch” noch “BreadcrumbColumnName”. Pluggable für Datanorm-, CSV-, JSON-Plugins etc.

PARAMETER #

-Conn #

Type: __ComObject

Offene ADODB-Verbindung. Caller-owns-Connection.

-PluginName #

Type: string

Name des Plugins (z.B. EulandaXcel).

-Table #

Type: string

EULANDA-Tabellen-Name (z.B. Adresse, Artikel). Pflicht — Templates sind immer tabellen-bezogen.

-Name #

Type: string

Vorlagen-Name. Frei wählbar, darf keinen Backslash enthalten (verletzt Registry-Pfad).

-Values #

Type: hashtable

Hashtable mit den Werten der Vorlage. Beliebige Schlüssel, Type-Dispatch siehe oben. Keys mit Backslash werden abgelehnt.

AUSGABEN #

[string] - Registry-Pfad des gespeicherten Templates.

BEISPIELE #

Save-EulPluginTemplate -Conn $conn -PluginName 'EulandaXcel' `
  -Table 'Adresse' -Name 'MeineErste' -Values @{
    Columns     = @('Match','Name1','PLZ','Ort')
    KeyColumns  = @('Match')
    Top         = 0
    IncludeBreadcrumbs = $false
    Mode        = 'Upsert'
    Path        = 'C:\Temp\Adresse.xlsx'
    AndPathList = @('\KEYWORDS\BMEcat')
  }

HINWEISE #

Pendants: Get-EulPluginTemplate, Remove-EulPluginTemplate, Get-EulPluginTemplateList, Get-EulPluginRegistryPath.