CALCFIELDS Function (Record)
Calculates the FlowFields in a record. You specify which fields to calculate by using parameters.
[Ok :=] Record.CALCFIELDS(Field1, [Field2],...)
- Type: Record The record in the table to update.
- Field1, Field2, …
- Type: Field The FlowFields or BLOB fields that you want to calculate or retrieve. Each field must belong to the same record variable.
FlowFields are virtual fields. The values in these fields are not saved in the table. This means that you must use either the CALCFIELDS function or the SETAUTOCALCFIELDS Function (Record) to update them. For example, if you retrieve a record using the FIND Function (Record) and NEXT Function (Record), the FlowFields in those records are set to zero (0). Then, when you call CALCFIELDS, their values are updated.
When a FlowField is a direct source expression on a page or a report, the calculation is performed automatically.
You can also use the CALCFIELDS function to retrieve binary large objects (BLOBs). For more information, see BLOB Data Type.
If possible, the CALCFIELDS function uses SumIndexField Technology (SIFT). SIFT is used only if the following conditions are true:
The Microsoft Dynamics NAV key contains the fields that are used in the filters that are defined for the FlowField.
The SumIndexFields on the Microsoft Dynamics NAV key contain the fields that are provided as parameters for calculation.
The MaintainSIFTIndex Property is set to Yes.
Note By default this property is set to Yes for all keys.
|Microsoft Dynamics NAV 2013 automatically maintains a count for all SIFT indexes. Therefore, if the calculation method for a FlowField is COUNT or AVERAGE, then the condition that the SumIndexFields on the Microsoft Dynamics NAV key contain the fields that are provided as parameters for calculation is not required.|
For Microsoft Dynamics NAV 2013, CALCFIELDS execution is decoupled from Microsoft Dynamics NAV SIFT index definitions. This means that if the conditions for using SIFT indexes are not true, then Microsoft Dynamics NAV traverses all records in the base table to perform the calculation instead of using SIFT. This can reduce the number of required SIFT indexes, which can improve performance. In earlier versions of Microsoft Dynamics NAV, if the conditions for using SIFT indexes were not true and the MaintainSIFTIndex property was enabled, then you received an error when you called the CALCFIELDS function. This provided a degree of protection in earlier versions against accidentally requesting a sorting for which no index existed. In Microsoft Dynamics NAV 2013, an index is not required to support a certain sorting, but sorting without an index could lead to bad performance if a search returns a large result set, which would then have to be sorted before the first row is returned.
This example shows how to use the CALCFIELDS function to find the balance on December 31, 2008 and the net change for a customer in 2008.
This example requires that you create the following variable.
CustomerRec.SETRANGE("Date Filter",010108D,123108D); CustomerRec.CALCFIELDS(Balance, "Net Change");
The first line sets up a filter for the Date Filter field in the Customer record. This field is a FlowFilter field which is used in the filter definition for several FlowFields in the Customer record. In the second line, the FlowFields are calculated.