Export Order Xml
Zuletzt geändert: 14.03.2026 05:56

Export-OrderXml #

ÜBERSICHT #

Exportiert einen EULANDA-Auftrag als kommentiertes und strukturiertes XML gemäß EN16931 welches dann per XSLT Transformation in weitere XML-Formate gewandelt werden kann.

SYNTAX #

Export-OrderXml [-Conn] <__ComObject> [[-WorkingDir] <string>] [[-OutputXml] <string>] [[-OrderId]
    <nullable[int]>] [[-OrderNo] <nullable[int]>] [[-XsdFile] <string>] [-ValidateXml]
    [-CommentXml] [<CommonParameters>]

BESCHREIBUNG #

Diese Funktion liest Auftragsdaten aus einer EULANDA-Datenbankverbindung (UDL oder Connection-String), generiert daraus eine strukturierte XML-Datei mit Metadaten und optionalen Kommentaren gemäß dem mitgelieferten XSD-Schema und validiert optional gegen das XSD.

PARAMETER #

-Conn #

Type: __ComObject

Eine aktive ADODB-Verbindung zur EULANDA-Datenbank. Das Connection-Objekt kann über ‘Get-ConnByUdl’ erstellt werden.

-OutputXml #

Type: string
Default: $null

Pfad zur Zieldatei, in die das XML geschrieben wird. Wird relativ zum Skriptpfad aufgelöst.

-OrderId #

Type: nullable[int]
Default: $null

Gibt die ID des Auftrag an. Dies ist der Primärschlüssel in ‘Auftrag’. Hat Vorrang, sollte auch ‘-OrderNo’ sesetzt sein.

-OrderNo #

Type: nullable[int]
Default: $null

Gibt die Auftragsnummer des Datenbankfeldes ‘KopfNummer’ an. Wird auch ‘-OrderId’ übergeben, hat diese Vorrang.

-XsdFile #

Type: string
Default: $null

Pfad zur XSD-Datei, gegen die das erzeugte XML optional validiert wird. Aus der XSD wird aber auch die Feldbeschreibung aus den Kommentaren extrahiert.

-ValidateXml #

Type: switch

Wenn gesetzt, wird das erzeugte XML gegen das angegebene XSD validiert.

AUSGABEN #

string

Der erzeugte XML-Dateiname inkl. Pfad.

BEISPIELE #

# Exportiert die Auftrag-Nr. 12345 als XML und validiert sie gegen das Schema 'eulanda-order.xsd'.
$conn = Get-ConnByUdl -Udl "C:\cfg\eulanda.udl"
Export-OrderXml -Conn $conn -OutputXml ".\output\order.xml" -OrderNo 12345 `
  -XsdFile ".\schema\eulanda-order.xsd" -ValidateXml

HINWEISE #

  • Das XML enthält strukturierte Kommentare, basierend auf dem XSD.
  • Die Daten werden aus EULANDA per ADODB gelesen und vollständig in eine Hashtable überführt.
  • Unterstützt UTF-8 ohne BOM und XML-Deklaration mit Encoding=“UTF-8”.
  • Nutzt ‘Get-CommentMapFromXsd’ und ‘Convert-HashtableToXml’ zur Erzeugung eines dokumentierten XMLs.
  • Die XML-Datei enthält zusätzlich einen Kopfkommentar mit Zeitstempel und Dateiname.