Important

You are browsing the documentation for version 4.2 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. 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, do the following:

  • Go to the datagrid yml

  • Add the following lines into 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

Board appearance uses save_api_accessor internally, so please check that at least one of the following options is configured properly:

  • 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 columns sort order.
        priority: ASC
  • default_column (Optional): Specifies a column ID to show entities which do not have any 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>`.