0 Votes

Wiki source code of AWMKanbanMacro

Last modified by Ryan C on 2025/07/17 22:45

Hide last authors
Ryan C 1.1 1 This macro allows to display a Kanban board from AppWithinMinutes data using the [[xwiki:Macros.KanbanMacro]] based on one of the fields of the AWM data. It is also possible to drag and drop items in the board and update the field in the XWiki document.
2
3 Example:
4
5 ##{{{
Ryan C 5.1 6 {{awmkanban app="Help.Applications.Movies" category="databaseList1" displayedCategoryColumns="Help.Applications.Contributors.Charlie Chaplin" columns="staticList1,boolean1" xwql="obj.boolean1=0" /}}
Ryan C 1.1 7 }}}##
8
Ryan C 5.1 9 * ##app or className## - application or className for which to build the kanban board
10 * ##category## - class field used to group the kanban board into columns
11 * ##displayedCategoryColumns## - only display these values of the `category` field as columns
12 * ##xwql## - additional xwql to restrict the query
13 * ##title## - field to display the title
14 * ##columns## - the class fields to display as a description in each card
Ryan C 6.1 15 * ##order## - order to sort the data by. Example: 'doc.name desc', 'doc.date desc', 'customClassField1 asc, customClassField2 desc, doc.name desc' or 'customClassField1 asc' if the className object contains such custom fields
16 * ##limit## - the maximum amount of items to show. If the ##displayedCategoryColumns## parameter is set, the limit is applied for each column.
Ryan C 1.1 17
18 Examples:
19
20 == Kanban of Movies by genre showing the director field ==
21
22 {{awmkanban app="Help.Applications.Movies" category="databaseList1" columns="staticList1,boolean1"/}}
23
Ryan C 5.1 24 == Kanban of Movies showing the director field, only showing a subset of directors==
25
26 {{awmkanban app="Help.Applications.Movies" category="databaseList1" displayedCategoryColumns="Help.Applications.Contributors.Charlie Chaplin" columns="staticList1,boolean1"/}}
27
Ryan C 1.1 28 == Kanban of Movies by genre showing the director field only comedy movies ==
29
30 {{awmkanban app="Help.Applications.Movies" category="databaseList1" columns="staticList1,boolean1" xwql="obj.boolean1=0"/}}

XWiki AI Chat