Zum Inhalt springen

Wiki-Quellcode von Multi-Knoten-Mapping

Zuletzt geändert von MACH formsolutions am 15.01.2026
Zeige letzte Bearbeiter
1 **Multi-Knoten** sind Panels, Komponenten oder Bausteine, die im Formulareditor **nur einmal angelegt** aber **beim Ausfüllen mehrfach aufgerufen** werden können.
2
3 Mit dem neuen **Multi-Knoten-Mapping** definieren Sie für dynamisch wiederholte Elemente, wie die erfassten Daten in die Zielstruktur eingeordnet werden. Dazu wählen Sie eine Ebene in der Zielstruktur aus, unter der die wiederholt erfassten Datensätze abgelegt werden. Diese Ebene wird als **Wiederholungsebene** bezeichnet.
4
5
6 **Inhaltsverzeichnis:**
7
8 {{toc start="2"/}}
9
10
11 == Hinweise zur Einführung mit Release 4.111.2 ==
12
13 === Bestehende Assistenten ===
14
15 **Sie müssen nichts tun.**
16 Mit dem Update auf Version 4.111.2 werden Ihre bereits vorhandenen Assistenten konvertiert, so dass sie mit der neuen Funktion Multi-Knoten-Mapping kompatibel sind.
17 Bestehende Mappings werden übernommen und bleiben funktionsfähig.
18 Ihre Assistenten funktionieren nach dem Update weiterhin wie gewohnt.
19
20 === Replikationspause ===
21
22 Mit dem Update auf Version 4.111.2 ändert sich das intern verwendete Datenmodell der Assistenten um die neue Mapping-Logik zu ermöglichen. Das neue Datenmodell ist nicht abwärtskompatibel.
23 Das bedeutet, Assistenten, die mit MACH formsolutions ab Version 4.111.2 erstellt, oder durch das Update konvertiert wurden, können in älteren Software-Versionen von MACH formsolutions nicht dargestellt werden.
24 Deswegen tritt eine Replikationspause in Kraft: Neu erstellte Verlagsformulare und Änderungen des Verlagssortimentes stehen vorübergehend nicht auf Formularservern zur Verfügung, die eine ältere MACH formsolutions Version als 4.111.2 haben.
25 Nach dem Update auf 4.111.2 werden die zwischenzeitlich veränderten Formulare und Assistenten automatisch auf dem Formularserver aktualisiert.
26
27 Link zur Erläuterung der Replikationspause[[https:~~/~~/wiki.machproforms.de/wiki/docwiki/view/Main/13_Release-Notes/Details/Replikationspause/>>url:https://wiki.machproforms.de/wiki/docwiki/view/Main/13_Release-Notes/Details/Replikationspause/]]
28
29
30 == Was ist Multi-Knoten-Mapping ==
31
32 **Multi-Knoten** sind Panels, die eine Kardinalität > 1 haben, sowie Komponenten, Objektgruppen als auch Bausteine, die eine Kardinalität > 1 haben.
33 Kardinalität > 1 bedeutet: das Objekt wird im Formulareditor nur einmal angelegt und kann beim Ausfüllen mehrfach aufgerufen werden.
34 Ein Multi-Knoten beschreibt die Stelle im Baum, an der sich ein Ast in mehrere Instanzen eines gleichen Elements verzweigt bzw. verzweigen kann.
35
36 Der Formulareditor unterstützt die Erfassung von Datensätzen, deren Anzahl zur Laufzeit variieren kann. Das ist mit **Multipanels **und **Komponenten mit Kardinalität** möglich.
37 Es ist nicht notwendig, bereits bei der Formularerstellung die genaue Anzahl der Eingabefelder festzulegen. Stattdessen können bestimmte Datenfelder von der ausfüllenden Person mehrfach angelegt und ausgefüllt werden - innerhalb der definierten minimalen und maximalen Wiederholungsgrenzen.
38
39 Für die Wiedergabe der Daten in einem PDF-Formular oder zur Weiterverarbeitung, zum Beispiel als XML-Daten, wird eine Zuordnung (Mapping) von Eingabedaten auf Ausgabefelder festgelegt.
40 Bei Verwendung von Multipanels und in Multikomponenten stößt die bisher eingesetzte automatische Zuordnungslogik an ihre Grenzen.
41 Mit dem neuen **Multi-Knoten-Mapping** definieren Sie für dynamisch wiederholte Elemente, wie die erfassten Daten in die Zielstruktur eingeordnet werden. Dazu wählen Sie eine Ebene in der Zielstruktur aus, unter der die wiederholt erfassten Datensätze abgelegt werden. Diese Ebene wird als **Wiederholungsebene** bezeichnet.
42
43
44 == Das neue Mapping ==
45
46 Das Standard-Mapping erfolgt voreingestellt auch in Zukunft initial auf der tiefsten Ebene der Zielhierarchie. Wenn Sie keine Einstellungen der Wiederholungsebene vornehmen, entspricht das Mapping dem bisher gewohnten.