Get-AddressId

EulandaXtools — Funktionsreferenz

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> [<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.

AUSGABEN

nullable[int]

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