{"title":"Codeunit 8800 Custom Layout Reporting, events","url":"https://jonas-paprotka.de/ref/codeunit/8800-custom-layout-reporting/events/","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","versions":"17-29","url":"https://jonas-paprotka.de/ref/codeunit/8800-custom-layout-reporting/","json":"https://jonas-paprotka.de/ref/codeunit/8800-custom-layout-reporting.json"},"aspect":"events","total":22,"rows":[{"name":"OnBeforeVerifyXmlContainsDataset","sig":"(var Boolean)","named":"(var CancelVerification: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"The rendering of Word documents will be handled on the Platform. To override the behavior, subscribe on the report event CustomDocumentMerger.","tag":"20.0"},"range":"17-22","first":17,"last":22,"obsoleteSince":20,"spans":[{"from":17,"to":19,"named":"(var CancelVerification: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null},{"from":20,"to":22,"named":"(var CancelVerification: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":{"state":"Pending","reason":"The rendering of Word documents will be handled on the Platform. To override the behavior, subscribe on the report event CustomDocumentMerger.","tag":"20.0"}}]},{"name":"OnIsTestMode","sig":"(var Boolean)","named":"(var TestMode: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var TestMode: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnAfterProcessReport","sig":"()","named":"()","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"()","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnBeforeCallReportSaveAs","sig":"(Integer, ReportFormat)","named":"(ReportID: Integer; ReportFormatValue: ReportFormat)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(ReportID: Integer; ReportFormatValue: ReportFormat)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnBeforePrintReport","sig":"(var RecordRef, Integer)","named":"(var DataRecRef: RecordRef; ReportID: Integer)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var DataRecRef: RecordRef; ReportID: Integer)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnBeforeRunReportWithCustomReportSelection","sig":"(var RecordRef, var Integer, var Record Custom Report Selection, var Boolean, var Record Name/Value Buffer, var Codeunit Temp Blob List, var Option, var Boolean, var Boolean)","named":"(var DataRecRef: RecordRef; var ReportID: Integer; var CustomReportSelection: Record \"Custom Report Selection\"; var EmailPrintIfEmailIsMissing: Boolean; var TempBlobIndicesNameValueBuffer: Record \"Name/Value Buffer\" temporary; var TempBlobList: Codeunit \"Temp Blob List\"; var OutputType: Option; var AnyOutputExists: Boolean; var InHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var DataRecRef: RecordRef; var ReportID: Integer; var CustomReportSelection: Record \"Custom Report Selection\"; var EmailPrintIfEmailIsMissing: Boolean; var TempBlobIndicesNameValueBuffer: Record \"Name/Value Buffer\" temporary; var TempBlobList: Codeunit \"Temp Blob List\"; var OutputType: Option; var AnyOutputExists: Boolean; var InHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnGenerateFileNameOnAfterAssignFileName","sig":"(var Text, Integer, Text, RecordRef)","named":"(var FileName: Text; ReportID: Integer; Extension: Text; DataRecRef: RecordRef)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var FileName: Text; ReportID: Integer; Extension: Text; DataRecRef: RecordRef)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnCreateReportWithExtensionOnBeforeHtmlFileClose","sig":"(Integer, ReportFormat, var RecordRef, var OutStream)","named":"(ReportID: Integer; RepFormat: ReportFormat; var DataRecRef: RecordRef; var FileStream: OutStream)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"18-29","first":18,"last":29,"obsoleteSince":null,"spans":[{"from":18,"to":29,"named":"(ReportID: Integer; RepFormat: ReportFormat; var DataRecRef: RecordRef; var FileStream: OutStream)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnCreateReportWithExtensionOnBeforePdfFileClose","sig":"(Integer, ReportFormat, var RecordRef, var OutStream)","named":"(ReportID: Integer; RepFormat: ReportFormat; var DataRecRef: RecordRef; var FileStream: OutStream)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"18-29","first":18,"last":29,"obsoleteSince":null,"spans":[{"from":18,"to":29,"named":"(ReportID: Integer; RepFormat: ReportFormat; var DataRecRef: RecordRef; var FileStream: OutStream)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnSaveAsReportOnBeforeFileClose","sig":"(Boolean, var RecordRef, Integer, ReportFormat, var OutStream)","named":"(ReportSaved: Boolean; var DataRecRef: RecordRef; ReportID: Integer; RepFormat: ReportFormat; var FileStream: OutStream)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"18-29","first":18,"last":29,"obsoleteSince":null,"spans":[{"from":18,"to":29,"named":"(ReportSaved: Boolean; var DataRecRef: RecordRef; ReportID: Integer; RepFormat: ReportFormat; var FileStream: OutStream)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnBeforeRunReport","sig":"(var RecordRef, var Record Report Selections, var Boolean, var Record Name/Value Buffer, var Codeunit Temp Blob List, var Option, var Boolean, var Boolean)","named":"(var DataRecRef: RecordRef; var ReportSelections: Record \"Report Selections\"; var EmailPrintIfEmailIsMissing: Boolean; var TempBlobIndicesNameValueBuffer: Record \"Name/Value Buffer\" temporary; var TempBlobList: Codeunit \"Temp Blob List\"; var OutputType: Option; var AnyOutputExists: Boolean; var InHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"19-29","first":19,"last":29,"obsoleteSince":null,"spans":[{"from":19,"to":29,"named":"(var DataRecRef: RecordRef; var ReportSelections: Record \"Report Selections\"; var EmailPrintIfEmailIsMissing: Boolean; var TempBlobIndicesNameValueBuffer: Record \"Name/Value Buffer\" temporary; var TempBlobList: Codeunit \"Temp Blob List\"; var OutputType: Option; var AnyOutputExists: Boolean; var InHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnSetOutputTypeOnAfterSetOutputMethod","sig":"(var Text)","named":"(var OutputMethod: Text)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"19-29","first":19,"last":29,"obsoleteSince":null,"spans":[{"from":19,"to":29,"named":"(var OutputMethod: Text)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnBeforeSetIteratorJoinFieldRef","sig":"(var RecordRef, var FieldRef, var FieldRef, var Boolean)","named":"(var ReportDataRecordRef: RecordRef; var BalAcctTypeFieldRef: FieldRef; var AcctTypeFieldRef: FieldRef; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"20-29","first":20,"last":29,"obsoleteSince":null,"spans":[{"from":20,"to":29,"named":"(var ReportDataRecordRef: RecordRef; var BalAcctTypeFieldRef: FieldRef; var AcctTypeFieldRef: FieldRef; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnAfterGetSendToEmailID","sig":"(var Record Custom Report Selection, var Text[250])","named":"(var CustomReportSelection: Record \"Custom Report Selection\"; var EmailID: Text[250])","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"21-29","first":21,"last":29,"obsoleteSince":null,"spans":[{"from":21,"to":29,"named":"(var CustomReportSelection: Record \"Custom Report Selection\"; var EmailID: Text[250])","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnAfterGetSendToEmailIDFromSource","sig":"(var Record Custom Report Selection, var Text[250])","named":"(var CustomReportSelection: Record \"Custom Report Selection\"; var EmailID: Text[250])","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"21-29","first":21,"last":29,"obsoleteSince":null,"spans":[{"from":21,"to":29,"named":"(var CustomReportSelection: Record \"Custom Report Selection\"; var EmailID: Text[250])","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnRunRequestPageOnBeforeReportRunRequestPage","sig":"(Integer, var Text)","named":"(ReportId: Integer; var SavedParameters: Text)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"22-29","first":22,"last":29,"obsoleteSince":null,"spans":[{"from":22,"to":29,"named":"(ReportId: Integer; var SavedParameters: Text)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnProcessReportPerObjectOnBeforeReportDataRecordRefLoop","sig":"(Boolean, RecordRef)","named":"(ReportDataAndIteratorDiffer: Boolean; IteratorRecordRef: RecordRef)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"23-29","first":23,"last":29,"obsoleteSince":null,"spans":[{"from":23,"to":29,"named":"(ReportDataAndIteratorDiffer: Boolean; IteratorRecordRef: RecordRef)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnProcessReportPerObjectOnBeforeRunReport","sig":"(Boolean, RecordRef, var Boolean)","named":"(ReportDataAndIteratorDiffer: Boolean; IteratorRecordRef: RecordRef; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"23-29","first":23,"last":29,"obsoleteSince":null,"spans":[{"from":23,"to":29,"named":"(ReportDataAndIteratorDiffer: Boolean; IteratorRecordRef: RecordRef; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnProcessReportPerObjectOnAfterRunReport","sig":"(Boolean, RecordRef)","named":"(ReportDataAndIteratorDiffer: Boolean; IteratorRecordRef: RecordRef)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"23-29","first":23,"last":29,"obsoleteSince":null,"spans":[{"from":23,"to":29,"named":"(ReportDataAndIteratorDiffer: Boolean; IteratorRecordRef: RecordRef)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnAfterProcessReportPerObject","sig":"(Boolean)","named":"(ReportDataAndIteratorDiffer: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"23-29","first":23,"last":29,"obsoleteSince":null,"spans":[{"from":23,"to":29,"named":"(ReportDataAndIteratorDiffer: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnBeforeGenerateFileNameForReport","sig":"(RecordRef, var FieldRef, RecordRef, var Text, var Boolean)","named":"(IteratorRecordRef: RecordRef; var NameFieldRef: FieldRef; ReportDataRecordRef: RecordRef; var ObjectName: Text; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"23-29","first":23,"last":29,"obsoleteSince":null,"spans":[{"from":23,"to":29,"named":"(IteratorRecordRef: RecordRef; var NameFieldRef: FieldRef; ReportDataRecordRef: RecordRef; var ObjectName: Text; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]},{"name":"OnBeforeThrowProcessReportError","sig":"(var Codeunit Error Message Handler, var RecordRef, var Option)","named":"(var ErrorMessageHandler: Codeunit \"Error Message Handler\"; var ReportDataRecordRef: RecordRef; var OutputType: Option)","returns":"","kind":"integrationevent","access":"local","obsolete":null,"range":"27-29","first":27,"last":29,"obsoleteSince":null,"spans":[{"from":27,"to":29,"named":"(var ErrorMessageHandler: Codeunit \"Error Message Handler\"; var ReportDataRecordRef: RecordRef; var OutputType: Option)","returns":"","kind":"integrationevent","access":"local","obsolete":null}]}]}