New-Address #

ÜBERSICHT #

Legt eine neue Adresse in der EULANDA-Datenbank an.

SYNTAX #

New-Address [[-Fields] <hashtable>] [[-Conn] <__ComObject>] [<CommonParameters>]

BESCHREIBUNG #

Diese Funktion erstellt einen neuen Adressdatensatz in der Tabelle ‘ADRESSE’ auf Basis übergebener Felder. Dabei wird automatisch ein ‘MATCH’-Schlüssel generiert, falls nicht vorhanden. Für die Zuordnung wird nach folgenden Prioritäten gesucht: GLN -> EMAIL -> USTID.

Die Felder ‘IDENT’, ‘STRASSE’ ‘PLZ’, ‘ORT’ etc. werden dynamisch verarbeitet. Der Name (‘IDENT’ wird auf maximal drei Zeilen (Name1-Name3) verteilt. Der ISO-Ländercode wird validiert und über eine SQL-Funktion ‘dbo.cnf_LandISONachLand’ umgewandelt.

PARAMETER #

-Fields #

Type: hashtable

Hashtable mit Adressfeldern, z.B. MATCH, IDENT, STRASSE, PLZ, ORT, LAND, EMAIL usw.

-Conn #

Type: __ComObject

Ein offenes COM-ADO-Connection-Objekt zur EULANDA-Datenbank (z.B. via VBScript oder PowerShell COM).

AUSGABEN #

nullable[int]

Rückgabe ist $null bei fehlendem Pflichtfeld oder Fehler, oder fehlerhafter Datenverbindung.

BEISPIELE #

$Fields = @{
  IDENT = "Max Mustermann"
  STRASSE = "Musterweg 12"
  PLZ = "12345"
  ORT = "Musterstadt"
  LAND = "DE"
  EMAIL = "max@example.com"
}

$id = New-Address -Fields $Fields -Conn $Conn

HINWEISE #

• Es muss mindestens eines der Schlüsselfelder MATCH, GLN, USTID, EMAIL, FIBUKONTO oder FREMDREFNR angegeben sein.
• Das Feld LAND muss ein gültiger zweistelliger ISO-Code sein, sonst erfolgt eine Exception.
• Alle Eingabewerte werden SQL-escaped (außer explizite SQL-Ausdrücke wie dbo.*).