Alternative Datengrundlagen verwenden

Datenquelle: Formular(eingang)

Mit dieser Option können die Formulareingänge von Standardformularen - ohne eigens DBM (DataBaseMapping) - als Datenquelle verwendet werden.

Ein Beispiel aus der Praxis sind Informationsveranstaltungen, die von den Veranstaltern via Formular direkt gemeldet und nach erfolgreicher Review publiziert werden. 

1. Als Typ den Wert Formular auswählen
2. In der Dropdownliste das zu verwendende Formular auswählen
3. Den Status festlegen, in welchem die Formulareingänge publiziert werden. Mit dem Komparator sind verschiedene Varianten möglich:
   > 3
   < 200
   = 4
4. Die Standard-Sortierung kann helfen, die Abfrage zu beschleunigen. Standardmässig werden die DB-Einträge nach UUID absteigend unlimitiert ausgelesen. 
   Kolonnen-Name: Bezieht sich auf die DB-Tabelle der Standard-Formulareingänge.
   Gängige Kolonnen: UUID, CREATED, LASTUPDATE
   Auf-/Absteigend: gewünschtes einstellen
   Limit (Anzahl DB-Records): Limitierung der Abfrage auf die Anzahl der Einträge, die für den Usecase nötig sind.  

Datenquelle: Database Mapping (dbm)

Mit dieser Option können die Formulareingänge von Formularen mit einem eigenen DBM (DataBaseMapping) als Datenquelle verwendet werden.

Ein Beispiel aus der Praxis sind Abfragen der bisherigen Formulareingänge zum verhindern von doppelten Anfragen. 

1. Als Typ den Wert Database Mapping (dbm) auswählen
2. In der Dropdownliste die zu verwendende Ressource-ID auswählen (.dbm-Datei aus den Server-Ressourcen)
3. Angabe der Formular-ID aus der Liste der Formulare, die mit dem gewählten DBM verbunden sind
4. Zusätzliche Filter für die DB-Abfrage: Die DB-Einträge können beliebig gefiltert werden. Der Filter kann - falls nicht benötigt - auch leer bleiben.  
5. Die Standard-Sortierung kann helfen, die Abfrage zu beschleunigen. Standardmässig werden die DB-Einträge nach UUID absteigend unlimitiert ausgelesen. 
   Kolonnen-Name: Bezieht sich auf die verwendete DB-Tabelle
   Auf-/Absteigend: gewünschtes einstellen
   Limit (Anzahl DB-Records): Limitierung der Abfrage auf die Anzahl der Einträge, die für den Usecase nötig sind.  

Datenquelle: DB-Tabelle

Mit dieser Option können die Formulareingänge von Formularen mit einem eigenen DBM (DataBaseMapping) als Datenquelle verwendet werden.

Ein Beispiel aus der Praxis sind Abfragen der bisherigen Formulareingänge zum verhindern von doppelten Anfragen. 

1. Als Typ den Wert DB-Tabelle auswählen
2. In der Dropdownliste die zu verwendende DB-Tabelle auswählen
3. Angabe der ID-Kolonne in der Datenbank, meist UUID (Pflichtangabe)
4. Angabe der Kolonne in der Datenbank, die den Zeitpunkt der letzten Änderung enthält, wie LAST_UPDTAE. Damit die Aktualisierungsstrategien sauber greifen, ist diese Angabe zwingend nötig.
5. Zusätzliche Filter für die DB-Abfrage: Die DB-Einträge können beliebig gefiltert werden. Der Filter kann - falls nicht benötigt - auch leer bleiben.  
6. Die Standard-Sortierung kann helfen, die Abfrage zu beschleunigen. Standardmässig werden die DB-Einträge nach UUID absteigend unlimitiert ausgelesen. 
   Kolonnen-Name: Bezieht sich auf die verwendete DB-Tabelle
   Auf-/Absteigend: gewünschtes einstellen
   Limit (Anzahl DB-Records): Limitierung der Abfrage auf die Anzahl der Einträge, die für den Usecase nötig sind.  

Datenquelle: Eigene Implementation

Über den Datenquellen-Typ "Eigene Implementation" kann eine Java-Klasse als Quelle angegeben werden.

So können Daten auf beliebige Art und Weise aufbereitet und publiziert werden (z.B. aus der Datenbank, API, etc.).

Ein Beispiel ist im Mandant STA-STAB im Datapool "sta-stab_aktueller-staatskalender" zu finden.

Java-Klasse

Die Klasse implementiert das Interface com.jaxfront.eforms.datapool.source.DataPoolSource.

Der Konstruktor wird mit den Parametern DataPoolProvider und Element aufgerufen:

public StaatskalenderCustomDataPoolSource(final DataPoolProvider dataPoolProvider, final Element sourceElement) {
	this.dataPoolProvider = dataPoolProvider;
    this.sourceElement = sourceElement;
}

String getGUID()

String getResourceID()

boolean isValid() {

Date getValidFrom()

Collection<String> getAvailableFieldNames()

JSONArray getData(final Collection<DataPoolFilter> filters, final String language)

void reload()

public void reload() {
	dataPoolProvider.resetDisplays();
}

void delete()

void release()

int compareTo(final DataPoolSource o)

Aktualisierungs-Strategie

Die Auswahl der Aktualisierungs-Strategien bei einer eigenen Implementation wird auf folgende Möglichkeiten beschränkt:

• Keine
• Automatisch  
• TimeTriggered
• Manuell

Grund: Die DataPoolSource kann nicht mitteilen, dass Sie sie sich geändert hat. Sie kann lediglich neu geladen werden.

Aktualisierungs-Strategie

Bei alternativen Datengrundlagen kann eingestellt werden, wie die Daten aktualisiert werden sollen.

Möglichkeiten