Important

You are browsing documentation for version 5.0 of OroCommerce, OroCRM, and OroPlatform, maintained until August 2024 and supported until March 2026. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Board Extension

Enable Board Appearance on a Grid

To add board appearance on a grid:

  • Navigate to the datagrid.yml file

  • Add the following lines to the datagrid configuration:

datagrids:
    {grid-uid}:
        # <grid configuration> goes here
        appearances:
            board:
                {board-uid}: #unique board id
                    label: Board Label
                    group_by:
                        property: option_set_field
                        order_by:
                            priority: ASC
                    card_view: demobundle/js/app/views/board/your-entity-card-view

Hint

As board appearance uses save_api_accessor internally, make sure that at least one of the following options is appropriately configured:

  • save_api_accessor for column transition option (check documentation)

  • save_api_accessor for default transition (check default_transition configuration option below)

  • save_api_accessor for inline editing (check this article

Datagrid Configuration Details

  • label (Optional): A label to be shown in the appearance switcher.

  • icon (Optional): The icon class to be shown in the appearance switcher.

  • group_by (Required): Configuration array for column grouping property.

group_by:
    property: status #required, enum property to be used for board columns
    order_by: #optional, used to define a property's field, which should be used for column sort order.
        priority: ASC
  • default_column (Optional): Specifies a column ID to show entities with no value set for group_by property. By default, the first column will be used.

  • plugin (Optional): Specifies the plugin realization. Default orodatagrid/js/app/plugins/grid-component/board-appearance-plugin

  • board_vew (Optional): Specifies the view for kanban board. Default orodatagrid/js/app/views/board/board-view

  • card_view (Required): Specifies the view for kanban card.

  • column_header_view (Optional): Specifies the view for board column header. Default orodatagrid/js/app/views/board/column-header-view

  • column_view (Optional): Specifies the view for board column. Default orodatagrid/js/app/views/board/column-view

  • acl_resource (Optional): Enabled Acl resource checks whether board items transitions are allowed. If no permission is granted to a user, they see the board in read only mode.

  • processor (Optional): Specified the name of the board processor. default processor is used by default.

  • default_transition (Optional): Section to specify configuration for the transition, e.g., update property when cards are dragged and dropped from one column to another.

default_transition:
    class: #class to be used for transition
    params: #additional params to pass to transition
        key: value
    save_api_accessor: #Describes the way to send update request. Please see documentation for :ref:`oroui/js/tools/api-accessor <bundle-docs-platform-ui-bundle-apiaccessor>`.

Related Articles