Skip to main content
A specialized grid card that displays all data from a data store organized by taxon groups. The component presents data in a tabbed interface where each tab represents a different group taxon from the content taxonomy. Includes an option to download the entire data store as an Excel file.

​
Type

type: "dataStoreGrid"

​
Properties

​
Required Properties

PropertyTypeDescription
dataStoreRefstringReference to the data store to display

​
Optional Properties

None

​
Layout

  • Default Width: 12 columns
  • Default Height: 10 rows
  • Supports Children: No

​
Configuration Example

- type: dataStoreGrid
  id: myDataStoreGrid
  properties:
    dataStoreRef: "my-data-store-ref"
  layout:
    x: 0
    y: 0
    w: 12
    h: 10

​
Advanced Usage

​
Tab Organization

The component automatically creates tabs for each enabled group taxon in the content taxonomy. Only root-level group taxons (without ”/” in their path) are included.

​
Download Functionality

A special “Download as Excel” tab is automatically added, allowing users to export all data from the data store across all taxon groups into a single Excel file.

​
Grid Display

Each taxon tab displays data using the KodexaDataObjectGridContainer component with:
  • Read-only mode (editable is set to false)
  • Automatic column configuration based on taxon structure
  • Data filtered by the selected group taxon

​
Empty State

If the specified data store reference is not found, the component displays an informative empty state with:
  • Database icon
  • Message explaining the issue
  • The actual data store reference that was requested

​
Example: Multi-Taxonomy Data Store

- type: dataStoreGrid
  id: projectDataGrid
  properties:
    dataStoreRef: "project-123"
  layout:
    x: 0
    y: 0
    w: 12
    h: 12
This creates tabs for each root-level taxon group (e.g., “Customers”, “Orders”, “Products”) plus a “Download as Excel” tab.

​
Notes

  • The data store reference must match an existing data store in the project
  • Only group taxons from content taxonomies are shown as tabs
  • The grid is read-only and does not support inline editing
  • Data is automatically filtered by the selected taxon group
  • The component watches for taxonomy changes and updates tabs accordingly
  • Excel download includes all group taxons (except the download tab itself)
  • If the data store doesn’t exist, users are informed which reference was attempted