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.*).