Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Generic UI Toolkit

A toolkit of 47 coach view controls for IBM Business Automation Workflow (BAW), IBM BPM 8.6 and Cloud Pak for Business Automation (CP4BA), built on the out-of-the-box UI Toolkit and open-source libraries only - no commercial JavaScript libraries, no Java, no branding. A showcase process application demonstrates every control on its own page.

Gallery of the controls with screenshots: docs/CONTROLS.md.

Group Controls
Layouts Card Tiles, Carousel, Horizontal Resizer, Vertical Resizer, Tree Table, Tree View, Profile Image, Repeating Tabs
Navigation Dropdown Menu, Sidebar Navigation, Popover, Step Progress
Charts & Maps Sparkline, Gauge, Bullet Graph, Barcode, Orgchart, Class Diagram, Service Diagram, USA Vector Map, World Vector Map, Google Map by Address, Google Map by Coordinates
Viewers & Exports PDF Viewer, Embed Document, Excel Viewer, PDF Wrapper, Print Wrapper, Export PNG
Inputs Tree Select, Comments, Inline Comments, Date Range Picker, Dojo Slider, Server Upload, Encrypted Input
Display & Logic Page Header, Formatted Output, Conditional Value, Timeline, IFrame
Composite Controls Accordion, Check List, Dual List, Search List, Sample Customer Form

Every control has an option-driven design-time preview in the web designer, so a page looks in Process Designer like it does at runtime.

Packages

File Target Content
packages/Generic-UI-Toolkit-1.10.twx traditional BAW / IBM BPM 8.6.x and later toolkit Generic UI Toolkit (acronym GUITK), snapshot 1.10
packages/Generic-UI-Toolkit-Showcase-1.10.twx traditional BAW / IBM BPM 8.6.x and later process app Generic UI Toolkit Showcase (GUITS): 47 demo pages in 8 groups, bundles the toolkit
packages/cp4ba/Generic-UI-Toolkit-1.10-CP4BA_25.twx CP4BA 25.0.x Workflow Authoring (Business Automation Studio) the toolkit as exported from CP4BA 25.0.1 after validation (System Data bound to the Cloud Pak target environment)
packages/cp4ba/Generic-UI-Toolkit-Showcase-1.10-CP4BA_25.twx CP4BA 25.0.x the showcase as exported from CP4BA 25.0.1

The same files are attached to the releases of this repository.

Dependencies: System Data, UI Toolkit and Content Management (all shipped with the product; Content Management is needed by the Server Upload control only).

Install

Traditional BAW / IBM BPM:

  1. Process Center console > Process Apps / Toolkits > Import Process App > choose the .twx (the showcase bundles the toolkit, so importing the showcase alone is enough).
  2. Open the showcase in Process Designer and run the Showcase client-side human service, or start it from Process Portal after exposing it to a team.
  3. In your own application add the toolkit dependency Generic UI Toolkit and drag the controls from the palette.

CP4BA: Business Automation Studio > Business automations > Import > the -CP4BA_25 files (toolkit first, then the showcase).

Using the controls

  • Every control is an ordinary coach view: bind its business data, set its configuration options in the properties panel and handle its events (ON_CLICK, ON_CHANGE, ...) like any UI Toolkit control. Option lists and their allowed values are documented in the view's Documentation tab inside the designer.
  • Google Map by Address / by Coordinates load the Google Maps JavaScript API from Google with the apiKey configuration option; without a key the control shows its settings as text.
  • PDF Viewer and Embed Document render PDFs with pdf.js; Excel Viewer parses .xlsx in the browser; Print Wrapper, Export PNG and PDF Wrapper work on the wrapped content only.
  • Conditional Value is logic-only (it renders nothing): when the tested variable meets the condition the target variable is set.
  • Server Upload stores files through the Content Management toolkit's server file services.

Sources in this repository

Path Content
views/ the JavaScript / HTML / CSS of the controls implemented from scratch (inline scripts of the coach views; the design-time preview is derived from the same code)
docs/CONTROLS.md every control with its description and a screenshot as rendered by the showcase
docs/screenshots/ the screenshots
docs/FUNCTIONAL-TEST-2026-09-04.md automated runtime sweep (every showcase page rendered, JS errors, failed requests) and interaction tests (46 / 46) on a traditional BAW server

The toolkit packages are generated from a declarative build in a private workspace of Dosvak LLC; the documents in docs/ mention its tools by name. Third-party libraries embedded in the toolkit (jQuery, Bootstrap, D3, mxGraph, jqvmap, html2canvas, jsPDF, pdf.js, Font Awesome Free) keep their own licenses, listed in NOTICE.

Verification

  • Traditional BAW 8.6.2 / 20.0.0.1: runtime sweep of all 47 pages clean, 46 / 46 interaction tests, every control with a design-time preview (report).
  • CP4BA 25.0.1 (Workflow Authoring): imported with 0 validation errors; toolkit and showcase open and render in the web designer (design-time sweeps).

License and attribution

Apache License 2.0 - see LICENSE and NOTICE. You may use, modify and redistribute this software, including in commercial products, provided the copyright notice, the license and the NOTICE file stay with every copy (attribution to Dosvak LLC).

About

Published by Dosvak LLC, an IBM Business Partner (Silver, IBM Partner Plus), as part of its open-source tooling for IBM Business Automation Workflow. More: github.com/dosvak, questions and answers on bpm.tips.

IBM, IBM Business Automation Workflow, IBM Business Process Manager and IBM Cloud Pak are trademarks or registered trademarks of International Business Machines Corporation. This project is not affiliated with, endorsed by or supported by IBM.

About

Generic UI Toolkit for IBM BAW / CP4BA: 47 coach view controls without commercial libraries, with a showcase application

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages