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 Connungü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.