The Identity Manager provisioning module includes an e-mail notification facility that lets you send e-mail messages to notify users of changes in the state of the provisioning system, as well as tasks that they need to perform. To support access by third-party software applications, the notification facility includes a Web service endpoint. The endpoint lets you send an e-mail message to one or more users. When you send an e-mail, you include parameters that specify the target e-mail address, the e-mail template to use, and the replacement values for tokens in the e-mail template.
This Appendix describes the programming interface for the Notification Web Service.
You can access the Notification Web Service endpoint using a URL similar to the following:
http://server:port/warcontext/notification/service?test
For example, if your server is named “myserver”, your User Application is listening on port 8080, and your User Application war file is named “IDMPROV”, the URL would be:
http://myserver:8080/IDMPROV/notification/service?test
You can access the WSDL for the Notification Web Service using a URL similar to the following:
http://server:port/warcontext/notification/service?wsdl
For example, if your server is named “myserver”, your User Application is listening on port 8080, and your User Application war file is named “IDMPROV”, the URL would be:
http://myserver:8080/IDMPROV/notification/service?wsdl
The stub classes you need for the Notification Web Service are located in the wsclient.jar, which ships with the product. This JAR file is located in the idmuserapp/lib folder. To allow your code to find the stub classes, you need to add this JAR to your classpath.