Get-ArticleId

ÜBERSICHT

Ermittelt die Artikel-ID anhand der Artikel-Nummer, des Artikel-Matchcodes oder des Barcodes.

SYNTAX

Get-ArticleId [[-ArtNummer] <string>] [[-ArtMatch] <string>] [[-Barcode] <string>] [-Conn]
    <__ComObject> [<CommonParameters>]

BESCHREIBUNG

Diese Funktion durchsucht die Tabelle `Artikel` nach einem eindeutigen Treffer anhand der Felder `ArtNummer`, `ArtMatch` oder `Barcode` bzw. dem Alias `Gtin`. Die Reihenfolge der Priorität ist:

1. ArtNummer

2. ArtMatch

3. Barcode

Sobald genau ein Treffer gefunden wurde, wird die zugehörige Artikel-ID zurückgegeben. Falls mehrere oder kein Treffer vorhanden sind, wird `$null´ zurückgegeben. Sollte die Datenbankverbindung `Conn` ungültig sien, wird auch `$null` zurück geliefert und zusätzlich eine Warnung ausgegeben.

PARAMETER

-ArtNummer

Type: string

Die interne Artikelnummer aus dem ERP-System.

-ArtMatch

Type: string

Ein alternativer Suchbegriff, der aber in der SQL-Tabelle mehrdeutig definiert ist.

-Barcode

Type: string

Der Barcode bzw. die `Global Trade Item Number`, also die `Gtin, die gleichzeitig der alais ist.

-Conn

Type: __ComObject

Ein aktives ADO-Connection-Objekt zur SQL-Datenbank.

AUSGABEN

int, void

Liefert die `ID` des Artiekls und im Fehlerfall `$null'.

BEISPIELE

# Gibt die `ID` für den Artikel mit dieser Artikelnummer zurück, diese ist in jedem Fall eindeutig.
Get-ArticleId -ArtNummer '123456' -Conn $conn

# Gibt die ID für den Artikel anhand des mehrdeutigen Felds `BARCODE`. Liefert jedoch `$null` wenn das Ergebnis mehr als einen Treffer liefert.
Get-ArticleId -Gtin '4006381333931' -Conn $conn

HINWEISE

• Die Funktion prüft nacheinander jedes Feld auf einen eindeutigen Treffer.
• Mehrfachtreffer eines Suchfeldes führen zu `$null`.