Microsoft/bcquality
1
0
Fork 0
mirror of https://github.com/microsoft/BCQuality.git synced 2026-10-05 22:56:55 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
bcquality/microsoft/knowledge/performance/page-background-tasks-for-expensive-cues.md
Jesper Schulz-Wedde 4f0a13a801
Promote knowledge for Microsoft review skills (#153) 
Move canonical knowledge for Microsoft-owned review domains into the Microsoft layer and document the skill/knowledge co-location policy.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Co-authored-by: Jesper Schulz-Wedde <jesper.schulzwedde@microsoft.com>
Copilot-Session: 2a6ea875-d38e-4f30-aadb-0d606f9be231
2026-09-03 15:06:01 +02:00

1.3 KiB
Raw Blame History

bc-version domain keywords technologies countries application-area
15..
performance
page-background-task
cue
rolecenter
enqueuebackgroundtask
ui-thread
al
w1
all

Calculate expensive cues on a page background task

Contributions welcome — open a PR to refine or extend this article.

Description

Role-center cues and CardPart totals that run CalcFields, scans, or HTTP on the UI thread freeze the shell until they finish. Page background tasks exist to return the page immediately and fill the number later. Enqueue mechanics, cancellation, and the read-only child session are covered in microsoft/knowledge/ui/page-background-tasks.md. This file is the performance trigger: a cue whose value is not needed to open the page must not run on the render path.

Best Practice

Bind the cue to a page variable, enqueue a read-only calculation from OnAfterGetCurrRecord (not OnAfterGetRecord on a list), and apply the result in OnPageBackgroundTaskCompleted. Show a placeholder until then.

See sample: page-background-tasks-for-expensive-cues.good.al.

Anti Pattern

CalcFields or a ledger Count in OnOpenPage / OnAfterGetCurrRecord of a CueGroup CardPart with no background task. The Role Center waits on SQL the user may never look at.

See sample: page-background-tasks-for-expensive-cues.bad.al.