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 Type Method Description java.lang.String
getDescription()
Returns the optional description for this master data source.java.lang.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.java.util.List<MasterDataInstance>
getMasterDataInstances(MasterDataInstanceQuery query)
Returns a list of master data instances according the given query object used for filtering.java.lang.String
getName()
Returns the name of the source for this master data.SynchronizeResult
synchronizeMasterDataEntries(java.lang.String masterDataDefinitionKey, boolean forceUpdate)
Synchronizes the master data entries for the given master data definition.
-
Method Details
-
getId
java.lang.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
java.lang.String getName()Returns the name of the source for this master data.- Returns:
- the name of this source
-
getDescription
java.lang.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
SynchronizeResult synchronizeMasterDataEntries(java.lang.String masterDataDefinitionKey, boolean forceUpdate)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
-