DAP Bridge

Kommunikation zwischen FirstSpirit und CXT (über einen REST-Service)

Die FirstSpirit DAP Bridge stellt die Brücke zwischen der CXT-Welt und den Data Access Plugins in FirstSpirit dar.

Durch die Implementierung von Data Access Plugins können externe Quellen (z. B. Webservices) an FirstSpirit-Eingabekomponenten und FirstSpirit-Bedienelemente angebunden werden (siehe dazu auch Datenzugriff (→Online Dokumentation FirstSpirit)).

Über die FirstSpirit DAP Bridge können diese Implementierungen und Datenobjekte aus externen Quellen dann beispielsweise im FragmentCreator referenziert und verwendet werden.

Technisch ist die FirstSpirit DAP Bridge ein REST-Service und kann damit auch auf einem externen Webserver (Apache Tomcat) laufen.

Modul-Datei

dataservice-[version].fsm

Installieren des Moduls

Das Modul wird über den FirstSpirit ServerManager installiert, und zwar im Dialog „Servereigenschaften / Module“ über die Schaltfläche „Installieren“:

(Zu weiteren Informationen zur Installation von Modulen siehe auch Module (→Dokumentation für Administratoren).)

Globale Webanwendung erstellen

Die Webanwendung muss anschließend über den FirstSpirit ServerManager im Bereich „Web-Applikationen“ als eigene, globale Webanwendung definiert und konfiguriert werden (Schaltfläche „Hinzufügen“ bei „Globale Web-Apps konfigurieren“, siehe dazu auch Web-Applikationen (→Dokumentation für Administratoren), Abschnitt „Installieren von globalen Web-Applikationen“).

Der Wert, der in das Feld „Web Context“ eingetragen wurde („Kontextname“, siehe Abbildung rechts), muss als Wert für den Parameter

cxt.dataservice.url

in der Datei web.xml der CXT-Plattform gesetzt werden (siehe Seite Modul "CXT-Plattform"), beispielsweise

<context-param>
   <param-name>cxt.dataservice.url</param-name>
   <param-value>${FIRST_SPIRIT_URL}/cxt</param-value>
</context-param>

Web-Komponente hinzufügen

Für diese globale Web-Applikation muss ein geeigneter Webserver ausgewählt sein, dann die Web-Komponente „DAP Bridge“ hinzugefügt und deployed (Schaltfläche „Installieren“ / „Aktualisieren“) werden.

Siehe dazu auch Web-Applikationen (→Dokumentation für Administratoren).