{"title":"TestPage.RunPageBackgroundTask(Integer [, var Dictionary of [Text, Text]] [, Boolean]) Method","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/testpage/testpage-runpagebackgroundtask-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/testpage/testpage-runpagebackgroundtask-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/testpage/testpage-runpagebackgroundtask-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":"Runs the page background task codeunit in a child session and waits for its completion.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":1,"title":"TestPage.RunPageBackgroundTask(Integer [, var Dictionary of [Text, Text]] [, Boolean]) Method","slug":"testpagerunpagebackgroundtaskinteger-var-dictionary-of-text-text-boolean-method","at":0,"chars":1408},{"level":2,"title":"Syntax","slug":"syntax","at":362,"chars":167},{"level":2,"title":"Parameters","slug":"parameters","at":529,"chars":594},{"level":2,"title":"Return Value","slug":"return-value","at":1123,"chars":149},{"level":2,"title":"Related information","slug":"related-information","at":1272,"chars":136}],"text":"# TestPage.RunPageBackgroundTask(Integer [, var Dictionary of [Text, Text]] [, Boolean]) Method\n> Version: _Available or changed with runtime version 4.0._\nRuns the page background task codeunit in a child session and waits for its completion. Note that page background task completion triggers are not invoked by default; see parameter \"RunCompletionTriggers\".\n## Syntax\n```al\nResults :=   TestPage.RunPageBackgroundTask(CodeunitId: Integer [, var Parameters: Dictionary of [Text, Text]] [, RunCompletionTriggers: Boolean])\n```\n## Parameters\nTestPage\nType: testpage-data-type\nAn instance of the testpage-data-type data type.\nCodeunitId\nType: ../integer/integer-data-type\nSpecifies the ID of the codeunit to run.\n*[Optional] Parameters*\nType: Dictionary of [Text, Text]<../dictionary/dictionary-data-type>\nSpecifies a collection of keys and values that are passed to the OnRun trigger of the codeunit that runs when the page background task session is started.\n*[Optional] RunCompletionTriggers*\nType: ../boolean/boolean-data-type\nRuns the completion triggers after the completion of the code unit. Default value is false.\n## Return Value\nResults\nType: Dictionary of [Text, Text]<../dictionary/dictionary-data-type>\nThe dictionary of results for the page background task.\n## Related information\ntestpage-data-type\nGet Started with AL<../../devenv-get-started>\nDeveloping Extensions<../../devenv-dev-overview>"}