Users subscribe to events of an application - new tasks assigned to me, new unassigned tasks of my teams, my overdue tasks, failed
instances, completed instances - and a digest run mails every subscriber what happened since the last run. No business process, no
database, no toolkit: a subscription is a shared saved search definition (POST /rest/bpm/wle/v1/searches/tasks) whose name
encodes the subscription (nm|<login>|<kind>|<app>|<last run in minutes>, 64 characters at most); the digest is an Ajax service the
dashboard runs on demand and that an external scheduler (cron + curl) or an undercover agent added in the designer runs periodically.
E-mail goes through javax.mail with the SMTP environment variables (the pattern of Instance Purge).
Target: IBM BPM 8.6.2, IBM BAW 20-26 (traditional) and CP4BA (Workflow Authoring / Studio import). Built from out-of-the-box building blocks only (System Data, UI Toolkit, one client-side human service, server-side service flows calling the product REST API as a technical user) - no third-party toolkit, no custom Java.
- Import
packages/Notification-Manager-1.0.twx(Process Center / Workflow Center console: Import Process App; CP4BA: Business Automation Studio > Import). - Set the environment variables of the snapshot (below): the server base URL as seen from the server itself and the technical user the flows call the REST API with. The package ships no password.
- Expose the dashboard to a team (the package's default team holds
celladmin; change it) and open it from Process Portal or the playback URL of the human service.
| Tab | Content |
|---|---|
| Subscriptions | Subscribe panel (subscriber login, event kind, application acronym or ALL); list filter by login, Refresh, Remove selected; table subscriber / event / application / last digest / definition id |
| Digest | login filter, Send e-mails or Dry run, Run digest; result table subscriber / e-mail / event / application / matches / mail / detail; Send a test e-mail |
| Scheduling | the exact curl line for cron (service id and branch id of this package), the undercover agent alternative, the environment variables |
serverBaseURL, restAuthUser, restAuthPassword, restTrustAllCertificates, appTitle, notificationsEnabled (false = report only),
notificationOverrideTo (every digest to this address - test environments; none = off), smtpHost, smtpPort, smtpFrom, smtpUser,
smtpPassword, smtpStartTls, notifyMailDomain (appended to the login when the registry has no e-mail; none = skip such users).
- docs/DESIGN.md - what the app does, every service flow with its REST calls, business objects, build and test procedure, pitfalls met on the way.
- docs/RECIPES-AND-PITFALLS.md - the recipe collection of all the kit apps: shared helpers, verified search / team / instance / operations REST facts, build and deployment pitfalls.
The application is generated by a small Python program on the twxkit generator (standard library only, no base export). The generator
and the kit are served to AI agents and developers by the BAW Knowledge MCP server (https://bawmcp.dosvak.com/mcp, see
dosvak/baw-mcp): get_package('notification manager (notify)') returns this package, get_tool('build_notify.py')
the generator - ask the MCP for the kit apps and it hands out the generator by name.
Apache License 2.0 - see LICENSE and NOTICE. IBM, IBM Business Automation Workflow, IBM Business Process Manager and IBM Cloud Pak are trademarks of International Business Machines Corporation; this project is not affiliated with or supported by IBM.