com.sap.aii.mapping.value.api

Class XIVMService

java.lang.Object
  com.sap.aii.mapping.value.api.XIVMService

public final class XIVMService
extends Object

Service for executing value mappings during a mapping program.

Since:

SAP NetWeaver '04

See Also:

XIVMFactory

Constructor Summary

XIVMService()

Method Summary

static String	executeMapping(IFIdentifier sourceIdentifier, IFIdentifier targetIdentifier, String sourceValue) Returns one result value for the given value mapping.
static IFResponse	executeMapping(IFRequest request) Returns all value for the given value mapping.
static IFResponse[]	executeMapping(IFRequest[] requests) Executes a mass request of value mappings.
static String	executeMapping(String sourceAgency, String sourceScheme, String sourceValue, String targetAgency, String targetScheme) For xslt; exception are not thrown and converted to returning null.
static String	executeMapping(String sourceContext, String sourceAgency, String sourceScheme, String sourceValue, String targetContext, String targetAgency, String targetScheme) For xslt; exceptions are not thrown and converted to returning null.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

XIVMService

public XIVMService()

Method Detail

executeMapping

public static String executeMapping(IFIdentifier sourceIdentifier,
                                    IFIdentifier targetIdentifier,
                                    String sourceValue)
                             throws ValueMappingException

Returns one result value for the given value mapping.

Parameters:

sourceIdentifier - identifier of the source

targetIdentifier - identifier of the target

sourceValue - value to be mapped

Returns:

mapped value, if more than one value is found, one of them is randomly returned.

Throws:

ValueMappingException, - iff there is an error during execution; the source or target identifier cannot be found, more than one group is found for the sourceIdentifier, technical problems.

ValueMappingException

executeMapping

public static IFResponse executeMapping(IFRequest request)
                                 throws ValueMappingException

Returns all value for the given value mapping.

Parameters:

request - requested value mapping

Returns:

a response object that contains all mapped value of the request

Throws:

ValueMappingException, - iff there is an error during execution; technical problem

ValueMappingException

executeMapping

public static String executeMapping(String sourceContext,
                                    String sourceAgency,
                                    String sourceScheme,
                                    String sourceValue,
                                    String targetContext,
                                    String targetAgency,
                                    String targetScheme)

For xslt; exceptions are not thrown and converted to returning null.

Parameters:

sourceContext - context of the source identifier

sourceAgency - agency of the source identifier

sourceScheme - scheme of the source identifier

sourceValue - value to be mapped

targetContext - context of the target identifier

targetAgency - agency of the target identifier

targetScheme - scheme of the target identifier

Returns:

mapped value, null iff there is an error during execution; the source or targetidentifier cannot be found, more than one group is found for the sourceIdentifier, technical problems.

executeMapping

public static String executeMapping(String sourceAgency,
                                    String sourceScheme,
                                    String sourceValue,
                                    String targetAgency,
                                    String targetScheme)

For xslt; exception are not thrown and converted to returning null. Standard contexts from directory (XIVMFactory.XI_CONTEXT) are used.

Parameters:

sourceAgency - agency of the source identifier

sourceScheme - scheme of the source identifier

sourceValue - value to be mapped

targetAgency - agency of the target identifier

targetScheme - scheme of the target identifier

Returns:

mapped value, null iff there is an error during execution; the source- or targetIdentier cannot be found, more than one group is found for the sourceIdentifier, technical problems.

Since:

SAP NetWeaver '04 SPS1

executeMapping

public static IFResponse[] executeMapping(IFRequest[] requests)
                                   throws ValueMappingException

Executes a mass request of value mappings.

Parameters:

requests - list of requests

Returns:

mapped values as list of IFResponse

Throws:

ValueMappingException, - iff there is an error during execution; technical problem

ValueMappingException

Access Rights

This class can be accessed from:

SC	DC	Public Part	ACH
[sap.com] SAP_XIAF	[sap.com] com.sap.aii.mapping.lib.facade	api	BC-XI