Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Instance Timeline (ITLINE)

The instances created in the last N days drawn as a Gantt-style timeline grouped by application: a bar from creation to the last change (running instances: to now), a black tick at the due date, blue active, red overdue, amber at risk (due within atRiskHours), grey finished; the same instances as a list with CSV.

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.

Install

  1. Import packages/Instance-Timeline-1.0.twx (Process Center / Workflow Center console: Import Process App; CP4BA: Business Automation Studio > Import).
  2. 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.
  3. 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.

Dashboard

Tab Content
Timeline application, status, days, max rows, Draw, Export CSV; the SVG (server-rendered HTML in an Output Text with allowHTML)
List instance table

Environment variables

serverBaseURL, restAuthUser, restAuthPassword, restTrustAllCertificates (kit-rest.js: the technical user every server-side flow calls the REST API with), appTitle, atRiskHours (default 24).

Documents

  • 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.

Rebuilding and customising

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('instance timeline (itline)') returns this package, get_tool('build_itline.py') the generator - ask the MCP for the kit apps and it hands out the generator by name.

License

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.

About

Instance Timeline for IBM BAW: process instances of a period on a Gantt-style timeline grouped by application, overdue and at-risk colouring, list and CSV

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors