replaceBdeNameInRequest()

This function replaces the business object name wherever it occurs in the request. It can be used when forwarding a request from one business object to another business object. The old business object name will be the name of the current business object (that contains the hook). If the request belongs to another business object, the method will fail.

The business object name is replaced for example in the selection (when selecting attributes or ‘*’ for the top-level component), in the filter (when filtering on attributes from the top-level component), in the children of the DataArea node if the data area contains any instances, and in the eventEntity controlling attribute for the OnEvent method.

Limitation: only the data area and the standard controlling attributes are handled (so specific controlling attributes are not renamed if they contain the business object name).

long replaceBdeNameInRequest(
				         long		      i.request,
	 const		    string	 	   i.newBdeName,
 	ref			     long		      o.newRequest)

Input:

• i.request: request xml
• i.newBdeName: new business object name to be used

Output:

• o.newRequest: duplicate of i.request, where the business object name is replaced (note: this xml must be cleaned up after use!)
• return value: 0 (OK) or an error value.