Nuclos XML Strukturdefinition: XPath, Struktur Match, Attribut Match, xpath2value, well-formed, mixed content, XML Import.

globe with meridians Sprache: Deutsch · English

open book XML Strukturdefinition

XML auf Businessobjekte mappen – Struktur-/Attribut-Match, xpath2value und die Grenzen des XML-Imports.

Auf dieser Seite

XML-Import in Nuclos

Der XML-Import orientiert sich stark an der CSV-Strukturdefinition; hier gehen wir nur auf die Unterschiede ein. Es gibt XML-Strukturdefinitionen (Mapping je BO) und den XML-Datei-Import (Reihenfolge).

XML-Strukturdefinition

AngabeBedeutung
Match (Struktur)einfacher XPath, der die Attributverarbeitung triggert.
Businessobjektdas BO, das erzeugt/aktualisiert/gelöscht wird.
Match (Attribut)XPath relativ zum Struktur-Match, wählt den zu übertragenden Knoten.
Attribut (BO)Zielfeld für den extrahierten Wert.
BerechnungsausdruckGroovy-Script mit xpath2value (Map), line, log – z.​B. um einen Wert aus mehreren Knoten zusammenzusetzen.
Formatwie beim CSV-Import; nur ohne Script wirksam.

Ablauf des XML-Datei-Imports

  1. Je Strukturdefinition wird die XML-Datei einmal komplett gelesen.
  2. Beim Struktur-Match wird der eingeschlossene Teilbaum als Map (relativer XPath → Wert) aufgebaut.
  3. Attributwerte werden über den Attribut-Match als Schlüssel aus der Map gewonnen.
  4. Optional stellt ein Berechnungsausdruck die Map als xpath2value bereit.
  5. Genau ein Attribut-Match darf „nach außen greifen“ (Attribute/direkte Kinder der Eltern des Struktur-Matches).

Einschränkungen: Die Datei muss well-formed sein (kein Schema nötig/möglich); mixed content wird nicht unterstützt (ein Element enthält entweder Text oder Kindelemente); die Daten eines BOs müssen in einem zusammenhängenden Teilbaum liegen und werden komplett in den Speicher geladen – also klein halten. Für tief verschachtelte Strukturen ist der XML-Import ungeeignet.

Verwandte Seiten

clipboard Strukturdefinition

CSV-Variante.

Öffnen →

electric plug Objektimport

Import ausführen.

Öffnen →