Calling Web Services From Notifications

You can use notifications to call functions from external Web services to update SBM items or to send SBM data to third-party or custom applications that offer Web services.

For each notification, you can call a Web service function for notification rules based on primary and auxiliary items. You can map the function's input and output parameters to SBM fields.

Note: You can select a single function for each notification, but you can assign a function to multiple notifications.

Consider the following information:

Support for development efforts with custom programs written using Web services is provided by Professional Services. Questions regarding Web services operations as documented are handled by Serena Customer Support.
Web services must be imported into SBM Composer as part of a process app before they can be associated with a notification.
Authentication for Web services is specified for the service's endpoint in Application Repository.
SBM calls are synchronous. SBM waits for Web services calls to return, or for the specified time-out period to expire. If you need asynchronous calls, consider using orchestrations to call Web services. For details, refer to the SBM Orchestration Guide.
Input data is passed to the Web service in UTF-8.
Output data from the Web service is assumed to be in UTF-8.
Managed administrators must have the Associate Web Services/Scripts with Notifications administration privilege to select the Run Web Service as an action choice for notifications.

Assigning Web Service Functions to Notifications

To call a Web service from a notification:

In SBM Composer, import a Web service into an application, and then publish and deploy the application's process app to the SBM Application Engine.
In SBM Application Administrator, select the Notifications icon on the Administrator Portal.
Create or edit a notification.
From the Action list, select Run Web Service.
From the When list, select the condition that must become true for the notification to execute.
In the Web Service area, click the Select Function button. The Select Web Service Function page opens.
Select the function to call for the notification, and then click OK.
Click the Map Inputs/Outputs button.
Map Web service parameters to fields or set fixed values. For guidance, refer to:
Click OK.
In the On Script/Web Service Failure area, select the Retry Every check box, and then type the number of cycles that should elapse before the Notification Server retries the notification.
Select the Quit After check box, and then type a number in the attempts box to specify the number of times the Notification Server should attempt to execute the Web message. By default, the Notification Server will stop retrying the notification after one attempt.
Save your changes.