Interface MasterDataSource
public interface MasterDataSource
A master data source is used to fetch master data entries for one or more
DataObjectDefinition
s.- Author:
- Micha Kiener
-
Method Summary
Modifier and TypeMethodDescriptionReturns the optional description for this master data source.getId()
Returns the id of this source which must be unique within the system, so there must only be exactly one master data source with that ID.Returns a list of master data instances according the given query object used for filtering.getName()
Returns the name of the source for this master data.synchronizeMasterDataEntries
(String masterDataDefinitionKey, boolean forceUpdate) Synchronizes the master data entries for the given master data definition.
-
Method Details
-
getId
String getId()Returns the id of this source which must be unique within the system, so there must only be exactly one master data source with that ID.- Returns:
- the id of this master data source
-
getName
String getName()Returns the name of the source for this master data.- Returns:
- the name of this source
-
getDescription
String getDescription()Returns the optional description for this master data source.- Returns:
- the description of this source
-
getMasterDataInstances
Returns a list of master data instances according the given query object used for filtering.- Parameters:
query
- the query to be used for entry filtering- Returns:
- the list of master data instances matching the query, might be empty, but never null
-
synchronizeMasterDataEntries
Synchronizes the master data entries for the given master data definition. This is an optional method and depends on the source implementation.- Parameters:
masterDataDefinitionKey
- the master data definition key the entry data should be synchronizedforceUpdate
-true
, if the synchronization should be done regardless of the currently saved objects- Returns:
- an optional information message about the synchronization result
-