{"title":"Codeunit 1637 Office Document Handler, extension points 29","url":"https://jonas-paprotka.de/ref/codeunit/1637-office-document-handler/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":1637,"name":"Office Document Handler","app":"Base Application","url":"https://jonas-paprotka.de/ref/codeunit/1637-office-document-handler/"},"major":29,"source":{"url":"https://jonas-paprotka.de/ref/codeunit/1637-office-document-handler/source/","path":"src/Layers/W1/BaseApp/CRM/Outlook/OfficeDocumentHandler.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:10":{"name":"Type Helper","url":"https://jonas-paprotka.de/ref/codeunit/10-type-helper/"},"codeunit:1630":{"name":"Office Management","url":"https://jonas-paprotka.de/ref/codeunit/1630-office-management/"},"page:1606":{"name":"Office Doc Selection Dlg","url":"https://jonas-paprotka.de/ref/page/1606-office-doc-selection-dlg/"},"page:1602":{"name":"Office Document Selection","url":"https://jonas-paprotka.de/ref/page/1602-office-document-selection/"},"table:18":{"name":"Customer","url":"https://jonas-paprotka.de/ref/table/18-customer/"},"table:23":{"name":"Vendor","url":"https://jonas-paprotka.de/ref/table/23-vendor/"},"table:1620":{"name":"Office Document Selection","url":"https://jonas-paprotka.de/ref/table/1620-office-document-selection/"},"codeunit:1643":{"name":"Hyperlink Manifest","url":"https://jonas-paprotka.de/ref/codeunit/1643-hyperlink-manifest/"},"codeunit:700":{"name":"Page Management","url":"https://jonas-paprotka.de/ref/codeunit/700-page-management/"},"page:51":{"name":"Purchase Invoice","url":"https://jonas-paprotka.de/ref/page/51-purchase-invoice/"},"page:52":{"name":"Purchase Credit Memo","url":"https://jonas-paprotka.de/ref/page/52-purchase-credit-memo/"},"page:50":{"name":"Purchase Order","url":"https://jonas-paprotka.de/ref/page/50-purchase-order/"},"page:138":{"name":"Posted Purchase Invoice","url":"https://jonas-paprotka.de/ref/page/138-posted-purchase-invoice/"},"page:140":{"name":"Posted Purchase Credit Memo","url":"https://jonas-paprotka.de/ref/page/140-posted-purchase-credit-memo/"},"table:1600":{"name":"Office Add-in Context","url":"https://jonas-paprotka.de/ref/table/1600-office-add-in-context/"},"table:1606":{"name":"Office Invoice","url":"https://jonas-paprotka.de/ref/table/1606-office-invoice/"},"codeunit:1330":{"name":"Instruction Mgt.","url":"https://jonas-paprotka.de/ref/codeunit/1330-instruction-mgt/"},"page:1637":{"name":"Office Suggested Line Items","url":"https://jonas-paprotka.de/ref/page/1637-office-suggested-line-items/"}},"procs":[{"name":"OnRun","line":23,"kind":"trigger","steps":[[25,"call","RedirectToDocument",1]]},{"name":"RedirectToDocument","line":35,"kind":"procedure","params":1,"steps":[[48,"call","CollectDocumentMatches",3],[52,"ext","codeunit",10,"NewLine",0],[55,"ext","codeunit",1630,"GetOfficeAddinTelemetryCategory",0],[61,"run","page",1606],[64,"call","OpenIndividualDocument",2],[66,"run","page",1602]]},{"name":"ShowDocumentSelection","line":70,"kind":"procedure","params":2,"steps":[[76,"call","GetSalesDocuments",3],[78,"call","GetPurchaseDocuments",3],[80,"run","page",1602]]},{"name":"HandleSalesCommand","line":83,"kind":"procedure","params":2,"steps":[[90,"ext","table",18,"CreateAndShowNewCreditMemo",0],[92,"ext","codeunit",1630,"CheckForExistingInvoice",1],[93,"ext","table",18,"CreateAndShowNewInvoice",0],[95,"ext","table",18,"CreateAndShowNewQuote",0],[97,"ext","table",18,"CreateAndShowNewOrder",0]]},{"name":"HandlePurchaseCommand","line":101,"kind":"procedure","params":2,"steps":[[107,"ext","table",23,"CreateAndShowNewCreditMemo",0],[109,"ext","table",23,"CreateAndShowNewInvoice",0],[111,"ext","table",23,"CreateAndShowNewPurchaseOrder",0]]},{"name":"OpenIndividualDocument","line":115,"kind":"procedure","params":2,"steps":[[119,"call","OpenIndividualSalesDocument",2],[121,"call","OpenIndividualPurchaseDocument",2]]},{"name":"CollectDocumentMatches","line":125,"kind":"procedure","access":"local","params":3,"steps":[[134,"call","ExpressionContainsSeriesTitle",3],[136,"call","ExpressionContainsKeyWords",3],[142,"call","SetSalesDocumentMatchRecord",3],[143,"call","SetSalesDocumentMatchRecord",3],[144,"call","SetSalesDocumentMatchRecord",3],[145,"call","SetSalesDocumentMatchRecord",3],[147,"call","SetPurchDocumentMatchRecord",3],[148,"call","SetPurchDocumentMatchRecord",3],[149,"call","SetPurchDocumentMatchRecord",3]]},{"name":"CreateDocumentMatchRecord","line":154,"kind":"procedure","access":"local","params":6,"steps":[[157,"validate",1620,"Document No."],[158,"validate",1620,"Document Date"],[159,"validate",1620,"Document Type"],[160,"validate",1620,"Series"],[161,"validate",1620,"Posted"],[162,"write",1620,"Insert"]]},{"name":"ExpressionContainsKeyWords","line":170,"kind":"procedure","access":"local","params":3,"steps":[[176,"call","GetDocumentNumber",3],[177,"call","SetSalesDocumentMatchRecord",3],[178,"call","GetDocumentNumber",3],[180,"call","SetSalesDocumentMatchRecord",3],[181,"call","SetPurchDocumentMatchRecord",3],[183,"call","GetDocumentNumber",3],[185,"call","SetSalesDocumentMatchRecord",3],[186,"call","SetPurchDocumentMatchRecord",3],[188,"call","GetDocumentNumber",3],[190,"call","SetSalesDocumentMatchRecord",3],[191,"call","SetPurchDocumentMatchRecord",3],[193,"call","GetDocumentNumber",3],[193,"ext","codeunit",1643,"GetAcronymForPurchaseOrder",0],[194,"call","SetPurchDocumentMatchRecord",3]]},{"name":"ExpressionContainsSeriesTitle","line":201,"kind":"procedure","access":"local","params":3,"steps":[[206,"call","GetDocumentNumber",3],[206,"ext","codeunit",1643,"GetNameForPurchaseCrMemo",0],[207,"call","SetPurchDocumentMatchRecord",3],[208,"call","GetDocumentNumber",3],[208,"ext","codeunit",1643,"GetNameForPurchaseInvoice",0],[209,"call","SetPurchDocumentMatchRecord",3],[210,"call","GetDocumentNumber",3],[210,"ext","codeunit",1643,"GetNameForPurchaseOrder",0],[211,"call","SetPurchDocumentMatchRecord",3],[212,"call","GetDocumentNumber",3],[212,"ext","codeunit",1643,"GetNameForSalesCrMemo",0],[213,"call","SetSalesDocumentMatchRecord",3],[214,"call","GetDocumentNumber",3],[214,"ext","codeunit",1643,"GetNameForSalesInvoice",0],[215,"call","SetSalesDocumentMatchRecord",3],[216,"call","GetDocumentNumber",3],[216,"ext","codeunit",1643,"GetNameForSalesOrder",0],[217,"call","SetSalesDocumentMatchRecord",3],[218,"call","GetDocumentNumber",3],[218,"ext","codeunit",1643,"GetNameForSalesQuote",0],[219,"call","SetSalesDocumentMatchRecord",3]]},{"name":"GetDocumentNumber","line":226,"kind":"procedure","access":"local","params":3,"steps":[[231,"ext","codeunit",1643,"GetNumberSeriesRegex",0]]},{"name":"GetSalesDocuments","line":237,"kind":"procedure","access":"local","params":3,"steps":[[247,"call","CreateDocumentMatchRecord",6],[255,"call","CreateDocumentMatchRecord",6],[263,"call","CreateDocumentMatchRecord",6]]},{"name":"GetPurchaseDocuments","line":268,"kind":"procedure","access":"local","params":3,"steps":[[278,"call","CreateDocumentMatchRecord",6],[286,"call","CreateDocumentMatchRecord",6],[294,"call","CreateDocumentMatchRecord",6]]},{"name":"OpenIndividualSalesDocument","line":299,"kind":"procedure","access":"local","params":2,"steps":[[308,"event","OnOpenIndividualSalesDocumentOnBeforeOpenPage",1],[314,"ext","codeunit",700,"PageRun",1],[317,"call","DocumentDoesNotExist",1],[321,"ext","codeunit",700,"PageRun",1],[324,"ext","codeunit",700,"PageRun",1]]},{"name":"OpenIndividualPurchaseDocument","line":328,"kind":"procedure","access":"local","params":2,"steps":[[336,"event","OnOpenIndividualPurchaseDocumentOnBeforeOpenPage",1],[344,"run","page",51],[346,"run","page",52],[348,"run","page",50],[351,"call","DocumentDoesNotExist",1],[355,"run","page",138],[358,"run","page",140]]},{"name":"SetSalesDocumentMatchRecord","line":362,"kind":"procedure","access":"local","params":3,"steps":[[369,"call","CreateDocumentMatchRecord",6],[371,"call","CreateDocumentMatchRecord",6],[373,"call","CreateDocumentMatchRecord",6]]},{"name":"SetPurchDocumentMatchRecord","line":376,"kind":"procedure","access":"local","params":3,"steps":[[383,"call","CreateDocumentMatchRecord",6],[385,"call","CreateDocumentMatchRecord",6],[387,"call","CreateDocumentMatchRecord",6]]},{"name":"OnNewInvoice","line":391,"kind":"procedure","access":"local","params":2,"steps":[[399,"ext","codeunit",1630,"IsAvailable",0],[400,"ext","codeunit",1630,"GetContext",1],[401,"ext","table",1600,"IsAppointment",0],[402,"call","CreateOfficeInvoiceRecord",3]]},{"name":"OnPostInvoice","line":407,"kind":"procedure","access":"local","params":2,"steps":[[415,"ext","codeunit",1630,"IsAvailable",0],[416,"ext","codeunit",1630,"GetContext",1],[417,"ext","table",1600,"IsAppointment",0],[418,"call","CreateOfficeInvoiceRecord",3]]},{"name":"OnDeleteInvoice","line":423,"kind":"procedure","access":"local","params":2,"steps":[[429,"ext","codeunit",1630,"IsAvailable",0],[431,"ext","codeunit",1630,"GetContext",1],[432,"ext","table",1600,"IsAppointment",0],[434,"write",1606,"Delete"]]},{"name":"CreateOfficeInvoiceRecord","line":437,"kind":"procedure","access":"local","params":3,"steps":[[448,"write",1606,"Insert"],[449,"write",1606,"Modify"]]},{"name":"DisableSuggestedLinesOnDisableMessage","line":453,"kind":"procedure","access":"local","params":0,"steps":[[458,"ext","codeunit",1330,"DisableMessageForCurrentUser",1],[458,"ext","codeunit",1330,"AutomaticLineItemsDialogCode",0],[459,"ext","codeunit",1630,"GetOfficeAddinTelemetryCategory",0]]},{"name":"GenerateLinesOnAfterInsertPurchaseHeader","line":463,"kind":"procedure","access":"local","params":2,"steps":[[471,"ext","codeunit",1630,"IsAvailable",0],[474,"ext","codeunit",1630,"GetOfficeAddinTelemetryCategory",0],[477,"call","GenerateLinesForDocument",1]]},{"name":"GenerateLinesOnAfterInsertSalesHeader","line":481,"kind":"procedure","access":"local","params":2,"steps":[[489,"ext","codeunit",1630,"IsAvailable",0],[492,"ext","codeunit",1630,"GetOfficeAddinTelemetryCategory",0],[499,"call","GenerateLinesForDocument",1]]},{"name":"UnlinkOfficeDocumentOnAfterDeleteSalesHeader","line":503,"kind":"procedure","access":"local","params":2,"steps":[[509,"ext","table",1606,"UnlinkDocument",2]]},{"name":"UnlinkOfficeDocumentOnAfterDeletePurchaseHeader","line":513,"kind":"procedure","access":"local","params":2,"steps":[[519,"ext","table",1606,"UnlinkDocument",2]]},{"name":"GenerateLinesForDocument","line":522,"kind":"procedure","access":"local","params":1,"steps":[[530,"ext","codeunit",1330,"IsEnabled",1],[530,"ext","codeunit",1330,"AutomaticLineItemsDialogCode",0],[531,"ext","codeunit",1630,"GetContext",1],[532,"ext","codeunit",1630,"GetEmailBody",1],[533,"event","OnGenerateLinesFromText",0],[536,"call","ConvertSuggestedLinesToDocumentLines",2]]},{"name":"ConvertSuggestedLinesToDocumentLines","line":540,"kind":"procedure","access":"local","params":2,"steps":[[547,"run","page",1637],[548,"event","OnCloseSuggestedLineItemsPage",0]]}]}