b6da405376
Lead with a complete plugin quick start and add task-oriented usage, troubleshooting, customization, and contribution guides. Preserve the broader plugin framing, correct conflicting contract guidance, support Agents folder reviews, and align repository validation. Convert existing sample references to clickable links without changing knowledge rules. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
1.5 KiB
| bc-version | domain | keywords | technologies | countries | application-area | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
performance |
|
|
|
|
Session-open subscribers must not do I/O
Contributions welcome — open a PR to refine or extend this article.
Description
OnCompanyOpen, OnCompanyOpenCompleted, and System Initialization.OnAfterLogin run while the session is being created. The platform waits until every subscriber returns before the UI, an API call, or a background session can proceed. HttpClient or a heavy FindSet here delays every session type, not just the user who "opened the company". Agents still put warmup sync, license checks, and HTTP probes on these events because they look like an application startup hook.
Best Practice
Keep company-open subscribers to cheap in-memory work: set a flag, enqueue a job-queue entry, or TaskScheduler.CreateTask. Perform HTTP and large SQL after the session is running, in that background work.
See sample: oncompanyopen-subscribers-must-not-do-io.good.al.
Anti Pattern
An OnAfterLogin / OnCompanyOpenCompleted subscriber that calls HttpClient or scans a ledger. Detection signal: HttpClient, FindSet, or CalcFields inside a subscriber bound to those events.
See sample: oncompanyopen-subscribers-must-not-do-io.bad.al.