Services and converters
Services in the context of Lobster Data Platform / Orchestration forms and portals are understood as the technology for retrieving data for list elements. The service defines how the data is retrieved (e.g. load data from a _data profile).
This data can then be transformed by a converter to match the required data structure.
Elements for which services can be configured offer the category 'Entries and service' in the property editor. This contains the function 'Add/Remove service info'.
The image above shows the Service configuration using the example of a 'CallProfileService' (1), which loads list data via a profile.
The Converter (2) defines how the data should be transformed. In the example the 'FixedValuesConverter' returns a list for a returned XML or JSON.
The profile 'holeVehicle data' (3) is called as a service parameter for this example, which returns the data to the service.
With the Refresh (4) function, the list element in the editor view can be filled with the current configuration. This function has no effect on the executed form. It is only used to select default values in a 'What you see is what you get' manner.
The following services are currently available
|
Service |
Convertor |
Data/Function name |
Description |
Example/Application |
|
Static values |
FixedValuesConverter |
XML or JSON |
The combobox can be filled statically via an XML or JSON structure. |
The list element should load static values. |
|
|
NoValuesConverter |
|
|
|
|
Shared data provider |
FixedValuesConverter |
|
A data service that can be shared by several components. See also the action Set shared data provider |
|
|
|
NoValuesConverter |
|
|
|
|
|
GenericConverter |
|
|
|
|
|
EntityConverter |
|
|
|
|
|
DynamicEnumConverter |
|
|
|
|
|
UnitConverter |
|
|
|
|
|
TimeZoneConverter |
|
|
|
|
|
PortalConverter |
|
|
|
|
|
EnumConverter |
|
|
|
|
|
EntityIdConverter |
|
|
|
|
|
GenericDataProvider |
|
|
|
|
|
DashboardDataProvider |
|
|
|
|
|
OwnerConverter |
|
|
|
|
Dynamic enumeration |
|
|
The list element loads all entries of the selected enumeration. A Sort mode can be chosen from the following selection:
|
If the values of a dynamic enumeration should be displayed. This is basically better than 'static values' because it can be maintained centrally. Can also be influenced by dynamic enumeration filters. |
|
Units |
|
|
Selection of all units. |
Manage units globally across multiple forms. |
|
Time zones |
|
|
Selection of time zones. |
Time zone should be selected (without time). |
|
Profile data |
FixedValuesConverter |
Profile name must be entered |
Return value of the profile must have the same structure as 'Static values' XML or JSON must be returned. |
Values from an internal system must be loaded when the form is started. |
|
|
NoValuesConverter |
|
|
|
|
|
GenericConverter |
|
|
|
|
|
EntityConverter |
|
|
|
|
|
DynamicEnumConverter |
|
|
|
|
|
UnitConverter |
|
|
|
|
|
TimeZoneConverter |
|
|
|
|
|
PortalConverter |
|
|
|
|
|
EnumConverter |
|
|
|
|
|
EntityIdConverter |
|
|
|
|
|
GenericDataProvider |
|
|
|
|
|
DashboardDataProvider |
|
|
|
|
|
OwnerConverter |
|
|
|
|
Data object |
EntityConverter |
Data object type |
The list element loads all data objects of the defined type, depending on the search configuration. |
|
|
|
EntityIdConverter |
|
When handling the loaded data, the EntityIdConverter does not return the selected object, but only its ID. |
|