run-al-tests

$npx mdskill add microsoft/AL/run-al-tests

Runs published AL test codeunits against a BCInsider sandbox via prerelease ALTool.

  • Solves running AL tests against a provisioned sandbox without manual setup.
  • Depends on verify-prerelease-altool, publish-al-app, and ALTool with BC environment variables.
  • Uses the provided codeunit ID, project folder, and optional test methods to construct the runtests command.
  • Returns JSON response with passed, failed, and skipped counts, preserving the native exit code.

SKILL.md

.github/skills/run-al-testsView on GitHub ↗
---
name: run-al-tests
description: Runs a published AL test codeunit against the provisioned BCInsider sandbox through the public prerelease ALTool.
argument-hint: "<codeunit-id> [project-folder] [test-methods]"
---

1. Invoke `verify-prerelease-altool`.
2. Publish the test app with `publish-al-app`.
3. Run structured tests:
   ```powershell
   & $env:ALTOOL_PATH runtests $codeunitId `
       --project $projectPath `
       --server $env:BC_SERVER_URL `
       --serverinstance $env:BC_SERVER_INSTANCE `
       --port $env:BC_SERVER_PORT `
       --tenant $env:BC_TENANT `
       --authentication $env:BC_AUTHENTICATION `
       --environmenttype OnPrem
   ```
4. Add `--testmethods` only when specific procedures are requested.
5. Preserve the JSON response and native exit code; report passed, failed, and skipped counts.

More from microsoft/AL

SkillDescription
compile-al-appCompiles a temporary AL project through the workflow-installed public prerelease ALTool and verifies that a fresh app package was emitted.
create-al-projectCreates the smallest temporary AL project needed to reproduce a public issue without VS Code.
download-al-symbolsDownloads exact Business Central symbol packages for a temporary AL reproduction project through the installed prerelease ALTool. Use before compiling any project whose app.json references platform, application, or dependency packages.
publish-al-appPublishes one compiled AL app to the provisioned BCInsider sandbox through the public prerelease ALTool.
run-al-code-analysisRuns CodeCop, PerTenantExtensionCop, UICop, or AppSourceCop against a temporary project through the public prerelease ALTool.
run-al-mcp-toolInvokes one safe AL MCP tooling operation through the workflow-installed prerelease ALTool for independent reproduction of MCP and editor-tooling issues.
verify-al-e2eOrchestrates the smallest production-path AL reproduction through the workflow-installed public prerelease ALTool and BCInsider sandbox.
verify-prerelease-altoolVerifies that the workflow-installed public prerelease ALTool is the executable used for every reproduction command.