Introduction to React Query Builder

How to Create a React App With React Query Builder Using npm

Add Fields and Operators to React Query Builder

Getting started

How to Build a Multilingual React Site with Query Builder

Customize or Replace Default Component in React Query Builder

How to Configure Built-in Input Types in React Query Builder

How to Customize the React Query Builder ValueEditor Component

Configuration

Create SQL Queries With React formatQuery and valueProcessor

Push a React Query Builder API Server to Heroku With Git

Add a PostgreSQL Database to React Query Builder

How to Fetch Data From a React API

How to Build a Data Table in React With AG Grid

How to Visualize React API Data in a Graph With AG Charts

Integrating with an API

How to Build a New React API Endpoint

How to Add a New API and Variables to React Query Builder

How to Fetch and Display Data With React Query Builder

How to Add a Google Maps Object to a React Site

Geographic data

How to Bulk Edit Data With React Query Builder

How to Add Features to the React onClickUpdate Feature

How to Build Custom ValueEditor Components in React

Bulk edits

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

 is useful for displaying different representations of the query, namely the internal JSON format (

), the internal format with rule identifiers stripped out (

 clause only), and a parameterized format useful for interacting with APIs.

Besides the format of the query representation, 

 has a couple of other options that can be set. 

 is a function that will process rule values, and 

 will quote field names with the provided quote character in SQL mode.

---
title: Create SQL Queries With React formatQuery and valueProcessor
description: Preparing for the server setup by processing the output of the query builder into database-ready SQL
privateVideoUrl: https://fullstack.wistia.com/medias/cwzge3ch9u
---

# Formatting the query

## The `formatQuery` function

In this lesson we'll focus on the `formatQuery` function exported by `react-querybuilder`. `formatQuery` is useful for displaying different representations of the query, namely the internal JSON format (`"json"`), the internal format with rule identifiers stripped out (`"json_without_ids"`), SQL format (`"sql"`; the `WHERE` clause only), and a parameterized format useful for interacting with APIs.

Besides the format of the query representation, `formatQuery` has a couple of other options that can be set. `valueProcessor` is a function that will process rule values, and `quoteFieldNamesWith` will quote field names with the provided quote character in SQL mode.

## The `valueProcessor` function

The `valueProcessor` function is useful when your database engine requires special handling of certain value types. For example, the Oracle RDBMS does not have a native Boolean column type, so people typically use `VARCHAR2` with the values `'Y'` and `'N'` representing `true` and `false`, respectively. The default `valueProcessor` function will use `TRUE` and `FALSE`, so we would need to convert that to `'Y'` and `'N'`. Another value type that typically needs special handling is the date type. Most database engines have their own special syntax or functions for dates.

To demonstrate the capabilities of the `valueProcessor` function, we'll wrap the `defaultValueProcessor` from `react-querybuilder` and adjust the output to show what really happens to date fields on the server. Create a file called `valueProcessor.ts` in the `client/src/` folder.

Preparing for the server setup by processing the output of the query builder into database-ready SQL

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

WELCOMEIntroduction

Introduction:

Start Here

Module 1: Getting started

Introduction: (1:18)

Introduction to React Query Builder

Lesson 1:

How to Create a React App With React Query Builder Using npm

Lesson 2: (4:13)

Add Fields and Operators to React Query Builder

Module 2: Configuration

Lesson 1:

How to Build a Multilingual React Site with Query Builder

Lesson 2:

Customize or Replace Default Component in React Query Builder

Lesson 3:

How to Configure Built-in Input Types in React Query Builder

Lesson 4:

How to Customize the React Query Builder ValueEditor Component

Module 3: Integrating with an API

Lesson 1: (5:24)

Create SQL Queries With React formatQuery and valueProcessor

Lesson 2: (12:38)

Push a React Query Builder API Server to Heroku With Git

Lesson 3: (16:28)

Add a PostgreSQL Database to React Query Builder

Lesson 4: (6:10)

How to Fetch Data From a React API

Lesson 5: (11:37)

How to Build a Data Table in React With AG Grid

Lesson 6: (7:05)

How to Visualize React API Data in a Graph With AG Charts

Module 4: Geographic data

Lesson 1:

How to Build a New React API Endpoint

Lesson 2: (7:33)

How to Add a New API and Variables to React Query Builder

Lesson 3:

How to Fetch and Display Data With React Query Builder

Lesson 4:

How to Add a Google Maps Object to a React Site

Module 5: Bulk edits

Lesson 1: (12:16)

How to Bulk Edit Data With React Query Builder

Lesson 2:

How to Add Features to the React onClickUpdate Feature

Lesson 3:

How to Build Custom ValueEditor Components in React

Create SQL Queries With React formatQuery and valueProcessor