{"title":"Using request pages with reports","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-request-pages-for-reports/","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/devenv-request-pages-for-reports, 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/devenv-request-pages-for-reports","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":"Introducing how to work with request pages with Business Central reports.","date":"2024-03-11","meta":{"topic":"concept-article"},"outline":[{"level":1,"title":"Using request pages with reports","slug":"using-request-pages-with-reports","at":0,"chars":9086},{"level":2,"title":" Filtering on request pages","slug":"filtering-on-request-pages","at":2272,"chars":1502},{"level":2,"title":"Defining a requestpage section","slug":"defining-a-requestpage-section","at":3774,"chars":2277},{"level":2,"title":"Adding teaching tips to your reports","slug":"adding-teaching-tips-to-your-reports","at":6051,"chars":949},{"level":2,"title":"Adding help links to your reports","slug":"adding-help-links-to-your-reports","at":7000,"chars":715},{"level":2,"title":"Saving settings on the request page","slug":"saving-settings-on-the-request-page","at":7715,"chars":284},{"level":2,"title":"Request page and preview triggers and operations","slug":"request-page-and-preview-triggers-and-operations","at":7999,"chars":340},{"level":2,"title":"Related information","slug":"related-information","at":8339,"chars":747}],"text":"# Using request pages with reports\nA request page is a page that is run before the report starts to execute. Request pages enable end users to specify options and filters for the report. Request pages are defined as part of designing a devenv-report-object or a Report Extension Object<devenv-report-ext-object>. The syntax is shown further down in this article. You design the filters on request pages by using the following report properties:\nProperty|Description\nproperties/devenv-requestfilterheading-property|Sets a caption for the request page tab that is related to a report's data item or an XMLport's table element.\nproperties/devenv-requestfilterheadingml-property|Sets the text used as a RequestFilterHeading Property for a request page tab.\nproperties/devenv-requestfilterfields-property|Specifies which columns are automatically included on the tab of the request page that is related to a report's data item or an XMLport's table element. The user can set filters on these columns.\nproperties/devenv-abouttitle-property|Specifies the title for a teaching tip on the report.\nproperties/devenv-abouttitleml-property|Specifies the multi-language version of the title for a teaching tip on the report.\nproperties/devenv-abouttext-property|Specifies the text for a teaching tip on the report.\nproperties/devenv-abouttextml-property|Specifies the multi-language version of the text for a teaching tip on the report.\nproperties/devenv-contextsensitivehelppage-property|Specifies the help article to show when the user presses Help in the UI. The help server on which this help article is located, must be defined in the app.json file.\nBy default, a request page is displayed, unless the properties/devenv-userequestpage-property is set to false; then the report immediately runs. In this case, end users can't cancel the report. It's still possible to cancel the report, but some pages might print.\nA request page has a predefined set of buttons depending on the report type and the current layout. The standard buttons are\n|Button|Rdlc|Word|Excel|Processing Only|\n|Ok||||x|\n|Cancel|x|x|x|x|\n|Preview|x|x|||\n|Print|x|x|||\n|SendTo|x|x|x||\n|Download|||x||\nAdditionally, you can add more options on the request page to allow the end user to filter the data displayed.\n##  Filtering on request pages\nThe columns that you define as RequestFilterFields are shown on the request page and can be used for filtering the data before viewing or printing the report.\nDefining the RequestFilterFields property in the `dataitem()` part of the report code is done as illustrated in the following code example:\n```al\nreport 50103 \"Customer List\"\n{\n    // report properties\n    ...\n\n    dataset\n    {\n        dataitem(Customer; Customer)\n        {\n            RequestFilterFields = \"No.\", \"Search Name\", \"Customer Posting Group\";\n...\n```\n> NOTE\n> It's recommended to add columns that the end users of the report frequently set filters on.\nFor more information about the report object, see devenv-report-object.\nBy default, for every data item in the report, a FastTab for defining filters is shown on the request page. To remove a FastTab from a request page, don't define any RequestFilterFields for the data item and set the DataItemTableView property to define sorting. Then no tab for this data item or table element is displayed on the request page.\nFor data items and table elements whose source table contains calculated fields, such as amounts and quantities, the Filter totals by: section is automatically included on the request page, which allows you to adjust various dimensions that influence calculations.\n> TIP\n> For information about how to enter filter criteria on the request page, see /ui-enter-criteria-filters#-filtering in the Business Central application help.\n## Defining a requestpage section\nOn reports, in addition to defining the filter options by setting the RequestFilterFields property, you can add a requestpage section. In this section, you can set the properties/devenv-savevalues-property property to true in order to save the values that the end user enters on the request page. When the report is run again, the end user has the option to use previously defined filters.\nYou can also add a layout to the request page, specifying an Options section to perform checks.\n> NOTE\n> You can use the SaveValues property together with the properties/devenv-allowscheduling-property property to set up the request page to support multiple previews. When both properties are true, users can preview the report from the request page as many times as the like, without having the request page close. This capability lets users change filters, see what the generated report will look like, and then try again. If either property is set to false, the report won't support multiple previews and the request page closes once the user previews the report. In this case, the request page includes a Preview and Close button instead of Preview.\n```al\n...\nrequestpage\n    {\n        SaveValues = true;\n\n        // These properties control the title and content of the teaching tip.\n        AboutTitle = 'Awesome report';\n        AboutText = 'This is an awesome report. Use it to be awesome';\n        // Use the multi-language versions AboutTitleML and AboutTextML if you need that.\n\n        // This property defines the help page for this report.\n        // Remember to also set contextSensitiveHelpUrl in the app.json\n        ContextSensitiveHelpPage = 'business-central/sales-reports';\n\n        layout\n        {\n            area(content)\n            {\n                group(Options)\n                {\n                    Caption = 'Options';\n                    field(PostingDate; PostingDateReq)\n                    {\n                        ApplicationArea = Basic, Suite;\n                        Caption = 'Posting Date';\n                        ToolTip = 'Specifies the posting date for the invoice(s) that the batch job creates. This field must be filled in.';\n                    }\n                }\n            }\n        }\n    }\n...\n```\n## Adding teaching tips to your reports\nThe primary purpose of a teaching tip is to increase the user's chance of success with the report. So, the title and description of the teaching tip should answer the following hypothetical user questions:\n AboutTitle: What is this report about?\n AboutText: What can I do with this report?\nBoth of these properties (or their equivalent multi-language versions) must be defined on the request page for the teaching tip to appear.\nWith teaching tips, you can help explain logic that is relevant to the report therefore allowing users to get on with a reporting task right away without blocking them. After users dismiss a teaching tip, they can choose or hover over the report title in the request page. This action reopens the teaching tip.\nFor more information about designing teaching tips and tours, see Teaching tips and in-app tours for onboarding users<../administration/onboarding-teaching-tips-tours>.\n## Adding help links to your reports\nA key pillar of helping users help themselves is to give them access to help for the particular part of Business Central that they're working in. This also applies for reports.\nStarting with Business Central 2023 release wave 1 (version 22), you can set the ContextSensitiveHelpPage property on report request pages, which will in turn show the report help link in the Help pane.\nLearn more links are generated based on two configuration settings:\n App-level configuration of the URL\n Request page-level configuration of report-specific article\nFor more information about configuring context-sensitive help, see Configure Context-Sensitive Help<../help/context-sensitive-help>.\n## Saving settings on the request page\nWhen running reports, users can use one or more saved settings that they can apply to the report from the request page. For more information on this article, see Manage Saved Settings for Reports and Batch jobs</reports-saving-reusing-settings>\n## Request page and preview triggers and operations\nThe following diagram illustrates the main trigger and operation sequence related to request page invocation and button actions.\n![Shows the report trigger main flow]\nFor a more detailed discussion on these concepts, see Report triggers and operations<devenv-report-triggers#requestpage>\n## Related information\ndevenv-report-object\nReport Extension Object<devenv-report-ext-object>\nReports Overview<devenv-reports>\ndevenv-report-design-overview\nmethods-auto/report/reportinstance-runrequestpage-method\nConfigure Context-Sensitive Help for reports<../help/context-sensitive-help>\nproperties/devenv-abouttitle-property\nproperties/devenv-abouttitleml-property\nproperties/devenv-abouttext-property\nproperties/devenv-abouttextml-property\nproperties/devenv-contextsensitivehelppage-property\nproperties/devenv-requestfilterheading-property\nproperties/devenv-requestfilterheadingml-property\nproperties/devenv-requestfilterfields-property\nproperties/devenv-dataitemtableview-property\nRequest page triggers and operations<devenv-report-triggers>"}