com.sap.mdm.matching.commands
Class RetrieveMatchedRecordsCommand

java.lang.Object
  extended bycom.sap.mdm.commands.AbstractCommandBase
      extended bycom.sap.mdm.commands.AbstractCommand
          extended bycom.sap.mdm.session.AbstractSessionCommand
              extended bycom.sap.mdm.session.AbstractUserSessionCommand
                  extended bycom.sap.mdm.matching.commands.RetrieveMatchedRecordsCommand
All Implemented Interfaces:
Command, PassportSupport

public class RetrieveMatchedRecordsCommand
extends AbstractUserSessionCommand

A command to retrieve the records that matched the source record for a matching strategy. In addition, each matched record contains the scores of the individual matching rule.

See Also:
ExecuteMatchingStrategyCommand, ExecuteMatchingStrategyForNewRecordValuesCommand, com.sap.mdm.matching.commands

Constructor Summary
RetrieveMatchedRecordsCommand(ConnectionAccessor connection)
          Creates a new instance of this command.
RetrieveMatchedRecordsCommand(UserSessionContext ctx)
          Creates a new instance of this command by context.
 
Method Summary
 SortDefinition getFieldSortingOrder()
          Deprecated. replaced by ResultDefinition.getFieldSortingOrder()
 MatchingResult getMatchingResult()
          Retrieves the matching result.
 MatchingTaskId getMatchingTaskId()
          Returns the matching task Id.
 int getPageIndex()
          Returns the paging index.
 int getPageSize()
          Returns the page size.
 RecordId getRecordId()
          Returns the source record Id.
 int getRegionalLayer()
          Retrieves the regional layer.
 ResultDefinition getResultDefinition()
          Returns the result definition.
 ResultDefinition[] getSupportingResultDefinitions()
          Returns the list of result definitions.
 boolean isRetrieveDisplayValue()
          Indicates if display values should be retrieved.
 void setFieldSortingOrder(SortDefinition fieldSortingOrder)
          Deprecated. replaced by ResultDefinition.setFieldSortingOrder(SortDefinition)
 void setMatchingTaskId(MatchingTaskId matchingTaskId)
          Sets the matching task Id (required).
 void setPageIndex(int pageIndex)
          Sets the paging index (optional).
 void setPageSize(int pageSize)
          Sets the page size (optional).
 void setRecordId(RecordId recordId)
          Sets the source record Id (required).
 void setRegionalLayer(int regionalLayer)
          Sets the regional layer to retrieve (optional).
 void setResultDefinition(ResultDefinition resultDefinition)
          Sets the result definition (required).
 void setRetrieveDisplayValue(boolean isRetrieveDisplayValue)
          Indicates whether display value should be retrieved (optional).
 void setSupportingResultDefinitions(ResultDefinition[] supportingResultDefinitions)
          Sets the result definition (optional).
 
Methods inherited from class com.sap.mdm.commands.AbstractCommand
getSession, setSession
 
Methods inherited from class com.sap.mdm.commands.AbstractCommandBase
execute, getPassport, isCommandComplete, setPassport
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

RetrieveMatchedRecordsCommand

public RetrieveMatchedRecordsCommand(ConnectionAccessor connection)
Creates a new instance of this command.

Parameters:
connection - the connections to the server.

RetrieveMatchedRecordsCommand

public RetrieveMatchedRecordsCommand(UserSessionContext ctx)
                              throws ConnectionException,
                                     SessionException
Creates a new instance of this command by context.

Parameters:
ctx - the user session context.
Method Detail

getMatchingTaskId

public MatchingTaskId getMatchingTaskId()
Returns the matching task Id.

Returns:
the matching task Id

setMatchingTaskId

public void setMatchingTaskId(MatchingTaskId matchingTaskId)
Sets the matching task Id (required). This identifier is a handle to the matching strategy that was executed.

