bcquality/microsoft/knowledge/events/do-not-publish-events-inside-loops.good.al
Jesper Schulz-Wedde faeacb2484 Add 12 general AL event-design articles to events domain
Add 12 atomic knowledge articles under microsoft/knowledge/events covering
general AL event-design best practices: IsHandled initialization and OnAfter
preservation, appending new event parameters, position-based event naming,
reusing/extending events, avoiding per-iteration publishing, Temp-prefixing
temporary record parameters, unabbreviated parameter names, preferring the
this keyword over IncludeSender, avoiding loosely typed parameters, not
mutating existing event contracts, and not bypassing critical operations
with IsHandled. Each article ships a .good.al and .bad.al demonstration
sample (object IDs 50240-50296; not compiled by CI). Extend the
al-events-review leaf Worklist with one targeted check per new rule.

Additive only; no contract or wiring change (events leaf already wired).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-06-25 11:58:59 +02:00

28 lines
879 B
AL

// Demonstration-only AL. Not compiled by CI; illustrates the article.
codeunit 50265 "Loop Event Good Sample"
{
procedure ProcessLines(var SalesLine: Record "Sales Line")
begin
// Fire once before the loop; subscribers act on the whole set.
OnBeforeProcessLines(SalesLine);
if SalesLine.FindSet() then
repeat
SalesLine."Line Amount" := SalesLine.Quantity * SalesLine."Unit Price";
SalesLine.Modify(true);
until SalesLine.Next() = 0;
// Fire once after the loop.
OnAfterProcessLines(SalesLine);
end;
[IntegrationEvent(false, false)]
local procedure OnBeforeProcessLines(var SalesLine: Record "Sales Line")
begin
end;
[IntegrationEvent(false, false)]
local procedure OnAfterProcessLines(var SalesLine: Record "Sales Line")
begin
end;
}