Übersicht

Get-AddressId #

ÜBERSICHT #

Sucht eine Adresse anhand verschiedener eindeutiger Felder und gibt deren ID zurück.

SYNTAX #

Get-AddressId [[-Match] <string>] [[-Iln] <string>] [[-UstId] <string>] [[-Email] <string>]
    [[-FibuKonto] <string>] [[-FremdRefNr] <string>] [-Conn] <__ComObject> [-Detailed]
    [<CommonParameters>]

BESCHREIBUNG #

Die Adresssuche erfolgt nach festen Prioritätsregeln. Es wird geprüft, ob eines der Schlüsselfelder eindeutig ist, also genau ein Treffer in der Tabelle Adresse. Die Felder werden in folgender Reihenfolge geprüft: 1. Match 2. Iln / Gln 3. UstId 4. Email 5. FibuKonto 6. FremdRefNr Sobald ein Feld genau einen Treffer ergibt, wird dessen ID zurückgegeben. Mehrdeutige oder nicht vorhandene Werte sowie eine ungültige Datenbankverbindung Conn führen zu $null.

PARAMETER #

-Match #

Type: string

Der Adress-Matchcode zur eindeutigen Identifikation.

-Iln #

Type: string

Die Internationale Lokationsnummer (= Iln), auch bekannt als Gln, was gleichzeitig der Alias ist.

-UstId #

Type: string

Die Umsatzsteuer-ID der Adresse.

-Email #

Type: string

Die E-Mail-Adresse der Adresse.

-FibuKonto #

Type: string

Die Debitoren-Nummer aus der Buchhaltung, die der Käuferadresse vom Verkäufer zugewiesen wurde.

-FremdRefNr #

Type: string

Eine Nummer, die vom Käufer für sich vergeben wurde und beim Verkäufer als Referenz verwendet wird.

-Conn #

Type: __ComObject

Ein aktives ADO-Connection-Objekt auf die Datenbank.

-Detailed #

Type: switch

Liefert statt der reinen ID ein Diagnose-Objekt mit den Feldern Id, FieldHits (Trefferanzahl je übergebenem Suchfeld), Ambiguous (Beschreibungen mehrdeutiger Felder inkl. der ersten Kandidaten) und NotFound (Suchfelder ohne Treffer). Damit können Aufrufer präzise Fehlermeldungen bauen, die zwischen “keine Adresse gefunden” und “GLN ist mehreren Adressen zugeordnet” unterscheiden.

AUSGABEN #

nullable[int]

Ohne -Detailed die Adress-ID oder $null. pscustomobject Mit -Detailed ein Objekt mit Id, FieldHits, Ambiguous und NotFound.

BEISPIELE #

# Sucht nach einer Adresse mit Match = 'K123' und gibt deren ID zurück (sofern eindeutig).
Get-AddressId -Match 'K123' -Conn $Conn

# Sucht nach einer Adresse mit der angegebenen USt-IdNr.
Get-AddressId -UstId 'DE123456789' -Conn $Conn

# Sucht nach einer Adresse anhand der drei Felder; falls TEST als Match gefunden wird, hat dies Vorrang.
$buyerInfo = @{
  Match = 'TEST'
  Gln   = '4756021233'
  UstId = 'DE12894500'
}
Get-AddressId @buyerInfo -Conn $Conn

HINWEISE #

• Die Abfrage erfolgt direkt per SQL und erwartet eine EULANDA-Datenbank.
• Bei mehrfachen Treffern pro Kriterium wird kein Ergebnis zurückgegeben; lediglich der erste Einzeltreffer zählt.