SOPERA Callback Sender Provider

The SOPERA Callback Sender Provider template is used in one of the methods for creating a request-callback provider. With this method you first create an adapter notification that receives the request and publishes a document. For information about how to create the callback provider adapter notification, see SOPERA Generic Provider. Then using the SOPERA Callback Sender Provider template, you create an adapter service that sends a response to the request.

The adapter notification publishes a document that contains the callContextKey parameter which the adapter service uses to correlate the callback with the request. You can also store the callContextKey in a database during a long running operation, wait for input from an external system, retrieve the callContextKey from the database, and invoke the consumer callback operation.

To create a Callback Sender Provider adapter service

1. Start Designer.

2. Right-click the package in which the service should be contained and select New > Adapter Service.

3. Select the parent namespace and type a name for the adapter service.

4. Click Next.

5. Select SOPERA Adapter as the adapter type and click Next.

6. Select the appropriate Adapter Connection Name and click Next.

7. Select the SOPERA Callback Sender Provider adapter template and click Finish.

The adapter service editor for the callback service appears.

8. In the service editor, select the Adapter Settings tab at any time to confirm adapter service properties such as Adapter Name, Adapter Connection Name, and Adapter Service Template, as necessary.

9. In the service editor, select the SOPERA Callback Sender Provider tab and specify the following values:

Field	Description
Service name	The name and path to an existing SOPERA service. For example, {http://services.sopware.org/ExampleURI}UpperCallback
Operation name	The name of the SOPERA service operation. For example, getUpper.
Callback Operation name	The name of the callback operation corresponding to the one specified in the Operation name field. For example, getUpperResponse.
Interaction style	When you select one of the request-callback operations in the Operation name field, the value in this field changes automatically to REQUEST_CALLBACK.
Output document type	The fully qualified document type name for the IS Document that will be generated. This document is the response to the callback operation. For example, doc.myservice.output:callbackDoc

10. From the File menu, click Save.