Functions Data

Report

Report() returns output from a Quintessence report.

ReportAsync() runs the report in the background, which is especially useful for larger reports since Excel stays responsive until the data is ready.


Qx.Report(Report, Headers, Arg1, Arg2, Arg3 … Arg16)
  • In Excel with Quintessence addin versions prior to 25.1, use: Report()
  • In the Quintessence Editor (Studio) using Quintessence language, use: Report()
  • In the Quintessence Editor (Studio) using Python language, use: Qx.Report()
 See parameter descriptions

ReportThe name of a Quintessence report.
Headers
(optional)
This parameter is required for ReportAsync(). For Report(), the value may be left blank.
Arg1, Arg2, … Arg16The parameter values, in order, as defined in the report configuration.

Remarks:

  • Unless changed by an administrator, the default parameters are:
    • Headers: True

Examples:

The examples provided below are based on fictitious data for illustrative purposes only.

> Example 1: Calling a report


A report named Get Location, which takes five parameters, is set up in Quintessence. The parameters are listed below.

Parameter nameParameter typeCell location in Excel
start_dateDateB2
priceNumberB3
locationTextB4
in_africaTrue/FalseB5
countriesArrayB6:C7

This report can be called from Excel using the formula below.

=Qx.Report(“Get Location”, True, B2, B3, B4, B5, B6:C7)