Introduction to React Query Builder

Initializing the query builder

Fields and operators

Getting started

Translations

Other customizations

Built-in input types

Custom value editors

Configuration

Formatting the query

Server setup, part 1

Server setup, part 2

Fetching data

Displaying data in the grid

Displaying data in a chart

Integrating with an API

Adding a new API endpoint

Preparing a new data set

Displaying the new data

Displaying a map

Geographic data

Setting up the bulk editor

Enhancing the bulk editor

Finalizing the bulk editor

Bulk edits

react

react-querybuilder

node-sass

postgresql

typescript

In this course we teach you how to create admin reports with React using a query builder. Admin reporting is a broad topic, and getting started can be overwhelming.

In five modules, we cover configuration of the query builder, setting up a server, displaying data in a grid, chart, and map, as well as some more advanced uses of the query builder. It's about three hours long and comes with code samples.

The course is taught by Jake Boone, who uses React Query Builder in real, mission-critical applications for a large engineering and construction firm.

In this course, we'll be using React Query Builder to create admin reports with complex filtering, bulk editing, data grids, charts, and maps.

Building Advanced Admin Reporting in React

Now we're going to use a query builder for a different purpose: bulk editing. This is useful when your data grid is updateable and you want to be able to define many changes at once.

First we'll add a selection column to the data grid so users can determine exactly which rows they want to update. Make sure to set the 

 so we can select multiple rows.  We'll also need to capture the grid API in a state variable for later use.

import { ColDef, GridApi } from "ag-grid-community";

  const [gridApi, setGridApi] = useState<GridApi>();

        <AgGridReact
          columnDefs={[
            {
              field: "selectionColumn",
              headerCheckboxSelection: true,
              checkboxSelection: true,
              width: 40,
            },
            ...(dataset === "sales" ? columnDefs : columnDefsUNL),
          ]}
          onGridReady={(gre) => setGridApi(gre.api)}
          rowData={dataset === "sales" ? rawData : rawDataUNL}
          rowSelection="multiple"
          suppressPropertyNamesCheck
        />

---
title: Setting up the bulk editor
description: Using React Query Builder for a completely different purpose
privateVideoUrl: https://fullstack.wistia.com/medias/0sgppx4741
---

# Setting up the bulk editor

Now we're going to use a query builder for a different purpose: bulk editing. This is useful when your data grid is updateable and you want to be able to define many changes at once.

## Grid configuration

First we'll add a selection column to the data grid so users can determine exactly which rows they want to update. Make sure to set the `rowSelection` prop to `"multiple"` so we can select multiple rows.  We'll also need to capture the grid API in a state variable for later use.

```typescript { actualFilename=./protected/src/App.tsx endLine=3 startLine=3 statedFilename=client/src/App.tsx url=https&#x3A;//gitlab.com/fullstackio/books/building-advanced-admin-reporting-in-react/module_05/lesson_05.01/protected/src/App.tsx#L3 }
import { ColDef, GridApi } from "ag-grid-community";
```

```typescript { actualFilename=./protected/src/App.tsx endLine=53 startLine=53 statedFilename=client/src/App.tsx url=https&#x3A;//gitlab.com/fullstackio/books/building-advanced-admin-reporting-in-react/module_05/lesson_05.01/protected/src/App.tsx#L53 }
  const [gridApi, setGridApi] = useState<GridApi>();
```

```typescript { actualFilename=./protected/src/App.tsx endLine=170 startLine=156 statedFilename=client/src/App.tsx url=https&#x3A;//gitlab.com/fullstackio/books/building-advanced-admin-reporting-in-react/module_05/lesson_05.01/protected/src/App.tsx#L156 }
        <AgGridReact
          columnDefs={[
            {
              field: "selectionColumn",
              headerCheckboxSelection: true,
              checkboxSelection: true,
              width: 40,
            },
            ...(dataset === "sales" ? columnDefs : columnDefsUNL),
          ]}
          onGridReady={(gre) => setGridApi(gre.api)}
          rowData={dataset === "sales" ? rawData : rawDataUNL}
          rowSelection="multiple"
          suppressPropertyNamesCheck
        />
```

## Query builder configuration

For the query builder configuration, we can re-use the `fields` from our SQL-generating query builder setup, but we'll use different operators. (The `ValueEditor` component will also need to be different, but we'll cover that in a subsequent lesson.)

Set up a new state variable to hold the update query and place a **new** `<QueryBuilder />` component just above the data grid. Place a button below the new query builder labeled "Update".

Using React Query Builder for a completely different purpose

Learn

The newline Guide to Building Your First GraphQL Server with Node and TypeScript

Teach

Amelia Wattenberger

Author of Fullstack D3

Community

Building Advanced Admin Reporting in React

Welcome: Introduction

Introduction:

Start Here

Module 0: Getting started

Introduction: (1:18)

Introduction to React Query Builder

Lesson 1: (11:12)

Initializing the query builder

Lesson 2: (4:13)

Fields and operators

Module 1: Configuration

Lesson 1: (7:20)

Translations

Lesson 2: (6:58)

Other customizations

Lesson 3: (4:35)

Built-in input types

Lesson 4: (11:19)

Custom value editors

Module 2: Integrating with an API

Lesson 1: (5:24)

Formatting the query

Lesson 2: (12:38)

Server setup, part 1

Lesson 3: (16:28)

Server setup, part 2

Lesson 4: (6:10)

Fetching data

Lesson 5: (11:37)

Displaying data in the grid

Lesson 6: (7:05)

Displaying data in a chart

Module 3: Geographic data

Lesson 1: (2:28)

Adding a new API endpoint

Lesson 2: (7:33)

Preparing a new data set

Lesson 3: (9:22)

Displaying the new data

Lesson 4: (11:23)

Displaying a map

Module 4: Bulk edits

Lesson 1: (12:15)

Setting up the bulk editor

Lesson 2: (7:54)

Enhancing the bulk editor

Lesson 3: (10:01)

Finalizing the bulk editor

Setting up the bulk editor

Grid configuration#

Query builder configuration#