\n2) Create Credit Memo using AL (our own Codeunit).
\n3) Create a Subscription Event using AL.<\/strong><\/p>\n
Create Credit Memo using frontend:<\/strong><\/p>\n As shown in above screen shot we will open Correct <\/strong>from menu and click Create Corrective Credit Memo, <\/strong>if invoice is fully opened<\/strong> then at the backend Business Central will run CreateCreditMemoCopyDocument function <\/strong>from Codeunit “Correct Posted Sales Invoice” (1303). Code snippet for CreateCreditMemoCopyDocument\u00a0 function <\/strong>is attached for reference:<\/strong> Code snippet for CreateCorrectiveCreditMemo<\/strong> function <\/strong>is attached for reference:<\/strong><\/p>\n After looking into both functions we can see one main distinction that CreateCorrectiveCreditMemo function has OnCreateCorrectiveCreditMemoOnBeforePageRun<\/strong> event, <\/strong>this is how business central publish\/raise events so that another extension can modify its functionality by subscribing to this event if required. In the event parameter we can see first parameter is SalesHeader which is a header of newly created credit memo and second parameter is IsHandled which is Boolean and passed by reference, this Boolean variable is really important in a way while subscribing to event if we don\u2019t want Business Central to run next piece of code then we can just set IsHandled to true during subscription. Create Credit Memo using AL: Code snippet for our Custom CreditMemo function is attached:<\/p>\n As we can see our custom code call the same CreateCorrectiveCreditMemo <\/strong>function which is also called by Business Central frontend while creating credit memo, now what we want to do is to change the behavior of this function (CreateCorrectiveCreditMemo) depending on the fact if it is called by our own custom function or by standard Business Central function, in order to do that what we will do is to create an entry of specific invoice in our custom F3ComAXSalesInvoiceMapping table after creating credit memo using our custom function, this custom table will help us to keep track of all the invoices we have worked on from our custom function. Create Subscription Event using AL:<\/strong><\/p>\n Code snipped for event subscription:<\/p>\n In the above screenshot we have implemented a function which has some code in it. What that code does is basically look into the Custom F3ComAXSalesInvoiceMapping table to get the entry on the basis of Applies-to Doc. No. field, this field contain the invoice number from which we created a credit memo, if entry found that means this credit memo is created by our custom code, in that case we will set IsHandled flag to true which means Business central will not run the next piece of code (Credit Memo Page will not open), if entry not found that means credit memo is created by standard Business Central code and remaining code will be executed and credit memo page will be opened. Summary:<\/strong> Event Subscription is a powerful way of handling or changing built-in functionality of any extension in Business Central, that extension could be Microsoft extension or any third party extension. Before subscribing to any event we should make sure that event is published in a specific object (codeunit, pages etc.) of another extension. So in short, […]<\/p>\n","protected":false},"author":2,"featured_media":15386,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[37],"tags":[140],"class_list":["post-16374","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-business-central","tag-business-central"],"yoast_head":"\n![\"\"](\"https:\/\/dynamics.folio3.com\/blog\/wp-content\/uploads\/2023\/06\/screenshot-001-1.png\")
<\/p>\n
\n<\/strong>If invoice is not fully opened<\/strong> then at the backend Business Central will run CreateCorrectiveCreditMemo<\/strong> function<\/strong> from Codeunit “Correct Posted Sales Invoice” (1303).<\/strong><\/p>\n![\"\"](\"https:\/\/dynamics.folio3.com\/blog\/wp-content\/uploads\/2023\/06\/screenshot-002-1.png\")
<\/p>\n![\"\"](\"https:\/\/dynamics.folio3.com\/blog\/wp-content\/uploads\/2023\/06\/screenshot-003-1.png\")
<\/p>\n
\nNext we will create a credit memo from our extension using AL.<\/p>\n
\n<\/strong>
\nNow we will achieve the same functionality of creating credit memo from Posted Invoice using our own Codeunit in our custom extension.<\/p>\n![\"\"](\"https:\/\/dynamics.folio3.com\/blog\/wp-content\/uploads\/2023\/06\/screenshot-004-1.png\")
<\/p>\n
\nThe above function CustomCreateCreditMemo<\/strong> takes Posted Invoice No. as an argument and creates a credit memo based on the fact that a specific invoice is fully open or not. When invoice is not fully open then CreateCorrectiveCreditMemo<\/strong> function is going to get called and as we saw earlier after creating the credit memo this function is opening the same credit memo in the form of Page after it\u2019s being created, so basically whenever our custom function is calling CreateCorrectiveCreditMemo <\/strong>function that\u2019s when we don\u2019t want to open credit memo page. So in order to achieve that Event Subscription comes in handy, we will be subscribing to OnCreateCorrectiveCreditMemoOnBeforePageRun Event<\/strong> which is raised in CreateCorrectiveCreditMemo<\/strong> function.<\/p>\n![\"\"](\"https:\/\/dynamics.folio3.com\/blog\/wp-content\/uploads\/2023\/06\/screenshot-005-1.png\")
<\/p>\n
\nAbove function will be executed whenever OnCreateCorrectiveCreditMemoOnBeforePageRun Event <\/strong>is being raised. So how did we link our subscriber function to that event? We defined this on function header, EventSubscriber keyword is showing that this function will be worked as Subscriber, ObjectType would be Codeunit in our case and name of Codeunit would be \u201cCorrect Posted Sales Invoice\u201d because the event we want to subscribe is published in \u201cCorrect Posted Sales Invoice\u201d Codeunit, then we will provide event name on function header and next two parameters would be false.<\/p>\n
\nIn summary what we have done so far is to change the behavior of standard Business Central function
\nBy not changing the standard code itself but subscribing to relevant events, like that we can subscribe to any event which is raised in any extension and achieve our desired functionality.<\/p>\n","protected":false},"excerpt":{"rendered":"