Export-ServiceArticleXml

ÜBERSICHT

Exportiert Serviceartikel-Stammdaten aus der EULANDA-Datenbank als XML-Datei.

SYNTAX

Export-ServiceArticleXml [-Conn] <__ComObject> [[-WorkingDir] <string>] [[-OutputXml] <string>]
    [[-ServiceArticleId] <int[]>] [[-ServiceArticleNo] <string[]>] [[-BreadcrumbRoot] <string>]
    [-IncludeBreadcrumbTree] [-IncludeBreadcrumbs] [[-XsdFile] <string>] [-ValidateXml]
    [-CommentXml] [<CommonParameters>]

BESCHREIBUNG

Diese Funktion erstellt aus den EULANDA-Serviceartikeln ein strukturiertes XML-Dokument im Format `EULANDA-servicearticle.xsd`. Es enthält Metadaten (Zeit, Zeitzone, Version) und alle allgemeinen Servicedaten (z. B. Seriennummer, Zustand, Prüfungs- und Garantiedaten, Standort usw.).

Die XML-Ausgabe kann optional kommentiert und gegen ein XSD-Schema validiert werden.

PARAMETER

-Conn

Type: __ComObject

Offene EULANDA ADODB-Verbindung zur SQL-Datenbank.

-WorkingDir

Type: string
Default: $null

Arbeitsverzeichnis für Eingabe- und Ausgabepfade.

-OutputXml

Type: string
Default: $null

Zielpfad der erzeugten XML-Datei. Default: `EULANDA-servicearticle.xml`.

-ServiceArticleId

Type: int[]

Array mit Serviceartikel-IDs (Primärschlüssel in `ServiceArtikel`).

-ServiceArticleNo

Type: string[]

Array mit Servicenummern (`SarNummer`). Wird genutzt, wenn keine IDs angegeben sind.

-BreadcrumbRoot

Type: string
Default: '\'

Pfad des Startknotens für den Merkmalsbaum (z. B. '\Werkstattgeräte'). Dieser Wert legt fest, ab welchem Wurzelpfad die hierarchische Struktur der Merkmale zu den Serviceartikeln in das XML eingefügt wird. Standard ist '\' (alle Merkmale der Tabelle `ServiceArtikel` werden ausgegeben).

-IncludeBreadcrumbTree

Type: switch

Wenn gesetzt, wird der hierarchische Merkmalbaum (Breadcrumb) mit in das XML eingefügt. Standardmäßig wird kein Merkmalbaum angehängt.

-IncludeBreadcrumbs

Type: switch

Wenn gesetzt, werden zu jedem Serviceartikel die zugehörigen Merkmals-Pfade (Breadcrumbs) aus der Tabelle 'Merkmale' geladen und in die jeweilige Serviceartikelstruktur eingefügt. Die Breadcrumbs erscheinen im XML als Abschnitt `…`.

Diese Option wirkt unabhängig von `-IncludeBreadcrumbTree`. Während `-IncludeBreadcrumbs` die individuellen Pfade pro Serviceartikel ergänzt, fügt `-IncludeBreadcrumbTree` einen globalen, hierarchischen Merkmalbaum am Anfang des XML-Dokuments an.

-XsdFile

Type: string
Default: $null

Optionaler Pfad zur XSD-Datei. Default: `.\schema\EULANDA-servicearticle.xsd`.

-ValidateXml

Type: switch

Wenn gesetzt, wird das erzeugte XML gegen das Schema validiert.

-CommentXml

Type: switch

Wenn gesetzt, werden XML-Kommentare aus der XSD eingefügt.

AUSGABEN

string – Pfad der erzeugten XML-Datei.

BEISPIELE

# Exportiert einen Serviceartikel anhand der Nummer
$udl = "C:\Eulanda\EULANDA_1 Mustermann.udl"
$conn = Get-ConnByUdl -Udl $udl
Export-ServiceArticleXml -Conn $conn -ServiceArticleNo 'SAR000001'

# Exportiert mehrere Artikel mit Schema-Validierung und Kommentaren
$udl = "C:\Eulanda\EULANDA_1 Mustermann.udl"
$conn = Get-ConnByUdl -Udl $udl
Export-ServiceArticleXml -Conn $conn -ServiceArticleNo 'SAR000001','SAR000002' -ValidateXml -CommentXml

Export-ServiceArticleXml