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

VERWANDTE LINKS

Export-ArticleXml

Export-InvoiceXml

Export-ServiceArticleXml

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.