Skip to main content

Kanban Board

Kanban lets you visually depict state of entity records, using Codebooks or direct references as columns and individual entity records as cards. Allows users to use drag and drop to set states of entity records. Clicking on a card opens an entity detail page in a Modal window.

General​

  • Item entity – entity representing items presented on the Kanban board
  • Reference to column entity – a reference on item entity representing columns (state). Can be a Codebook or direct reference
  • Order attribute – a number attribute on item entity used for custom sorting of items in a column
  • Detail page for items – a detail page of a Kanban item
  • Visible expression – security condition for showing the Kanban board
  • Enabled expression – security condition for allowing the drag and drop functionality

Items​

  • Items data source expression – expression defining data source of Kanban items. Defaults to all records of selected entity.
    For example (entity, db, ctx) => db.EntitySet.Where(e => e.CreatedBy == ctx.User)
  • Items label expression – expression for defining label of Kanban items
  • Item description expression – expression for defining description of Kanban items
  • Item visuals expression – lets you add icons, tags and user avatars to Kanban items like this: 
    (item, db, ctx, visuals) =>
    {
        if (item.Owner != null)
        {
            visuals.AddUserAvatar(item.Owner, "Assigned Owner");
        }

        visuals.AddTag(new Kanban.Tag(item.Importance.Name,
            (item.Importance == Importance.VIP) ? 
            Kanban.TagStyle.Danger : 
            Kanban.TagStyle.Info));

        visuals.AddIcon((item.Editable) ? AppIcon.Edit : AppIcon.Empty);
    }

Columns​

  • Column data source expression – expression for defining data source of Kanban columns
  • Column label expression – expression for defining labels for Kanban board columns

Filters​

Lets you create filters for application users to narrow down the items on the board; columns are not filtered. The magic wand helps you create filters for attributes and references of the item entity. The settings are the same as for Data grid filters:

  • Name – name of the filter, shows in the filters layout
  • Data type – data type of the filtered value. Date compares whole days and shows a date picker; Date and time compares the full timestamp, shows a date and time picker and offers only the greater and lesser comparisons, since a picked minute almost never equals a stored timestamp
  • Constraint – how the filter value is compared with the item value; the choice depends on the data type
  • Filtered expression – expression representing the item value the filter is applied on, e.g. (item) => item.DueDate

Filters layout​

Created filters have to be added to the filters layout before application users can use them. A filter in the layout can have a default value; the board then opens already filtered.