GetSummary()
Category: Summary
Syntax: GetSummary ( summaryField; breakField ) |
Parameters:
summaryFieldA field of type summary, or an expression that returns a reference to one.
breakFieldA field, or an expression that returns a reference to one.
Data type returned: Number, Date, Time, Timestamp
Description:
The GetSummary() function returns the value of summaryField when summarized by breakField. The found set must be sorted by breakField for GetSummary() to return the proper value.
GetSummary() returns the same values that you would see if you were to place the specified summary field in a subsummary report. GetSummary() is necessary when you need to use summarized values in calculation formulas or for display purposes while in Browse mode.
Note, you could also achive similar results using a self-join relationship and aggregate functions.
To calculate a grand summary value, use the same summary field for both the summary field and the break field parameters.
Examples:
Given the following record set, sorted by Country, and a summary field called Sum_Sales defined as the Total of Sales:
Country | Region | Sales |
|---|---|---|
U.S. | North | 55,000 |
U.S. | South | 45,000 |
China | North | 35,000 |
China | South | 40,000 |
A field SalesByCountry defined as
GetSummary (Sum_Sales; Country)
returns 100,000 for the two U.S. records and returns 75,000 for the two China records.
Категории