Platzhalterersetzung (System)
Schnittstelle IPluginSystemReplacer
Verwendungsmöglichkeiten
Eine Implementierung der IPluginSystemReplacer-Schnittstelle ermöglicht es, eigene Ersetzungslogik für den Platzhalter-Ersetzungsprozess von Systemwerten zu integrieren.
Die Eigenimplementierungen werden dabei vor dem internen Platzhaltersetzungsprozess von Xima® Formcycle durchgeführt.
Dadurch ist es beispielsweise möglich Link-Verweis-Ziele, welche durch System-Variablen vorgegeben sind, zu überschreiben und damit auf andere Zieladressen umzuleiten.
Bei der Platzhalterersetzung wird nach folgendem Muster gesucht und durch den entsprechenden Systemwert ersetzt:
Methodensignaturen
Die Plugin-Schnittstelle IPluginSystemReplacer referenziert alle durch die Basis-Schnittstelle IFCPlugin bereitgestellten Methoden
und zusätzlich noch folgende Plugin-spezifische Methodensignaturen:
IPluginSystemReplacerRetVal replace(IPluginSystemReplacerParams 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)
- getEntityContext() aktueller Nutzerkontext, um beispielsweise Datenbankoperationen ausführen zu können
- getWorkflowProcessingContext() Zugriff auf den Workflow-Verarbeitungskontext (IWorkflowProcessingContext) und damit auf zentrale Objekt wie:
- aktueller Vorgang
- Formulardaten
- Sessionparameter
- temporäres Verzeichnis zum Ablegen von Dateien aus dem aktuellen Kontext