com.sap.mdm.data.commands
Class RetrieveRecordsByRemoteKeyCommand

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.data.commands.RetrieveRecordsByRemoteKeyCommand
All Implemented Interfaces:
Command, PassportSupport
Direct Known Subclasses:
RetrieveRecordsByRemoteKeyExCommand

public class RetrieveRecordsByRemoteKeyCommand
extends AbstractUserSessionCommand

This command is responsible for retrieving set of Record by remote key.

The order of the returned records corresponds the order of the addition of remote keys. Duplicated records are not eliminated.


Constructor Summary
RetrieveRecordsByRemoteKeyCommand(ConnectionAccessor connection)
          Creates an instance.
RetrieveRecordsByRemoteKeyCommand(UserSessionContext ctx)
          Creates a new instance of this command by context.
 
Method Summary
 SortDefinition getFieldSortingOrder()
          Deprecated. replaced by ResultDefinition.getFieldSortingOrder()
 RecordResultSet getRecords()
          Gets result set of record retrieved from repository.
 int getRegionalLayer()
          Retrieves the regional layer.
 KeyMapping getRemoteKeys()
          Gets remote key for which record IDs should be retrieved from repository
 ResultDefinition getResultDefinition()
          Returns the result definition.
 ResultDefinition[] getSupportingResultDefinitions()
          Returns the list of result definitions.
 boolean isRetrieveDisplayValue()
          Indicates if a display value of a record should be retrieved.
 void setFieldSortingOrder(SortDefinition fieldSorting)
          Deprecated. replaced by ResultDefinition.setFieldSortingOrder(SortDefinition)
 void setRegionalLayer(int regionalLayer)
          Sets the regional layer to retrieve (optional).
 void setRemoteKeys(KeyMapping remoteKeys)
          Sets remote key for which record IDs should be retrieved from repository (required).
 void setResultDefinition(ResultDefinition resultDefinition)
          Sets the result definition (required).
 void setRetrieveDisplayValue(boolean isRetrieveDisplayValue)
          Defines if display value of the record should be retrieved (optional).
 void setSupportingResultDefinitions(ResultDefinition[] supportingResultDefinitions)
          Sets the list of result definitions (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

RetrieveRecordsByRemoteKeyCommand

public RetrieveRecordsByRemoteKeyCommand(ConnectionAccessor connection)
Creates an instance.

Parameters:
connection - a connection to the MDM server

RetrieveRecordsByRemoteKeyCommand

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

Parameters:
ctx - the user session context.
Method Detail

setRemoteKeys

public void setRemoteKeys(KeyMapping remoteKeys)
Sets remote key for which record IDs should be retrieved from repository (required).

Parameters:
remoteKeys - remote keys

getRemoteKeys

public KeyMapping getRemoteKeys()
Gets remote key for which record IDs should be retrieved from repository

Returns:
remote keys

getResultDefinition

public ResultDefinition getResultDefinition()
Returns the result definition. The result definition specifies the list of field/columns to retrieve the data for.

Returns:
the result definition
See Also:
AbstractRetrieveLimitedRecordsCommand.getResultDefinition()

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 - the result definition
See Also:
AbstractRetrieveLimitedRecordsCommand.setResultDefinition(ResultDefinition)

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
See Also:
AbstractRetrieveLimitedRecordsCommand.getSupportingResultDefinitions()

setSupportingResultDefinitions

public void setSupportingResultDefinitions(ResultDefinition[] supportingResultDefinitions)
Sets the list of result definitions (optional). These result definitions specify the list of fields/columns to retrieve for supporting lookup fields from the main result definition.

Parameters:
supportingResultDefinitions - the list of result definitions
See Also:
AbstractRetrieveLimitedRecordsCommand.setSupportingResultDefinitions(ResultDefinition[])

getFieldSortingOrder

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

Returns the field sorting order. The default is no sorting.

Returns:
the field sorting order

setFieldSortingOrder

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

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

Parameters:
fieldSorting - the field sorting order

getRegionalLayer

public int getRegionalLayer()
Retrieves the regional layer.

Returns:
the regional layer

setRegionalLayer

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

Parameters:
regionalLayer - the regional layer

isRetrieveDisplayValue

public boolean isRetrieveDisplayValue()
Indicates if a display value of a record should be retrieved.

Returns:
true if display value of a record should be retrieved, false otherwise.

setRetrieveDisplayValue

public void setRetrieveDisplayValue(boolean isRetrieveDisplayValue)
Defines if display value of the record should be retrieved (optional). The default is true.

Parameters:
isRetrieveDisplayValue - the input parameters specifying if display value of the record should be retrieved

getRecords

public RecordResultSet getRecords()
Gets result set of record retrieved from repository.

Returns:
result set of records


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.