Difference between revisions of "Workflow Activities Form custom Plugin"
| Line 5: | Line 5: | ||
*'''License:''' [http://www.gnu.org/licenses/gpl-2.0.html GPLv2] | *'''License:''' [http://www.gnu.org/licenses/gpl-2.0.html GPLv2] | ||
*'''Sources:''' [ https://github.com/nasleem-mdr/org.nsoft.workflow.activities Github] | *'''Sources:''' [ https://github.com/nasleem-mdr/org.nsoft.workflow.activities Github] | ||
| − | + | [[File:Screenshot.png|right|320px]] | |
__FORCETOC__ | __FORCETOC__ | ||
== Description == | == Description == | ||
| Line 13: | Line 13: | ||
*'''Detail transaction in form,''' so approver don't need zoom out to windows to view detail. | *'''Detail transaction in form,''' so approver don't need zoom out to windows to view detail. | ||
*'''Mobile friendly''' with collapsible List Approval. | *'''Mobile friendly''' with collapsible List Approval. | ||
| − | |||
__FORCETOC__ | __FORCETOC__ | ||
| Line 22: | Line 21: | ||
*Change Workflow Activities Form class annotation to org.nsoft.webui.apps.WFActivity | *Change Workflow Activities Form class annotation to org.nsoft.webui.apps.WFActivity | ||
| − | [[File:Screenshot 20260616-210131~2.jpg|right| | + | [[File:Screenshot 20260616-210131~2.jpg|right|320px]] |
Revision as of 19:07, 16 June 2026
- Maintainer: Nasleem Madrodji
- Status: Beta, tested with release 13.0
- License: GPLv2
- Sources: [ https://github.com/nasleem-mdr/org.nsoft.workflow.activities Github]
Description
Custom Form Workflow Activities Plugin, customize approval Workflow form with feature:
- One step approval action, Instead of using yes/no option and then clicking the OK button, it is better to directly select the Approve/Reject button..
- Detail transaction in form, so approver don't need zoom out to windows to view detail.
- Mobile friendly with collapsible List Approval.
Installation
How to Install this pkugin
- Clone and Build your own plugin/download jar file on release tag.
- Install via OSGI Console
- Change Workflow Activities Form class annotation to org.nsoft.webui.apps.WFActivity
Technical documentation
Overview
'WWFActivity' is customize Workflow Activities from core, please change annotation in Form->[search] "Worflow Activites"->Class=org.nsoft.webui.apps.wf.WFActifity WFTransactionDetailRenderer is a renderer class that displays transaction document details (header + line items) directly inside the iDempiere workflow approval panel (WWFActivity form).
This class is designed using a SysConfig-driven + Generic PO approach, enabling it to display details from any document table without importing specific model classes — configuration in the Application Dictionary (SysConfig) is all that is needed.
Architecture
WWFActivity.java
└── WFTransactionDetailRenderer.java
├── MSysConfig ← Read column configuration per table
├── MTable / PO ← Query document header (generic)
├── Query ← Query document lines
└── ZK Components ← Render to UI (Groupbox, Listbox, Label)
Data flow: MWFActivity (activity selected by user)
→ get AD_Table_ID + Record_ID → load header PO via MTable.getPO() → read SysConfig for column configuration → render header (4 labels) → query & render lines (3-column listbox)
SysConfig Configuration
All configuration keys use the prefix: WF_DETAIL_<TableName>_<SUFFIX> Example for table C_Order: WF_DETAIL_C_Order_LINE_TABLE
Required Keys The following keys must be configured for line items to be displayed:
| Key | Description | Example Value |
|---|---|---|
| WF_DETAIL_TableName_LINE_TABLE | Name of the line/detail table | C_OrderLine |
| WF_DETAIL_TablenName_LINK_COL | Foreign key column in the line table | C_Order_ID |
Optional Keys (With Defaults) The following keys are not required — if left empty, the system uses default fallback values (see Default Fallback Values). see detail on github
Configuration Examples
C_Order (Minimal — required keys only) WF_DETAIL_C_Order_LINE_TABLE = C_OrderLine WF_DETAIL_C_Order_LINK_COL = C_Order_ID
WF_DETAIL_C_Invoice_LINE_TABLE = C_InvoiceLine WF_DETAIL_C_Invoice_LINK_COL = C_Invoice_ID WF_DETAIL_C_Invoice_COL2 = QtyEntered,QtyInvoiced
