bcquality/microsoft/knowledge/testing/testisolation-belongs-on-the-test-runner.md
Jesper Schulz-Wedde 186d8a1314
Some checks failed
Validate knowledge index / validate-index (push) Has been cancelled
Validate AL review fixtures / validate-review-fixtures (push) Has been cancelled
Validate frontmatter and structure / validate (push) Has been cancelled
Complete AL review knowledge readiness (#108)
* Complete AL review knowledge readiness

Fill telemetry and Query coverage, strengthen thin review domains, correct audited content defects, and add deterministic cheap-model evaluation and reference-integrity safeguards.

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

Copilot-Session: 9825b012-e653-496a-9310-c1f4b6f8ac27

* Generalize review fixture discovery

Derive smoke cases from the leaf, domain, and paired-sample conventions so new leaves require no scoring-contract changes. Keep only exceptional selection/context overrides and fail when retrieval metadata cannot rank the selected article.

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

Copilot-Session: 9825b012-e653-496a-9310-c1f4b6f8ac27

* Preserve published field IDs in sample

Keep the existing Email and Contact Email field IDs unchanged, clarify that the sample represents an independent baseline, and use a local breaking-change rule for the generic smoke evaluation.

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

Copilot-Session: 9825b012-e653-496a-9310-c1f4b6f8ac27

* Clarify published field identity rules

State explicitly that a published field keeps its ID, name, and type while a replacement is added as a separate field under an unused ID.

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

Copilot-Session: 9825b012-e653-496a-9310-c1f4b6f8ac27

* Align field obsoletion sample baselines

Use Email field ID 3 as the shared baseline so the bad example demonstrates a same-ID rename while the good example retains the original field and adds a separate replacement.

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

Copilot-Session: 9825b012-e653-496a-9310-c1f4b6f8ac27

---------

Co-authored-by: Jesper Schulz-Wedde <jesper.schulzwedde@microsoft.com>
2026-07-15 10:55:25 +02:00

1.5 KiB

bc-version domain keywords technologies countries application-area
all
testing
testisolation
testrunner
autocommit
commit
rollback
test-order
database-state
al
w1
all

Configure TestIsolation on the test runner

Description

TestIsolation is a property of a Subtype = TestRunner codeunit, not of the test codeunit being executed. Its default is Disabled. Codeunit rolls back database changes after each test codeunit and Function after each test method, including changes that the code under test explicitly committed. Without runner isolation, an AutoCommit test can leave data behind and make later tests order-dependent.

Best Practice

Run independent suites with TestIsolation = Codeunit or Function, choosing the narrowest boundary the runner supports. Pair this with the appropriate method-level TransactionModel: AutoCommit permits code under test to commit, while runner isolation still restores the database afterward. Keep isolation disabled only for an intentionally shared-state suite whose ordering and cleanup are explicit.

See sample: testisolation-belongs-on-the-test-runner.good.al.

Anti Pattern

An AutoCommit test exercises committed writes under a test runner that omits TestIsolation or sets it to Disabled, then assumes the database is restored automatically. This article owns runner-level rollback; transactionmodel-attribute-governs-test-transactions.md separately owns the method attribute.

See sample: testisolation-belongs-on-the-test-runner.bad.al.