Services und Konverter

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