Get-Breadcrumbs

ÜBERSICHT

Ermittelt alle Merkmals-Pfade (Breadcrumbs) eines Datensatzes z.B. in Tabelle ARTIKEL aus der EULANDA-Datenbank und gibt sie als XML-Struktur zurück.

SYNTAX

Get-Breadcrumbs [-Id] <int> [[-BreadcrumbRoot] <string>] [-Tablename] <string> [<CommonParameters>]

BESCHREIBUNG

Diese Funktion liest alle hierarchischen Merkmalpfade (sog. Breadcrumbs) zu einem bestimmten Datensatz einer Tabelle, wie ARTIKEL, ADRESSE etc. aus der EULANDA-Datenbank.

Das Ergebnis wird als XML-Text mit einem Wurzelelement `` und einem ``-Element pro Pfad zurückgegeben. Jeder Eintrag enthält das Feld ``, das den vollständigen Breadcrumb-Pfad (z. B. `\Shop\Ersatzteile\Motoren`) beschreibt.

Der zurückgegebene XML-Text ist UTF-8-kodiert und enthält keine XML-Deklaration. Er ist dafür vorgesehen, in ein übergeordnetes XML-Dokument – z. B. einen Artikel- oder Serviceartikel-Export – direkt eingebettet zu werden.

PARAMETER

-Id

Type: int

Primärschlüssel des Datensatzes (z. B. Artikel-ID), für den die Merkmals-Pfade ermittelt werden sollen.

-BreadcrumbRoot

Type: string
Default: '\'

Wurzelpfad, ab dem die Breadcrumb-Struktur beginnt. Standard ist '\'. Typischerweise z. B. '\Shop' oder '\Online'.

-TableName

Type: string

Tabellenname, in dem sich der Datensatz befindet, z. B. 'Artikel' oder 'ServiceArtikel'. Dieser Name wird in der SQL-Abfrage verwendet, um die richtigen Merkmale zu finden.

-Conn

Offene ADODB-Verbindung zur EULANDA-SQL-Datenbank. Sie muss bereits initialisiert und geöffnet sein, andernfalls wird ein Fehler ausgelöst.

AUSGABEN

string

XML-Text im Format: ```xml \Shop\Ersatzteile\Motoren \Shop\Ersatzteile\Getriebe ```

BEISPIELE

# Ermittelt alle Breadcrumb-Pfade für Artikel-ID 100 aus der Tabelle 'Artikel'
$xml = Get-Breadcrumbs -Id 100 -TableName 'Artikel' -BreadcrumbRoot '\Shop' -Conn $conn

# Ermittelt Breadcrumbs eines Serviceartikels und fügt sie später in ein Export-XML ein
$breadcrumbXml = Get-Breadcrumbs -Id 200 -TableName 'ServiceArtikel' -BreadcrumbRoot '\' -Conn $conn
[xml]$serviceXml = "<SERVICEARTIKEL></SERVICEARTIKEL>"

VERWANDTE LINKS

Get-BreadcrumbXml

HINWEISE

• Die Funktion nutzt intern die SQL-Prozedur `cn_MerkOpenPath` und die Funktion `dbo.cnf_merkpfad`.
• Pfade, die auf '.USER' enden, werden automatisch ausgeschlossen.
• Die Ausgabe ist als Text gedacht, nicht als [xml]-Objekt.
• Das Resultat kann direkt in eine bestehende XML-Struktur importiert werden.