OpenEdge Development: Mobile Applications - Product ...

invocation method
invocation method
Any method on the JSDO that is defined by the Mobile resource to execute a
corresponding ABL routine on the AppServer as an invoke operation. This can be any
ABL routine in the Mobile interface that is annotated with an "invoke" operation type.
The invocation method name can be the same as the ABL routine or an alias, as
defined by the resource. The method passes any ABL input parameters as properties
of an object parameter. The method returns results from the ABL routine, including any
return value and output parameters, as properties of a request object that is returned
by the method.
Note: The results of an invoke operation have no effect on JSDO local storage.
After completing execution, any working records previously set before the method
executed remain as the working records.
Return type: request object
Applies to: progress.data.JSDO class
Syntax
op-name ( [ input-object [ , async-flag ] ] )
op-name
The name (specified as an identifier) of the invocation method as defined by the
Mobile resource.
input-object
An object whose properties and values match the case-sensitive names and data
types of the input parameters specified for the ABL routine. If the routine does not
take input parameters, specify null or leave out the argument entirely.
async-flag
A Boolean that when true causes the method to execute asynchronously and
when false causes the method to execute synchronously. The default value is
true.
For a synchronous invocation, the method returns a request object that contains
several properties depending on the status of the invoke operation. However, if there
are any ABL output parameters or return value, they are returned as properties of an
object referenced by the response property of the request object. The response object
properties for output parameters match the case-sensitive names and data types of the
output parameters specified for the ABL routine. Any return type is returned by an
OpenEdge-defined _retVal property with a matching data type.
For an asynchronous invocation, the method returns a similar request object as input
to any event handler function subscribed to the following named events that fire in the
following operational order:
1. beforeInvoke event
2. afterInvoke event
OpenEdge ® Development: Mobile Applications 223