Any valid expression that includes a field or a combination of fields from the current table or set that specifies what you want to examine.
Optional. When to use the function (instead of on every record).
Optional. When to reset the value produced by the function to 0 (instead at the end of all records). The Group and Sub_Group are optional parameters that define the range of records to summarize, and may or may not be required, depending upon the context of the summary calculation. Possible values for GRP R11; >Group and GRP R11; >Sub_Group include:
- GRAND (all records)
- The name of the current table
- The name of a table in the current set
- The name of a grouping level that is defined in a report layout
- DETAIL (over the records in the detail section)
Get the running total of subexpression over group 'over' sampled each group 'each'
RUN_TOTAL() is used in the Detail section of a report to return the running total of the Expression evaluated from the first record to the current record related to the group. The expression is evaluated from the first record to the current record in the sub-group, and the resulting total value is returned. For example, to summarize the line-items in an invoice set, the Group parameter might be GRP -> INV_HEAD and the Sub_Group parameter GRP -> INV_ITEM. This means the Summary operation includes only those child records in INV_ITEM related to the current parent record in the Inv_head table. To summarize all the records in a table or set, use the name GRAND as the Group name. The Group GRP -> GRAND and Sub_Group GRP -> INV_ITEM produce a summary result based upon all invoices. This function is a report writer function, not intended for table level field rules or other expressions. While the function may perform in some areas outside of the report writer, its use there is not supported.
Assume that an invoicing set consists of two tables. One holds the invoices (INVOICE), and the other holds each invoice's line-items ( INV_ITEM ):
- CUST_ID and INV_TOTAL
INVOICE is related to INV_ITEM through a one-to-many link on the INV_NO field. To find the running total of line-item records, use the following expressions:
run_total(INV_ITEM->AMOUNT) -> 35.50, if the current INV_NO is "I101" run_total(INV_ITEM->AMOUNT) -> 168.75, if the current INV_NO is "I103"
The following calculated field provides a running total in a browse that contains a field named num_field.
if( eof( "tablename"),total(num_field),run_total(num_field) )
This function is a report writer function, not intended for table level field rules or other expressions.