Run "Update AL-Go System Files" on multiple branches

Actions/AL-Go-Helper.ps1

@@ -553,6 +553,7 @@ function ReadSettings {
     $settings = [ordered]@{
         "type"                                          = "PTE"
         "unusedALGoSystemFiles"                         = @()
+        "updateALGoBranches"                            = @("main")
         "projects"                                      = @()
         "powerPlatformSolutionFolder"                   = ""
         "country"                                       = "us"

Actions/GetGitBranches/GetGitBranches.ps1

@@ -0,0 +1,27 @@
+param(
+    [Parameter(Mandatory = $false, HelpMessage = "JSON-formatted array of branches to include if they exist. If not specified, all branches are returned. Wildcards are supported.")]
+    [string] $includeBranchesJson = '[]'
+)
+
+$gitHubHelperPath = Join-Path $PSScriptRoot '../Github-Helper.psm1' -Resolve
+Import-Module $gitHubHelperPath -DisableNameChecking
+
+invoke-git fetch
+$allBranches = @(invoke-git -returnValue for-each-ref --format="%(refname:short)" refs/remotes/origin | ForEach-Object { $_ -replace 'origin/', '' })
+
+$includeBranches = ConvertFrom-Json $includeBranchesJson
+if ($includeBranches) {
+    Write-Host "Filtering branches by: $($includeBranches -join ', ')"
+    $branches = @()
+    foreach ($branchFilter in $includeBranches) {
+        $branches += $allBranches | Where-Object { $_ -like $branchFilter }
+    }
+}
+else {
+    $branches = $allBranches
+}
+
+Write-Host "Found git branches: $($branches -join ', ')"
+
+# Add the branches to the output
+Add-Content -Encoding UTF8 -Path $env:GITHUB_OUTPUT -Value "Branches=$(ConvertTo-Json $branches -Depth 99 -Compress)"

Actions/GetGitBranches/README.md

@@ -0,0 +1,23 @@
+# Get Git Branches
+Gets current git branches defined on the remote repository
+
+## INPUT
+
+### ENV variables
+none
+
+### Parameters
+| Name | Required | Description | Default value |
+| :-- | :-: | :-- | :-- |
+| shell | | The shell (powershell or pwsh) in which the PowerShell script in this action should run | powershell |
+| includeBranches | | JSON-formatted array of branches to include if they exist. If not specified, all branches are returned. Wildcards are supported. ||
+
+## OUTPUT
+
+### ENV variables
+none
+
+### OUTPUT variables
+| Name | Description |
+| :-- | :-- |
+| Branches | The list of branches on the remote repository |

Actions/GetGitBranches/action.yaml

@@ -0,0 +1,36 @@
+name: Get Git Branches
+author: Microsoft Corporation
+description: Get the list of branches in the repository
+inputs:
+  shell:
+    description: Shell in which you want to run the action (powershell or pwsh)
+    required: false
+    default: powershell
+  includeBranchesJson:
+    description: JSON-formatted array of branches to include if they exist. If not specified, all branches are returned. Wildcards are supported.
+    required: false
+    default: '[]'
+outputs:
+  Branches:
+    description: The list of branches in the repository
+    value: ${{ steps.GetGitBranches.outputs.Branches }}
+runs:
+  using: composite
+  steps:
+    - name: run
+      shell: ${{ inputs.shell }}
+      id: GetGitBranches
+      env:
+        _includeBranchesJson: ${{ inputs.includeBranchesJson }}
+      run: |
+        $errorActionPreference = "Stop"; $ProgressPreference = "SilentlyContinue"; Set-StrictMode -Version 2.0
+        try {
+          ${{ github.action_path }}/GetGitBranches.ps1 -includeBranchesJson $env:_includeBranchesJson
+        }
+        catch {
+          Write-Host "::ERROR::Unexpected error when running action. Error Message: $($_.Exception.Message.Replace("`r",'').Replace("`n",' ')), StackTrace: $($_.ScriptStackTrace.Replace("`r",'').Replace("`n",' <- '))";
+          exit 1
+        }
+branding:
+  icon: terminal
+  color: blue

Actions/ReadSettings/ReadSettings.ps1

@@ -57,7 +57,7 @@ $settings.Keys | ForEach-Object {
     }
     $outSettings += @{ "$setting" = $settingValue }
     if ($getSettings -contains $setting) {
-        if ($settingValue -is [System.Collections.Specialized.OrderedDictionary] -or $settingValue -is [hashtable]) {
+        if ($settingValue -is [System.Collections.Specialized.OrderedDictionary] -or $settingValue -is [hashtable] -or $settingValue -is [array]) {
             Add-Content -Encoding UTF8 -Path $env:GITHUB_ENV -Value "$setting=$(ConvertTo-Json $settingValue -Depth 99 -Compress)"
         }
         else {

Templates/Per Tenant Extension/.github/workflows/UpdateGitHubGoSystemFiles.yaml

@@ -28,9 +28,52 @@ env:
   ALGoRepoSettings: ${{ vars.ALGoRepoSettings }}
 
 jobs:
+  GetBranches:
+    runs-on: windows-latest
+    name: Get Supported Branches
+    outputs:
+      SupportedBranches: ${{ steps.DetermineBranches.outputs.Result }}
+    steps:
+      - name: Checkout
+        if: ${{ github.event_name != 'workflow_dispatch' }}
+        uses: actions/checkout@v4
+
+      - name: Read settings
+        if: ${{ github.event_name != 'workflow_dispatch' }}
+        uses: microsoft/AL-Go-Actions/ReadSettings@main
+        with:
+          shell: powershell
+          get: updateALGoBranches
+
+      - name: Get Supported Branches
+        if: ${{ github.event_name != 'workflow_dispatch' }}
+        id: GetSupportedBranches
+        uses: microsoft/AL-Go-Actions/GetGitBranches@main
+        with:
+          shell: powershell
+          includeBranchesJson: ${{ env.updateALGoBranches }}
+
+      - name: Determine branches to update
+        id: DetermineBranches
+        run: |
+            if (${{ github.event_name }} -eq 'workflow_dispatch') {
+              Write-Host "Running Update AL-Go System Files on a manual trigger."
+              Add-Content -Encoding UTF8 -Path $env:GITHUB_OUTPUT -Value "Result=['${{ github.ref_name }}']"
+            }
+            else {
+              Write-Host "Running Update AL-Go System Files on a schedule."
+              Add-Content -Encoding UTF8 -Path $env:GITHUB_OUTPUT -Value "Result=$(${{ steps.GetSupportedBranches.outputs.Branches }})"
+            }
+
   UpdateALGoSystemFiles:
-    needs: [ ]
+    needs: [ GetBranches ]
     runs-on: [ windows-latest ]
+    name: "[${{ matrix.branch }}] Update AL-Go"
+    strategy:
+      matrix:
+        branch: ${{ fromJson(needs.GetBranches.outputs.SupportedBranches) }}
+      fail-fast: false
+
     steps:
       - name: Dump Workflow Information
         uses: microsoft/AL-Go-Actions/DumpWorkflowInfo@main
@@ -39,6 +82,8 @@ jobs:
 
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          ref: ${{ matrix.branch }}
 
       - name: Initialize the workflow
         id: init
@@ -99,6 +144,7 @@ jobs:
           update: 'Y'
           templateUrl: ${{ env.templateUrl }}
           directCommit: ${{ env.directCommit }}
+          updateBranch: ${{ matrix.branch }}
 
       - name: Finalize the workflow
         if: always()