Platzhalterersetzung (Formularwerte)
IPluginFormReplacer
Verwendungsmöglichkeiten
Eine Implementierung der Schnittstelle IPluginFormReplacer ermöglicht es, eigene Ersetzungslogik für den Platzhalter-Ersetzungsprozess von Formularelementen zu integrieren.
Die Eigenimplementierungen werden dabei vor dem internen Platzhaltersetzungsprozess von Xima® Formcycle durchgeführt.
Dadurch ist es beispielsweise auch möglich, systeminterne Formularplatzhalter durch eine Eigenimplementierung zu ersetzen.
Bei der Ausführung der Platzhalter-Ersetzung wird nach folgendem Muster gesucht und der Platzhalter durch den entsprechenden Formularwert ersetzt:
Methodensignaturen
Die Plugin-Schnittstelle IPuginFormReplacer referenziert alle durch die Basis-Schnittstelle IFCPlugin bereitgestellten Methoden
und zusätzlich noch folgende Plugin-spezifische Methodensignaturen:
IPluginFormReplacerRetVal replace(IPluginFormReplacerParams params) throws FCPluginException
- getPlaceholder() kompletten String des Platzhalters (dies schließt den Markup des Platzhalters mit ein)
- getPlaceholderContent() Inhalt des Platzhalters (ohne typ-spezifischen Markup)
- getFormversion() die aktuelle Formular-Version
- getFormDataAdapter() den Formular-Daten-Adapter, als Schnittstelle zu den konkreten Formulardaten sowie deren Beschreibung
- isEncodeForHTML() Flag welches bestimmt, ob die Rückgabe HTML-konform codiert werden soll
- getEntityContext() aktueller Nutzerkontext, um beispielsweise Datenbankoperationen ausführen zu können