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 <MERKMALLISTE><MERKMAL>…</MERKMALLISTE>.

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