Services und Konverter

Prev Next

Unter Services im Kontext von Lobster Data Platform / Orchestration Formularen und Portalen wird die Technologie zum Beschaffen von Daten für Listenelemente verstanden. Dabei definiert der Service wie die Daten beschafft werden (z.B.: lade Daten von einem _data Profil).

Diese Daten können dann mit Hilfe eines Konverters entsprechend umgewandelt werden, um der benötigten Datenstruktur zu entsprechen.

Elemente, für welche Services konfiguriert werden können bieten im Eigenschaftseditor die Rubrik "Einträge und Service" an. Diese beinhaltet die Funktion "Service Info hinzufügen/entfernen" an.

images/download/attachments/119249449/image2018-7-25_15_37_42-version-1-modificationdate-1670835084838-api-v2.png

Die Abbildung oben zeigt die Service-Konfiguration am Beispiel eines CallProfileService (1), welcher Listendaten über ein Profil lädt.Der Konverter (2) definiert wie die Daten konvertiert werden sollen. Im Beispiel liefert der FixedValuesConverter eine Liste für ein zurückgeliefertes XML oder JSON.

Als Serviceparameter wird für dieses Beispiel das Profil "holeFahrzeugdaten" (3) gerufen, welches die Daten an den Service zurückliefert.Mit der Funktion "Neu laden" (4) kann das Listenelement in der Editoransicht mit der aktuellen Konfiguration befüllt werden. Diese Funktion hat keine Auswirkung auf die ausgeführte Form. Sie dient lediglich zum Auswählen von Standardwerten in der "What you see is what you get" Manier.

Folgende Services sind derzeit verfügbar

Service

Konverter

Daten/Funktionsname

Beschreibung

Beispiel/Anwendung

Statische Werte

FixedValuesConverter

XML oder JSON

Die Combobox kann über eine XML oder JSON Struktur statisch gefüllt werden

Das Listenelement soll statische Werte laden

NoValuesConverter

Geteilter Datenprovider

FixedValuesConverter

Ein Datenservice, welcher von mehreren Komponenten gemeinsam verwendet werden kann.

Siehe auch die Aktion Geteilten Datenprovider setzen

NoValuesConverter

GenericConverter

EntityConverter

DynamicEnumConverter

UnitConverter

TimeZoneConverter

PortalConverter

EnumConverter

EntityIdConverter

GenericDataProvider

DashboardDataProvider

OwnerConverter

Dynamische Aufzählung

Das Listenelement lädt alle Einträge der ausgewählten Aufzählung.

Dabei kann ein Sortiermodus aus der folgenden Auswahl gewählt werden:

  • Sortiermodus: Wert sortiert aufsteigend nach dem internen Namen des Aufzählungselements

  • Sortiermodus: Beschriftung sortiert aufsteigend nach der angezeigten Lokalisierung

  • Sortiermodus: Benutzerdefiniert blendet ein Berechnungsausdrucksfeld ein, welches die Sortierung der Werte festlegen kann. Der Ausdruck muss einen numerischen Wert zurückliefern, welcher die Sortierreihenfolge festlegt. Je höher die Zahl, desto weiter hinten wird der Wert einsortiert. Als Eingabewert dient das Dynamische Aufzählungsobjekt eines Eintrags. Folglich kann über das Feld "configuration" auf die Konfiguration der Aufzählung zugegriffen werden.

Wenn die Werte einer Dynamischen Aufzählung angezeigt werden sollen.

Grundsätzlich besser als "Statische Werte", weil zentral wartbar.

Kann auch durch Dynamische Aufzählungsfilter beeinflusst werden.

Einheiten

Auswahl aller Einheiten

Einheiten global über mehrere Masken verwalten

Zeitzonen

Auswahl Zeitzonen

Zeitzone soll ausgewählt werden (ohne Uhrzeit)

Daten von Profil

FixedValuesConverter

Profilname muss eingeben werden

Rückgabewert des Profils muss die gleiche Struktur wie bei "Statische Werte" haben

XML oder JSON muss zurückgegeben werden

Werte aus einem internen System müssen beim Start des

Formulars geladen werden

NoValuesConverter

GenericConverter

EntityConverter

DynamicEnumConverter

UnitConverter

TimeZoneConverter

PortalConverter

EnumConverter

EntityIdConverter

GenericDataProvider

DashboardDataProvider

OwnerConverter

Datenobjekt

EntityConverter

Datenobjekttyp

Das Listenelement lädt sämtliche Datenobjekte vom definierten Typ, abhängig von der getätigten Such-Konfiguration.

EntityIdConverter

Beim Umgang mit den geladenen Daten liefert der EntityIdConverter nicht das ausgewählte Objekt, sondern nur dessen ID