{"title":"Report.Skip() Method","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/report/reportinstance-skip-method/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/report/reportinstance-skip-method, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/report/reportinstance-skip-method","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Skips the current iteration of the current report or XmlPort.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":2,"title":"Syntax","slug":"syntax","at":122,"chars":35},{"level":2,"title":"Parameters","slug":"parameters","at":157,"chars":91},{"level":2,"title":"Remarks","slug":"remarks","at":248,"chars":714},{"level":2,"title":"Example","slug":"example","at":962,"chars":374},{"level":2,"title":"Related information","slug":"related-information","at":1336,"chars":134}],"text":"> Version: _Available or changed with runtime version 1.0._\nSkips the current iteration of the current report or XmlPort.\n## Syntax\n```al\n Report.Skip()\n```\n## Parameters\nReport\nType: report-data-type\nAn instance of the report-data-type data type.\n## Remarks\nThe 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.\nA 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.\n> NOTE\n> The Skip method still calls remaining triggers for the current record, but the record is omitted from the dataset.\n## Example\nThe 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.\n```al\nvar\n    Balance: Decimal;\nbegin\n    if Balance = 0 then\n      CurrReport.Skip\n    else\n      ... // Do some processing.\nend;\n```\n## Related information\nreport-data-type\nGet Started with AL<../../devenv-get-started>\nDeveloping Extensions<../../devenv-dev-overview>"}