How to load a kanban view with a data provider or procedure

The Kanban View node supports loading data from attributes or from a custom data source implemented by the developer in a data provider or procedure.

The former option is easier to use, while the latter (using a custom data source) is more flexible.

To use the custom data source option, the developer must:

  1. Set the "Datasource From" property to "Dataprovider". Note: While this value is used to maintain compatibility with other GeneXus controls, both data providers and procedures can be used.
  2. Implement the data provider / procedure. This object must:
    1. Return the Kanban columns in an out parameter (in procedures) or as the output (in data providers).
      This value must be a collection of the K2BTools.Controls.Kanban.Column SDT.
    2. The object can receive all parameters needed.
    3. The object logic can be determined without any restrictions.
  3. Select the object in the Datasource property and the values for its parameters in the Datasource parameters property.

Output structure

The output, as stated above, must be a collection of the K2BTools.Controls.Kanban.Column type. This type models a single column for the board, defined using the following fields.

Field Description
code Column id. Must be unique in the board
description Column title, will be shown above the column
titleClass Can be used to select a class used to customize the column's title appearance
columnClass Can be used to select a class used to customize the column's items' appearance. This field is a collection of the K2BTools.Controls.Kanban.Item type.

Items are defined using the K2BTools.Controls.Kanban.Item type. The fields that define this type are:

Field Description
value Item id. Must be unique in the board
description Item description. Must not be empty. This is the main text associated with the item.
imageUrl Optional. Can be used to reference an image that will be shown in the item.
detail Optional. Can be used to include a secondary text that will be shown below the description.
trailingText Optional. Can be used to include a secondary text that will be shown on the right of the item.
tooltip Optional. Can be used to define a tooltip that will be displayed as the item's tooltip.
primaryPills Optional. Can be used to define the pills that will be shown above the item's main contents.
secondaryPills Optional. Can be used to define the pills that will be shown below the item's main contents.
actions Optional. Can be used to define item actions (see Kanban View node).
extras Optional. Can be used to include extra information in the item (see Kanban View node).

Sample

You can see a sample of this mechanism by downloading this XPZ.

Availability