{"title":"Record.AddLoadFields([Any,...]) Method","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/record/record-addloadfields-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/record/record-addloadfields-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/record/record-addloadfields-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":"Specifies fields to be initially loaded when the record is retrieved from its data source.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":1,"title":"Record.AddLoadFields([Any,...]) Method","slug":"recordaddloadfieldsany-method","at":0,"chars":2458},{"level":2,"title":"Syntax","slug":"syntax","at":291,"chars":70},{"level":2,"title":"Parameters","slug":"parameters","at":361,"chars":180},{"level":2,"title":"Return Value","slug":"return-value","at":541,"chars":255},{"level":2,"title":"Remarks","slug":"remarks","at":796,"chars":896},{"level":2,"title":"Example","slug":"example","at":1692,"chars":580},{"level":2,"title":"Related information","slug":"related-information","at":2272,"chars":186}],"text":"# Record.AddLoadFields([Any,...]) Method\n> Version: _Available or changed with runtime version 6.0._\nSpecifies fields to be initially loaded when the record is retrieved from its data source. Subsequent calls to AddLoadFields will not overwrite fields already selected for the initial load.\n## Syntax\n```al\n[Ok := ]  Record.AddLoadFields([Fields: Any,...])\n```\n## Parameters\nRecord\nType: record-data-type\nAn instance of the record-data-type data type.\n*[Optional] Fields*\nType: ../any/any-data-type\nThe FieldNo's of the fields to be loaded.\n## Return Value\n*[Optional] Ok*\nType: ../boolean/boolean-data-type\ntrue if all fields are selected for subsequent loads; otherwise, false. If you omit this optional return value and the operation does not execute successfully, a runtime error will occur.\n## Remarks\nIt is not necessary to include the following fields, because they are always selected for loading: Primary key, SystemId, and data audit fields (SystemCreatedAt, SystemCreatedBy, SystemModifiedAt, SystemModifiedBy).\nDepending on the runtime version, the runtime may require extra fields to be selected for loading. Which extra fields to specify depends on the state of the record and table or table extension definition. For example, fields that are filtered upon are always loaded.\n> NOTE\n> Only fields of `FieldClass = Normal` are supported as input values for the Fields parameter. If fields of `FieldClass = FlowFilter` or `FieldClass = FlowField` are passed, the return value will be false if observed; otherwise, a runtime error will occur.\nThis method is part of the partial records capability for improving performance. See Using partial records<../../devenv-partial-records>.\n## Example\nThe following example code shows how to use the AddLoadFields method to add a field for loading on a report. The example loads a field that is outside of the default fields selected by DataColumns of the report. The field is added by using the AddLoadFields on the ../../triggers-auto/reportdataitem/devenv-onpredataitem-reportdataitem-trigger.\n```al\ntrigger OnPreDataItem()\nbegin\n    CurrencyDataItem.AddLoadFields(\"ISO Numeric Code\");\nend;\n\ntrigger OnAfterGetRecord()\nbegin\n    if CurrencyDataItem.\"ISO Numeric Code\" <> 'DKK' then\n        CurrReport.Skip();\nend;\n```\n## Related information\nUsing Partial Records<../../devenv-partial-records>\nrecord-data-type\nGet Started with AL<../../devenv-get-started>\nDeveloping Extensions<../../devenv-dev-overview>"}