Report.Skip() Method

Version: Available or changed with runtime version 1.0.

Skips the current iteration of the current report or XmlPort.

Syntax

 Report.Skip()

Parameters

Report
 Type: Report
An instance of the Report data type.

Remarks

The Skip method allows you to conditionally skip processing of the current report or XMLport. If the processing occurs inside a loop, the processing continues with the next record after the Skip method is called.

A typical situation in which you will use SKIP is when you want to retrieve records from a related table by using values in the current record for forming a filter. If the values in the current record already indicate that no records from the related table will be retrieved, there is no need to perform this processing and you can use SKIP to avoid the processing.

Note

The Skip method still calls remaining triggers for the current record, but the record is omitted from the dataset.

Example

The following example shows how to use the Skip method to skip processing the current record if the balance field of the record is zero. Processing of records will continue until a record that has a balance of 0 is encountered.

var
    Balance: Decimal;
begin
    if Balance = 0 then  
      CurrReport.Skip  
    else  
      ... // Do some processing.  
end;

See Also

Report Data Type
Get Started with AL
Developing Extensions