{"title":"RecordRef.FindFirst() Method","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/recordref/recordref-findfirst-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/recordref/recordref-findfirst-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/recordref/recordref-findfirst-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":"Finds the first record in a table based on the current key and filter.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":2,"title":"Syntax","slug":"syntax","at":131,"chars":52},{"level":2,"title":"Parameters","slug":"parameters","at":183,"chars":100},{"level":2,"title":"Return Value","slug":"return-value","at":283,"chars":238},{"level":2,"title":"Remarks","slug":"remarks","at":521,"chars":257},{"level":2,"title":"Example","slug":"example","at":778,"chars":705},{"level":2,"title":"Related information","slug":"related-information","at":1483,"chars":137}],"text":"> Version: _Available or changed with runtime version 1.0._\nFinds the first record in a table based on the current key and filter.\n## Syntax\n```al\n[Ok := ]  RecordRef.FindFirst()\n```\n## Parameters\nRecordRef\nType: recordref-data-type\nAn instance of the recordref-data-type data type.\n## Return Value\n*[Optional] Ok*\nType: ../boolean/boolean-data-type\ntrue if the operation was successful; otherwise false. If you omit this optional return value and the operation does not execute successfully, a runtime error will occur.\n## Remarks\nYou should use this method instead of Find\\('-'\\) when you need only the first record.\nYou should use this method only when you explicitly want to find the first record in a table or set. Do not use this method in combination with repeat..until.\n## Example\nThe following example opens the Item table \\(27\\) as a RecordRef variable that is named ItemRecref. The FindFirst method searches for the first record in the table. If the record is found, the description and unit price of the item in the record are displayed in a message box. Otherwise, a message that indicates that the first item was not found is displayed.\n```al\nvar\n    ItemRecref: RecordRef;\n    Text000: Label 'The first item is %1 and the unit price is %2.';\n    Text001: Label 'The first item was not found.';\nbegin\n    ItemRecref.Open(27);\n    if ItemRecref.FindFirst then\n      Message(Text000, ItemRecref.Field(3),  ItemRecref.Field(18))\n    else\n      Message(Text001);\nend;\n\n```\n## Related information\nrecordref-data-type\nGet Started with AL<../../devenv-get-started>\nDeveloping Extensions<../../devenv-dev-overview>"}