Get-EulandaDmsBaseFolder #

ÜBERSICHT #

Liefert den konfigurierten DMS-Wurzel-Ordner (BaseFolder) aus der EULANDA-Registry. Default: expandiert (%env.X%-Platzhalter werden über die Prozess-Umgebung aufgelöst).

SYNTAX #

Get-EulandaDmsBaseFolder [-Raw] [[-Conn] <__ComObject>] [[-Udl] <string>] [[-ConnStr] <string>]
    [<CommonParameters>]

BESCHREIBUNG #

Liest \VENDOR\esol\MODULES\DMS\BaseFolder aus der SQL-Registry und löst die EULANDA-Custom-Syntax %env.VAR% per Expand-EulandaEnvString auf, sofern der Default-Modus gewaehlt ist.

Mit -Raw wird der Registry-Wert unverändert zurückgegeben, inklusive %env.*%-Platzhalter. Das ist nützlich für Debugging oder wenn der Caller die Expansion anders (oder gar nicht) haben moechte.

Rückgabe $null, wenn der Wert nicht in der Registry gefunden wird (z.B. DMS-Plugin nicht installiert oder fehlerhafte Plugin- Konfiguration). Der Caller sollte daher prüfen:

$base = Get-EulandaDmsBaseFolder -Conn $conn
if (-not $base) { throw "DMS-Plugin nicht eingerichtet" }

Änderungen am BaseFolder kommen in der Praxis nur bei Umzug des DMS-Shares vor – die Funktion ist daher nicht performance-kritisch. Der interne EulandaXtools-RegCache (Hive-Modus) macht wiederholte Aufrufe trotzdem billig.

PARAMETER #

-Raw #

Type: switch

Gibt den unexpandierten Registry-Wert zurück (z.B. %env.EULANDA_DMS%), nicht den aufgelösten Pfad.

-Conn #

Type: __ComObject

Bereits geoeffnete ADODB-Verbindung.

-Udl #

Type: string

UDL-Dateipfad zur Verbindung.

-ConnStr #

Type: string

ADODB-Connection-String zur Verbindung.

AUSGABEN #

string

BEISPIELE #

# Standardaufruf -- expandierten Pfad holen
$base = Get-EulandaDmsBaseFolder -Conn $conn
# -> "\\server\dms$" (wenn EULANDA_DMS so gesetzt ist)

# Template-Form, z.B. für Doku / Weitergabe an anderen Rechner
$tpl = Get-EulandaDmsBaseFolder -Raw -Udl 'C:\Eulanda.udl'
# -> "%env.EULANDA_DMS%"