{"title":"Codeunit 8800 Custom Layout Reporting, extension points 29","url":"https://jonas-paprotka.de/ref/codeunit/8800-custom-layout-reporting/points/","author":"JOP-AL","license":"Metadata from Microsoft's symbol packages. AL source MIT, Copyright (c) Microsoft Corporation. Selection and wording © 2026 JOP-AL. https://jonas-paprotka.de/licenses/","subject":"Microsoft Dynamics 365 Business Central","checked":"2026-11-20","changed":"2026-10-05","object":{"type":"codeunit","id":8800,"name":"Custom Layout Reporting","app":"Base Application","url":"https://jonas-paprotka.de/ref/codeunit/8800-custom-layout-reporting/"},"major":29,"source":{"url":"https://jonas-paprotka.de/ref/codeunit/8800-custom-layout-reporting/source/","path":"src/Layers/W1/BaseApp/Foundation/Reporting/CustomLayoutReporting.Codeunit.al","commit":"4303e5e584d3aa5d9e98cbc615525a5396ad6ed7","lines":"a line is <source url>#L<line>"},"steps":{"event":"[line, \"event\", name, handled]: raises an event of this object; handled 1 when it has an IsHandled parameter","call":"[line, \"call\", name, arguments]: calls a procedure of this object","ext":"[line, \"ext\", type, id, name, arguments]: calls a procedure of another object, through a variable declared with that type","write":"[line, \"write\", table id, method, 1 when called with true]: Insert, Modify, ModifyAll, Delete, DeleteAll or Rename","validate":"[line, \"validate\", table id, field name]","run":"[line, \"run\", type, id]: Codeunit.Run, Page.Run, Report.Run and their kin"},"objects":{"codeunit:46":{"name":"SelectionFilterManagement","url":"https://jonas-paprotka.de/ref/codeunit/46-selectionfiltermanagement/"},"codeunit:28":{"name":"Error Message Management","url":"https://jonas-paprotka.de/ref/codeunit/28-error-message-management/"},"codeunit:419":{"name":"File Management","url":"https://jonas-paprotka.de/ref/codeunit/419-file-management/"},"codeunit:4100":{"name":"Temp Blob","url":"https://jonas-paprotka.de/ref/codeunit/4100-temp-blob/"},"codeunit:425":{"name":"Data Compression","url":"https://jonas-paprotka.de/ref/codeunit/425-data-compression/"},"table:823":{"name":"Name/Value Buffer","url":"https://jonas-paprotka.de/ref/table/823-name-value-buffer/"},"codeunit:29":{"name":"Error Message Handler","url":"https://jonas-paprotka.de/ref/codeunit/29-error-message-handler/"},"table:9657":{"name":"Custom Report Selection","url":"https://jonas-paprotka.de/ref/table/9657-custom-report-selection/"},"table:9651":{"name":"Report Layout Selection","url":"https://jonas-paprotka.de/ref/table/9651-report-layout-selection/"},"codeunit:1530":{"name":"Request Page Parameters Helper","url":"https://jonas-paprotka.de/ref/codeunit/1530-request-page-parameters-helper/"},"codeunit:4102":{"name":"Temp Blob List","url":"https://jonas-paprotka.de/ref/codeunit/4102-temp-blob-list/"},"codeunit:8894":{"name":"Email Account","url":"https://jonas-paprotka.de/ref/codeunit/8894-email-account/"},"codeunit:8800":{"name":"Custom Layout Reporting","url":"https://jonas-paprotka.de/ref/codeunit/8800-custom-layout-reporting/"},"codeunit:9657":{"name":"Report Management Helper","url":"https://jonas-paprotka.de/ref/codeunit/9657-report-management-helper/"},"codeunit:8617":{"name":"Config. Validate Management","url":"https://jonas-paprotka.de/ref/codeunit/8617-config-validate-management/"},"codeunit:4030":{"name":"Client Type Management","url":"https://jonas-paprotka.de/ref/codeunit/4030-client-type-management/"},"codeunit:701":{"name":"Data Type Management","url":"https://jonas-paprotka.de/ref/codeunit/701-data-type-management/"},"codeunit:260":{"name":"Document-Mailing","url":"https://jonas-paprotka.de/ref/codeunit/260-document-mailing/"},"table:2000000196":{"name":"Object Options","url":"https://jonas-paprotka.de/ref/table/2000000196-object-options/"},"codeunit:8810":{"name":"Customer Layout - Statement","url":"https://jonas-paprotka.de/ref/codeunit/8810-customer-layout-statement/"},"table:477":{"name":"Report Inbox","url":"https://jonas-paprotka.de/ref/table/477-report-inbox/"}},"procs":[{"name":"GetLayoutIteratorKeyFilter","line":103,"kind":"procedure","params":3,"steps":[[118,"call","GetCustomerFilter",1],[120,"call","GetVendorFilter",1],[130,"call","SetNextGroupFilter",3]]},{"name":"GetCustomerFilter","line":133,"kind":"procedure","access":"local","params":1,"steps":[[146,"ext","codeunit",46,"GetSelectionFilter",3]]},{"name":"GetVendorFilter","line":149,"kind":"procedure","access":"local","params":1,"steps":[[162,"ext","codeunit",46,"GetSelectionFilter",3]]},{"name":"ProcessReport","line":166,"kind":"procedure","params":0,"steps":[[180,"ext","codeunit",28,"Activate",1],[181,"ext","codeunit",28,"PushContext",4],[187,"call","SetOutputType",1],[193,"call","GetViewFromParameters",2],[198,"call","FindNextEmptyFilterGroup",1],[199,"call","GetViewFromParameters",2],[205,"call","SetCustomReportSelectionTableFilter",2],[211,"call","GetOptionValueFromRequestPage",2],[212,"call","GetRequestParametersText",1],[215,"call","ProcessReportPerObject",0],[221,"call","ProcessReportPerObject",0],[224,"call","ProcessReportPerLayout",0],[226,"call","LogAndClearLastError",2],[235,"call","IsTestMode",0],[236,"ext","codeunit",419,"CopyServerFile",3],[236,"ext","codeunit",419,"CombinePath",2],[238,"call","IsBackground",0],[238,"ext","codeunit",419,"ServerFileExists",1],[239,"call","SendToReportInbox",2],[241,"ext","codeunit",419,"DownloadHandler",5],[244,"ext","codeunit",419,"BLOBImportFromServerFile",2],[245,"ext","codeunit",4100,"CreateInStream",1],[246,"ext","codeunit",425,"AddEntry",2],[247,"ext","table",823,"AddNewEntry",2],[249,"ext","codeunit",425,"SaveZipArchive",1],[250,"ext","codeunit",425,"CloseZipArchive",0],[253,"call","IsTestMode",0],[254,"ext","codeunit",419,"CopyServerFile",3],[254,"ext","codeunit",419,"CombinePath",2],[256,"call","IsBackground",0],[256,"ext","codeunit",419,"ServerFileExists",1],[257,"call","SendToReportInbox",2],[259,"ext","codeunit",419,"DownloadHandler",5],[262,"call","CleanupTempFiles",0],[264,"event","OnAfterProcessReport",0],[267,"call","LogSimpleError",1],[269,"ext","codeunit",29,"HasErrors",0],[270,"event","OnBeforeThrowProcessReportError",0],[271,"call","IsBackground",0],[272,"ext","codeunit",29,"ShowErrors",0]]},{"name":"ProcessReportData","line":277,"kind":"procedure","params":6,"steps":[[281,"call","InitializeReportData",6],[288,"call","ProcessReport",0]]},{"name":"ProcessReportPerLayout","line":310,"kind":"procedure","access":"local","params":0,"steps":[[339,"call","ResolveCustomReportLayoutCode",1],[344,"call","GetLayoutIteratorKeyFilter",3],[348,"call","RunReportWithCustomReportSelection",4],[366,"call","ExcludeReportedObjects",3],[370,"call","RunReport",3]]},{"name":"ExcludeReportedObjects","line":373,"kind":"procedure","access":"local","params":3,"steps":[[389,"ext","codeunit",46,"GetMaximumNumberOfParametersInSQLQuery",0],[394,"ext","codeunit",46,"AddQuotes",1],[402,"call","SetNextGroupFilter",3]]},{"name":"ProcessReportPerObject","line":407,"kind":"procedure","access":"local","params":0,"steps":[[427,"event","OnProcessReportPerObjectOnBeforeReportDataRecordRefLoop",0],[436,"call","SetNextGroupFilter",3],[439,"call","SetIteratorJoinFieldRef",0],[445,"event","OnProcessReportPerObjectOnBeforeRunReport",1],[449,"call","GetNextGroupFilters",2],[450,"call","IsRunReportOncePerFilter",0],[454,"call","RunReportWithCustomReportSelection",4],[457,"call","RunReport",3],[460,"call","GetNextGroupFilters",2],[462,"event","OnProcessReportPerObjectOnAfterRunReport",0],[466,"call","SetGroupFilter",4],[471,"event","OnAfterProcessReportPerObject",0]]},{"name":"RunReportWithCustomReportSelection","line":474,"kind":"procedure","access":"local","params":4,"steps":[[481,"event","OnBeforeRunReportWithCustomReportSelection",0],[485,"validate",9657,"Report ID"],[486,"call","LogAndClearLastError",2],[492,"ext","table",9651,"SetTempLayoutSelectedName",1],[494,"call","ResolveCustomReportLayoutCode",1],[495,"ext","table",9651,"SetTempLayoutSelected",1],[501,"call","GetSendToEmailID",2],[502,"call","CheckEmailSendTo",1],[505,"call","IsWordLayout",2],[506,"call","SaveAsReport",3],[508,"call","SaveAsReport",3],[510,"call","LogErrorEmailSendTo",4],[512,"call","EmailReport",3],[515,"call","SaveAsReport",3],[517,"call","SaveAsReport",3],[519,"call","SaveAsReport",3],[521,"call","PrintReport",2],[523,"call","PreviewReport",3],[525,"call","SaveAsReport",3],[528,"ext","table",9651,"ClearTempLayoutSelected",0],[530,"validate",9657,"Report ID"],[531,"call","LogAndClearLastError",2]]},{"name":"RunReport","line":534,"kind":"procedure","access":"local","params":3,"steps":[[540,"event","OnBeforeRunReport",0],[542,"call","LogAndClearLastError",2],[549,"call","RunReportWithCustomReportSelection",4]]},{"name":"GetOutputOption","line":558,"kind":"procedure","params":1,"steps":[[564,"call","GetOptionValueFromRequestPageForReport",2]]},{"name":"PrintReport","line":606,"kind":"procedure","access":"local","params":2,"steps":[[608,"event","OnBeforePrintReport",0],[613,"call","GetRequestParametersText",1]]},{"name":"EmailReport","line":617,"kind":"procedure","access":"local","params":3,"steps":[[632,"call","CreateReportWithExtension",4],[641,"call","GetKeyFieldRef",2],[642,"call","GetNameFieldRef",2],[644,"call","GetKeyFieldRef",2],[645,"call","GetNameFieldRef",2],[648,"call","ResolveEmailBodyLayoutCode",2],[650,"ext","table",9651,"GetTempLayoutSelected",0],[651,"ext","table",9651,"GetTempSelectedLayoutName",0],[653,"ext","table",9651,"SetTempLayoutSelectedName",1],[655,"ext","table",9651,"SetTempLayoutSelected",1],[658,"call","CreateReportWithExtension",4],[663,"ext","table",9651,"SetTempLayoutSelectedName",1],[665,"ext","table",9651,"SetTempLayoutSelected",1],[668,"call","RemoveEmptyFile",1],[673,"call","TryEmailReport",6]]},{"name":"PreviewReport","line":676,"kind":"procedure","access":"local","params":3,"steps":[[678,"call","IsWebClient",0],[679,"call","IsWordLayout",2],[680,"call","SaveAsReport",3],[682,"call","SaveAsReport",3],[685,"call","GetRequestParametersText",1]]},{"name":"SaveAsReport","line":690,"kind":"procedure","access":"local","params":3,"steps":[[716,"call","IsWebClient",0],[718,"call","GenerateFileNameForReport",4],[720,"ext","codeunit",419,"ServerTempFileName",1],[723,"call","BoundCallReportSaveAs",5],[723,"call","GetRequestParametersText",1],[724,"event","OnSaveAsReportOnBeforeFileClose",0],[727,"call","RemoveEmptyFile",1],[727,"ext","codeunit",419,"ServerFileExists",1],[728,"call","IsWebClient",0],[728,"call","IsBackground",0],[729,"call","AddFileToClientZip",2],[731,"ext","codeunit",419,"DownloadHandler",5],[732,"ext","table",823,"AddNewEntry",2]]},{"name":"GenerateFileNameForReport","line":737,"kind":"procedure","access":"local","params":4,"steps":[[744,"event","OnBeforeGenerateFileNameForReport",1],[746,"call","GenerateFileName",5],[750,"call","GetNameFieldRef",2],[753,"call","GetNameFieldRef",2],[758,"call","GenerateFileName",5]]},{"name":"GenerateFileName","line":761,"kind":"procedure","access":"local","params":5,"steps":[[769,"call","GetRequestParametersText",1],[779,"call","GetOptionValueFromRequestPage",2],[783,"call","GetTempLayoutReportCaption",1],[787,"call","GetFileNameForPart",1],[787,"call","GetFileNameAsOfPart",1],[789,"call","GetFileNameForPart",1],[791,"event","OnGenerateFileNameOnAfterAssignFileName",0],[793,"ext","codeunit",419,"StripNotsupportChrInFileName",1],[799,"ext","codeunit",419,"AppendFileNameWithIndex",2],[802,"ext","table",823,"AddNewEntry",2],[805,"ext","codeunit",419,"CombinePath",2]]},{"name":"GetOptionValueFromRequestPage","line":822,"kind":"procedure","access":"local","params":2,"steps":[[824,"ext","codeunit",1530,"GetRequestPageOptionValue",2]]},{"name":"GetOptionValueFromRequestPageForReport","line":828,"kind":"procedure","params":2,"steps":[[833,"call","GetOptionValueFromRequestPage",2],[833,"call","GetRequestParametersText",1]]},{"name":"GetViewFromParameters","line":853,"kind":"procedure","access":"local","params":2,"steps":[[861,"ext","codeunit",4102,"Get",2],[864,"ext","codeunit",1530,"ConvertParametersToFilters",2]]},{"name":"GetRequestParameters","line":869,"kind":"procedure","access":"local","params":0,"steps":[[886,"call","IsTestMode",0],[892,"call","RunRequestPage",1],[906,"call","StoreRequestParameters",2],[907,"call","SaveReportRequestPageParameters",2],[909,"call","SetOutputType",1],[912,"call","IsTestMode",0],[916,"ext","codeunit",8894,"IsAnyAccountRegistered",0]]},{"name":"SetOutputType","line":922,"kind":"procedure","access":"local","params":1,"steps":[[928,"call","GetOptionValueFromRequestPage",2],[928,"call","GetRequestParametersText",1],[929,"event","OnSetOutputTypeOnAfterSetOutputMethod",0],[936,"call","SetOutputOption",1]]},{"name":"StoreRequestParameters","line":950,"kind":"procedure","access":"local","params":2,"steps":[[957,"ext","codeunit",4100,"CreateOutStream",2],[961,"ext","codeunit",4102,"Set",2],[963,"ext","codeunit",4102,"Add",1],[965,"ext","codeunit",4102,"Count",0],[966,"write",823,"Insert"]]},{"name":"GetRequestParametersText","line":970,"kind":"procedure","access":"local","params":1,"steps":[[979,"ext","codeunit",4102,"Get",2],[980,"ext","codeunit",4100,"CreateInStream",2]]},{"name":"AddFileToClientZip","line":985,"kind":"procedure","access":"local","params":2,"steps":[[995,"ext","codeunit",419,"ServerTempFileName",0],[998,"ext","codeunit",425,"CreateZipArchive",0],[1003,"ext","table",823,"AddNewEntry",2]]},{"name":"CallReportSaveAs","line":1008,"kind":"procedure","params":5,"steps":[[1012,"event","OnBeforeCallReportSaveAs",0]]},{"name":"BoundCallReportSaveAs","line":1024,"kind":"procedure","access":"local","params":5,"steps":[[1029,"ext","codeunit",8800,"CallReportSaveAs",5]]},{"name":"IsWordLayout","line":1032,"kind":"procedure","access":"local","params":2,"steps":[[1042,"ext","codeunit",9657,"SelectedLayoutType",1],[1044,"ext","codeunit",9657,"SelectedLayoutType",1]]},{"name":"SetReportDataItem","line":1047,"kind":"procedure","access":"local","params":5,"steps":[[1067,"call","SetNextGroupFilter",3],[1070,"ext","codeunit",8617,"GetRelationInfoByIDs",4]]},{"name":"IsWebClient","line":1100,"kind":"procedure","params":0,"steps":[[1104,"ext","codeunit",4030,"GetCurrentClientType",0]]},{"name":"IsTestMode","line":1114,"kind":"procedure","access":"local","params":0,"steps":[[1117,"event","OnIsTestMode",0]]},{"name":"InitializeReportData","line":1150,"kind":"procedure","params":6,"steps":[[1153,"call","SetReportUsage",1],[1154,"call","SetReportDataItem",5],[1155,"call","GetRequestParameters",0]]},{"name":"InitializeData","line":1159,"kind":"procedure","params":6,"steps":[[1161,"call","InitializeReportData",6]]},{"name":"GetKeyFieldRef","line":1173,"kind":"procedure","access":"local","params":2,"steps":[[1181,"ext","codeunit",701,"FindFieldByName",3]]},{"name":"GetNameFieldRef","line":1189,"kind":"procedure","access":"local","params":2,"steps":[[1197,"ext","codeunit",701,"FindFieldByName",3]]},{"name":"SetNextGroupFilter","line":1231,"kind":"procedure","access":"local","params":3,"steps":[[1235,"call","FindNextEmptyFilterGroup",1],[1236,"call","SetGroupFilter",4]]},{"name":"CleanupTempFiles","line":1260,"kind":"procedure","access":"local","params":0,"steps":[[1265,"call","TryDeleteFile",1]]},{"name":"TryDeleteFile","line":1270,"kind":"procedure","access":"local","params":1,"steps":[[1272,"ext","codeunit",419,"DeleteServerFile",1]]},{"name":"TryCreateFileStream","line":1276,"kind":"procedure","access":"local","params":7,"steps":[[1278,"ext","codeunit",419,"ServerTempFileName",1],[1280,"call","GenerateFileNameForReport",4]]},{"name":"TryEmailReport","line":1287,"kind":"procedure","access":"local","params":6,"steps":[[1299,"ext","codeunit",419,"BLOBImportFromServerFile",2],[1300,"ext","codeunit",4100,"CreateInStream",1],[1302,"ext","codeunit",419,"BLOBImportFromServerFile",2],[1314,"call","GetSendToEmailID",2],[1317,"ext","codeunit",260,"EmailFile",11],[1321,"ext","table",823,"AddNewEntry",2],[1323,"call","AddFileToClientZip",2],[1326,"ext","table",823,"AddNewEntry",2]]},{"name":"CreateReportWithExtension","line":1331,"kind":"procedure","access":"local","params":4,"steps":[[1341,"call","TryCreateFileStream",7],[1344,"call","BoundCallReportSaveAs",5],[1344,"call","GetRequestParametersText",1],[1345,"ext","table",823,"AddNewEntry",2],[1346,"event","OnCreateReportWithExtensionOnBeforePdfFileClose",0],[1357,"call","TryCreateFileStream",7],[1360,"call","BoundCallReportSaveAs",5],[1360,"call","GetRequestParametersText",1],[1361,"ext","table",823,"AddNewEntry",2],[1362,"event","OnCreateReportWithExtensionOnBeforeHtmlFileClose",0]]},{"name":"SetIteratorJoinFieldRef","line":1376,"kind":"procedure","access":"local","params":0,"steps":[[1387,"event","OnBeforeSetIteratorJoinFieldRef",1]]},{"name":"RunRequestPage","line":1431,"kind":"procedure","params":1,"steps":[[1438,"call","GetReportRequestPageParameters",1],[1439,"event","OnRunRequestPageOnBeforeReportRunRequestPage",0]]},{"name":"LogSimpleError","line":1443,"kind":"procedure","access":"local","params":1,"steps":[[1445,"ext","codeunit",28,"LogSimpleErrorMessage",1]]},{"name":"LogAndClearLastError","line":1448,"kind":"procedure","access":"local","params":2,"steps":[[1451,"call","LogSimpleError",1]]},{"name":"IsBackground","line":1456,"kind":"procedure","access":"local","params":0,"steps":[[1458,"ext","codeunit",4030,"GetCurrentClientType",0]]},{"name":"SetTableFilterForReportID","line":1466,"kind":"procedure","params":2,"steps":[[1469,"call","ParseCustomerNo",1]]},{"name":"SaveReportRequestPageParameters","line":1510,"kind":"procedure","params":3,"steps":[[1515,"call","IsObjectOptionsInsertDeleteAllowed",0],[1525,"write",2000000196,"Delete"],[1535,"write",2000000196,"Insert"]]},{"name":"CheckForCustomLayoutReportingJob","line":1543,"kind":"procedure","params":0,"steps":[[1547,"ext","codeunit",8810,"CheckReportRunningInBackground",0]]},{"name":"ConvertToRepInboxOutputType","line":1582,"kind":"procedure","access":"local","params":2,"steps":[[1586,"call","SetReportInboxOutputTypeForPrint",2],[1589,"call","SetReportInboxOutputTypeForPrint",2]]},{"name":"SetReportInboxOutputTypeForPrint","line":1602,"kind":"procedure","access":"local","params":2,"steps":[[1606,"call","ResolveCustomReportLayoutCode",1],[1607,"call","IsWordLayout",2]]},{"name":"SendToReportInbox","line":1613,"kind":"procedure","access":"local","params":2,"steps":[[1623,"validate",477,"Output Type"],[1626,"call","ConvertToRepInboxOutputType",2],[1633,"call","GetTempLayoutReportCaption",1],[1638,"write",477,"Insert",1],[1639,"write",477,"Modify",1]]},{"name":"CheckEmailSendTo","line":1642,"kind":"procedure","access":"local","params":1,"steps":[[1649,"ext","codeunit",8894,"ValidateEmailAddresses",2]]},{"name":"LogErrorEmailSendTo","line":1655,"kind":"procedure","access":"local","params":4,"steps":[[1663,"call","IsCustomReportSelectionNull",1],[1672,"ext","codeunit",28,"LogError",3]]},{"name":"GetSendToEmailID","line":1685,"kind":"procedure","access":"local","params":2,"steps":[[1687,"ext","table",9657,"GetSendToEmail",1],[1688,"call","GetSendToEmailIDFromSource",2],[1690,"ext","table",9657,"GetSendToEmail",1],[1692,"event","OnAfterGetSendToEmailID",0]]},{"name":"GetSendToEmailIDFromSource","line":1695,"kind":"procedure","access":"local","params":2,"steps":[[1708,"event","OnAfterGetSendToEmailIDFromSource",0]]}]}