Skip to main content

Simple List Report

This guide provides a step-by-step walkthrough for building a fundamental list report in Fast Designer. You will learn how to configure a local JSON data source, map fields to layout bands, format data expressions, and implement basic summary calculations.


Step 1: Initialize an Empty Report

  1. Launch Fast Designer.
  2. Click New from the file menu (or press Ctrl + N).
  3. Select Empty Report from the template gallery to establish a blank workspace.

Creating a New Report Workspace


Step 2: Establish a JSON Data Connection

  1. Navigate to the data configuration options: Data SourceManage Data Source (or press Ctrl + M).
  2. Click New and select New Connection from the drop-down menu.

Adding a New Connection

  1. Choose JSON as the connection provider type.
  2. Input your dataset schema into the configuration text editor using the following structural format:
{
"electronics": [
{
"item_id": 1,
"Name": "Samsung Galaxy S24",
"Category": "Smartphone",
"manufacture_date": "2025-01-15",
"quantity": 50,
"price": 899.99
},
{
"item_id": 2,
"Name": "Apple MacBook Air M3",
"Category": "Laptop",
"manufacture_date": "2025-02-10",
"quantity": 25,
"price": 1299.0
}
]
}

json.png

  1. Click OK, then click Next to review your structural data entities. datasource.png
  2. Click Finish to populate your active workspace fields.

Step 3: Populate Layout Data Bands

Once the connection is established, the Data Sources Window updates with your newly defined database collections.

  1. Locate the electronics entity block in the data explorer tree.

  2. Drag and drop the Name data field from the schema tree directly onto the active Data1 workspace band row.

  3. Repeat this process for the remaining entity fields: Category, manufacture_date, quantity, and price.

drag_drop.png

Step 4: Configure Page Header Columns

To provide context for your row values, add text labels into the structural page headers.

edit_text.png

  1. Select Text Object from the left toolbar, or go to Main MenuInsertText.

  2. Insert the component inside the PageHeader band area.

  3. Double-click the new element (or right-click and select Edit) to open the text modification canvas.

  4. Input the desired display name for the column header.

  5. Create and place individual header labels for all corresponding data.

Step 5: Assign Component Formatting

Ensure that variable values render cleanly by declaring explicit data types.

date.png

  1. Right-click the variable component mapped to manufacture_date inside the Data1 band.

  2. Select Formats (or double-click to open properties, then click Formats).

  3. Set the target conversion category rules to Date.

  4. Repeat these actions for the numeric variables, applying appropriate Currency formats for Price and Integer properties for Quantity.

Step 6: Implement Aggregate Summary Calculations

To track inventory totals, create an aggregation formula to compute overall quantities.

  1. In the Data Source explorer window, right-click Totals and select New Total.

    new_total.png

  2. Define a unique identifier name for the expression.

  3. Set your target evaluation metric by mapping the quantity attribute into the Data Column field. edit_total.png

    tip

    You can easily assign this target by opening the formula wizard and dragging the column directly from the data source hierarchy tree.

  4. Click OK to register the summary field.

  5. Navigate to Main MenuReportReport Summary to append a final totals summary section to your report structure.

  6. Drag your newly created aggregation object from the catalog panel and position it within the ReportSummary1 band area.

  7. Place an adjacent descriptive label component next to the variable and assign it the string value "Total Quantity:".

Step 7: Compile and Preview Layouts

Your basic document layout structure is now complete. Click Preview on the main application toolbar (or press F5) to compile your logic and verify data rendering outputs.

preview.png