microsoft / microsoft/AL-Go

[Bug]: Error downloading aldoc because it is not included in the artifact

Open
#2,244 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug Workaround provided
Dominant language
PowerShell
Stars
506
Forks
203
Avg merge
4d 22h
Merged PRs (30d)
6

Description

AL-Go version

8.3

Describe the issue

When I use the “Create Reference Documentation” feature in CI/CD in AL-Go, it cannot find aldoc for country-specific on-premises artifacts.

In the https://github.com/microsoft/AL-Go/blob/main/Actions/BuildReferenceDocumentation/BuildReferenceDocumentation.HelperFunctions.ps1, the artifact-url is changed to a non-existent URL.
Would it be possible to define a separate artifactUrl for aldoc in the settings? Or to modify the configuration so that it points to an existing URL?

Expected behavior

AL-Go finds aldoc and can build the documentation.

Steps to reproduce

Use

"country": "de",
"artifact": "/OnPrem/27.4//latest",

in .AL-Go/settings.xml

Additional context (logs, screenshots, etc.)

https://github.com/microsoft/AL-Go/blob/main/Actions/BuildReferenceDocumentation/BuildReferenceDocumentation.HelperFunctions.ps1

function DownloadAlDoc {
    Param(
        [string] $artifactUrl = ''
    )
    if ("$ENV:aldocPath" -eq "") {
        $ENV:aldocCommand = ''
        Write-Host "Locating aldoc"
        if ($artifactUrl -notlike "https://*") {
            Write-Host "ArtifactUrl ($artifactUrl) provided, but not in the format of a URL, ignoring it and using latest non-insider sandbox artifact instead."
            $artifactUrl = Get-BCArtifactUrl -type sandbox -country core -select Latest -accept_insiderEula
        } elseif ($artifactUrl -notlike "*/core") {
            # Change country to core as aldoc is not shipped in country specific artifacts
            $artifactUrlCountry = $artifactUrl.Split('/')[-1]
            $artifactUrl = $artifactUrl.Replace("/$artifactUrlCountry",'/core')
        }
        Write-Host "Found artifactUrl: $artifactUrl"
        Write-Host "Downloading aldoc"

Error

2026-05-10T16:57:04.3302096Z Locating aldoc
2026-05-10T16:57:04.3321004Z Found artifactUrl: https://bcartifacts-exdbf9fwegejdqak.b02.azurefd.net/onprem/27.4.45366.45458/core
2026-05-10T16:57:04.3327902Z Downloading aldoc
2026-05-10T16:57:04.4680372Z Downloading artifact /onprem/27.4.45366.45458/core
2026-05-10T16:57:04.4930932Z Downloading C:\Users\runneradmin\AppData\Local\Temp\699138f2-a40b-4a7f-bc17-2ec29fd558d1.zip
2026-05-10T16:57:06.0940440Z Download-Artifacts Telemetry Correlation Id: e5f773b9-f9b6-4a11-be9b-5dcb7f0172ec
2026-05-10T16:57:06.7398275Z Enabling Microsoft telemetry...
2026-05-10T16:57:07.1451460Z ##[error]Unexpected error when running action. Error Message: Exception calling "GetResult" with "0" argument(s): "Response status code does not indicate success: 404 (The specified blob does not exist.)." Response status code does not indicate success: 404 (The specified blob does not exist.)., StackTrace: at Download-File, C:\ProgramData\BcContainerHelper\6.1.14\BcContainerHelper\Common\Download-File.ps1: line 83 <- at DownloadPackage, C:\ProgramData\BcContainerHelper\6.1.14\BcContainerHelper\Artifacts\Download-Artifacts.ps1: line 50 <- at Download-Artifacts, C:\ProgramData\BcContainerHelper\6.1.14\BcContainerHelper\Artifacts\Download-Artifacts.ps1: line 171 <- at DownloadAlDoc, D:\a\_actions\microsoft\AL-Go-Actions\v8.3\BuildReferenceDocumentation\BuildReferenceDocumentation.HelperFunctions.ps1: line 18 <- at GenerateDocsSite, D:\a\_actions\microsoft\AL-Go-Actions\v8.3\BuildReferenceDocumentation\BuildReferenceDocumentation.HelperFunctions.ps1: line 192 <- at <ScriptBlock>, D:\a\_actions\microsoft\AL-Go-Actions\v8.3\BuildReferenceDocumentation\BuildReferenceDocumentation.ps1: line 71 <- at <ScriptBlock>, D:\a\_temp\24f30bd5-a71f-4999-a303-7c38521602e5.ps1: line 3 <- at <ScriptBlock>, D:\a\_actions\microsoft\AL-Go-Actions\v8.3\Invoke-AlGoAction.ps1: line 21 <- at <ScriptBlock>, D:\a\_temp\24f30bd5-a71f-4999-a303-7c38521602e5.ps1: line 2 <- at <ScriptBlock>, <No file>: line 1

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with Actions/BuildReferenceDocumentation/BuildReferenceDocumentation.HelperFunctions.ps1, especially DownloadAlDoc and its call from GenerateDocsSite. Reproduce the issue using country de and the on-premises artifact in .AL-Go/settings.xml, then verify that the reference-documentation workflow locates aldoc and completes the documentation build without the 404 error.

Written by the indexing model from the issue text.

Assessment

Tech stack
powershell
Domain
ci-cd, devops
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.