Parameters:
matchingTaskId - a matching task Id
See Also:
ExecuteMatchingStrategyCommand, ExecuteMatchingStrategyForNewRecordValuesCommand

getRecordId

public RecordId getRecordId()
Returns the source record Id.

Returns:
the source record Id

setRecordId

public void setRecordId(RecordId recordId)
Sets the source record Id (required). The matched records retrieved will be based on this source record. For external record matching, the record Id should be -1.

Parameters:
recordId - the source record Id

getResultDefinition

public ResultDefinition getResultDefinition()
Returns the result definition.

Returns:
the result definition

setResultDefinition

public void setResultDefinition(ResultDefinition resultDefinition)
Sets the result definition (required). The result definition specifies the list of field/columns to retrieve the data for.

Parameters:
resultDefinition - a result definition

getFieldSortingOrder

public SortDefinition getFieldSortingOrder()
Deprecated. replaced by ResultDefinition.getFieldSortingOrder()

Returns the field sorting order.

Returns:
the field sorting order

setFieldSortingOrder

public void setFieldSortingOrder(SortDefinition fieldSortingOrder)
Deprecated. replaced by ResultDefinition.setFieldSortingOrder(SortDefinition)

Sets the field sorting order (optional). The default is no sort order.

Parameters:
fieldSortingOrder - a field sorting order

getSupportingResultDefinitions

public ResultDefinition[] getSupportingResultDefinitions()
Returns the list of result definitions. These result definitions specify the list of fields/columns to retrieve for supporting lookup fields from the main result definition.

Returns:
the list of result definitions

setSupportingResultDefinitions

public void setSupportingResultDefinitions(ResultDefinition[] supportingResultDefinitions)
Sets the result definition (optional). The result definition specifies the list of field/columns to retrieve the data for. The default is none.

Parameters:
supportingResultDefinitions - the result definitions

getPageIndex

public int getPageIndex()
Returns the paging index. The paging index is zero-based.

Returns:
the paging index
Since:
7.1.04

setPageIndex

public void setPageIndex(int pageIndex)
Sets the paging index (optional). The paging index is zero-based. The default is page index zero.

Parameters:
pageIndex - the paging index
Since:
7.1.04

getPageSize

public int getPageSize()
Returns the page size. The page size specifies the maximum number of records to retrieve.

Returns:
the page size
Since:
7.1.04

setPageSize

public void setPageSize(int pageSize)
Sets the page size (optional). The page size specifies the maximum number of records to retrieve. By default returns all target records.

Parameters:
pageSize - the page size
Since:
7.1.04

getMatchingResult

public MatchingResult getMatchingResult()
Retrieves the matching result. A matching result specifies a source record along with the list of matched records.

Returns:
a matching result

isRetrieveDisplayValue

public boolean isRetrieveDisplayValue()
Indicates if display values should be retrieved.

Returns:
true if display value should be retrieved, otherwise false
Since:
7.1 SP4

setRetrieveDisplayValue

public void setRetrieveDisplayValue(boolean isRetrieveDisplayValue)
Indicates whether display value should be retrieved (optional). The default is true.

Parameters:
isRetrieveDisplayValue - true if display value should be retrieved, otherwise false
Since:
7.1 SP4

getRegionalLayer

public int getRegionalLayer()
Retrieves the regional layer.

Returns:
the regional layer
Since:
7.1 SP4

setRegionalLayer

public void setRegionalLayer(int regionalLayer)
Sets the regional layer to retrieve (optional). The default is RegionalLayer.CURRENT.

Parameters:
regionalLayer - the regional layer
Since:
7.1 SP4


Copyright 2004-2007 by SAP AG. All Rights Reserved.

SAP, R/3, mySAP, mySAP.com, xApps, xApp, SAP NetWeaver, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and in several other countries all over the world. All other product and service names mentioned are the trademarks of their respective companies. Data contained in this document serves informational purposes only. National product specifications may vary.

These materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies (SAP Group) for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty.