Skip to content

Commit cccd6b8

Browse files
NovoaDevNovoaDev
committed
[main] Update AL-Go System Files from microsoft/AL-Go-PTE@main - ba4fc723e4c024674baa6a53ef1777402cfbaab0
1 parent 554945a commit cccd6b8

21 files changed

+240
-223
lines changed

‎.AL-Go/cloudDevEnv.ps1

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -42,9 +42,9 @@ Write-Host -ForegroundColor Yellow @'
4242

4343
$tmpFolder = Join-Path ([System.IO.Path]::GetTempPath()) "$([Guid]::NewGuid().ToString())"
4444
New-Item -Path $tmpFolder -ItemType Directory -Force | Out-Null
45-
$GitHubHelperPath = DownloadHelperFile -url 'https://raw.githubusercontent.com/microsoft/AL-Go-Actions/v6.2/Github-Helper.psm1' -folder $tmpFolder
46-
$ALGoHelperPath = DownloadHelperFile -url 'https://raw.githubusercontent.com/microsoft/AL-Go-Actions/v6.2/AL-Go-Helper.ps1' -folder $tmpFolder
47-
DownloadHelperFile -url 'https://raw.githubusercontent.com/microsoft/AL-Go-Actions/v6.2/Packages.json' -folder $tmpFolder | Out-Null
45+
$GitHubHelperPath = DownloadHelperFile -url 'https://raw.githubusercontent.com/microsoft/AL-Go-Actions/v6.3/Github-Helper.psm1' -folder $tmpFolder
46+
$ALGoHelperPath = DownloadHelperFile -url 'https://raw.githubusercontent.com/microsoft/AL-Go-Actions/v6.3/AL-Go-Helper.ps1' -folder $tmpFolder
47+
DownloadHelperFile -url 'https://raw.githubusercontent.com/microsoft/AL-Go-Actions/v6.3/Packages.json' -folder $tmpFolder | Out-Null
4848

4949
Import-Module $GitHubHelperPath
5050
. $ALGoHelperPath -local

‎.AL-Go/localDevEnv.ps1

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -46,9 +46,9 @@ Write-Host -ForegroundColor Yellow @'
4646

4747
$tmpFolder = Join-Path ([System.IO.Path]::GetTempPath()) "$([Guid]::NewGuid().ToString())"
4848
New-Item -Path $tmpFolder -ItemType Directory -Force | Out-Null
49-
$GitHubHelperPath = DownloadHelperFile -url 'https://raw.githubusercontent.com/microsoft/AL-Go-Actions/v6.2/Github-Helper.psm1' -folder $tmpFolder
50-
$ALGoHelperPath = DownloadHelperFile -url 'https://raw.githubusercontent.com/microsoft/AL-Go-Actions/v6.2/AL-Go-Helper.ps1' -folder $tmpFolder
51-
DownloadHelperFile -url 'https://raw.githubusercontent.com/microsoft/AL-Go-Actions/v6.2/Packages.json' -folder $tmpFolder | Out-Null
49+
$GitHubHelperPath = DownloadHelperFile -url 'https://raw.githubusercontent.com/microsoft/AL-Go-Actions/v6.3/Github-Helper.psm1' -folder $tmpFolder
50+
$ALGoHelperPath = DownloadHelperFile -url 'https://raw.githubusercontent.com/microsoft/AL-Go-Actions/v6.3/AL-Go-Helper.ps1' -folder $tmpFolder
51+
DownloadHelperFile -url 'https://raw.githubusercontent.com/microsoft/AL-Go-Actions/v6.3/Packages.json' -folder $tmpFolder | Out-Null
5252

5353
Import-Module $GitHubHelperPath
5454
. $ALGoHelperPath -local

‎.github/AL-Go-Settings.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,5 +4,5 @@
44
"nextMinorSchedule": "0 0 15 * *",
55
"UpdateGitHubGoSystemFilesSchedule": "0 0 1,15 * *",
66
"templateUrl": "https://github.com/microsoft/AL-Go-PTE@main",
7-
"templateSha": "1ac0d953e1909925d7c7b06361f225f8883a9674"
7+
"templateSha": "ba4fc723e4c024674baa6a53ef1777402cfbaab0"
88
}

‎.github/RELEASENOTES.copy.md

Lines changed: 35 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,30 @@
1+
## v6.3
2+
3+
### Deprecations
4+
5+
- `cleanModePreprocessorSymbols` will be removed after April 1st 2025. Use [Conditional Settings](https://aka.ms/algosettings#conditional-settings) instead, specifying buildModes and the `preprocessorSymbols` setting. Read [this](https://aka.ms/algodeprecations#cleanModePreprocessorSymbols) for more information.
6+
7+
### Issues
8+
9+
- It is now possible to skip the modification of dependency version numbers when running the Increment Version number workflow or the Create Release workflow
10+
11+
### New Repository Settings
12+
13+
- [`shortLivedArtifactsRetentionDays`](https://aka.ms/algosettings#shortLivedArtifactsRetentionDays) determines the number of days to keep short lived build artifacts (f.ex build artifacts from pull request builds, next minor or next major builds). 1 is default. 0 means use GitHub default.
14+
- [`preProcessorSymbols`](https://aka.ms/algosettings#preProcessorSymbols) is a list of preprocessor symbols to use when building the apps. This setting can be specified in [workflow specific settings files](https://aka.ms/algosettings#where-are-the-settings-located) or in [conditional settings](https://aka.ms/algosettings#conditional-settings).
15+
16+
### New Versioning Strategy
17+
18+
Setting versioning strategy to 3 will allow 3 segments of the version number to be defined in app.json and repoVersion. Only the 4th segment (Revision) will be defined by the GitHub [run_number](https://go.microsoft.com/fwlink/?linkid=2217416&clcid=0x409) for the CI/CD workflow. Increment version number and Create Release now also supports the ability to set a third segment to the RepoVersion and appversion in app.json.
19+
20+
### Change in published artifacts
21+
22+
When using `useProjectDependencies` in a multi-project repository, AL-Go for GitHub used to generate short lived build artifacts called `thisBuild-<projectnaame>-<type>-...`. This is no longer the case. Instead, normal build artifacts will be published and used by depending projects. The retention period for the short lived artifacts generated are controlled by a settings called [`shortLivedArtifactsRetentionDays`](https://aka.ms/algosettings#shortLivedArtifactsRetentionDays).
23+
24+
### Preprocessor symbols
25+
26+
It is now possible to define preprocessor symbols, which will be used when building your apps using the [`preProcessorSymbols`](https://aka.ms/algosettings#preProcessorSymbols) setting. This setting can be specified in workflow specific settings file or it can be used in conditional settings.
27+
128
## v6.2
229

330
### Issues
@@ -130,7 +157,7 @@ AL-Go for GitHub now includes a new telemetry module. For detailed information o
130157
- **NumberOfSqlStmtsWarning** - a warning is issued if the number of SQL statements from a bcpt test increases more than this percentage (default 5)
131158
- **NumberOfSqlStmtsError** - an error is issued if the number of SQL statements from a bcpt test increases more than this percentage (default 10)
132159

133-
> \[!NOTE\]
160+
> [!NOTE]
134161
> Duration thresholds are subject to varying results depending on the performance of the agent running the tests. Number of SQL statements executed by a test is often the most reliable indicator of performance degredation.
135162
136163
## v5.2
@@ -157,7 +184,7 @@ AL-Go for GitHub now includes a new telemetry module. For detailed information o
157184
- **Pull PowerPlatform Changes** for pulling changes from your PowerPlatform development environment into your AL-Go for GitHub repository
158185
- **Push PowerPlatform Changes** for pushing changes from your AL-Go for GitHub repository to your PowerPlatform development environment
159186

160-
> \[!NOTE\]
187+
> [!NOTE]
161188
> PowerPlatform workflows are only available in the PTE template and will be removed if no PowerPlatformSolutionFolder is defined in settings.
162189
163190
### New Scenarios (Documentation)
@@ -167,7 +194,7 @@ AL-Go for GitHub now includes a new telemetry module. For detailed information o
167194
- [Try one of the Business Central and Power Platform samples](https://github.com/microsoft/AL-Go/blob/main/Scenarios/TryPowerPlatformSamples.md)
168195
- [Publish To AppSource](https://github.com/microsoft/AL-Go/blob/main/Scenarios/PublishToAppSource.md)
169196

170-
> \[!NOTE\]
197+
> [!NOTE]
171198
> PowerPlatform functionality are only available in the PTE template.
172199
173200
## v5.1
@@ -305,8 +332,8 @@ AL-Go for GitHub allows you to build and test using insider builds without any e
305332

306333
- `enableExternalRulesets`: set this setting to true if you want to allow AL-Go to automatically download external references in rulesets.
307334
- `deliverTo<deliveryTarget>`: is not really new, but has new properties and wasn't documented. The complete list of properties is here (note that some properties are deliveryTarget specific):
308-
- **Branches** = an array of branch patterns, which are allowed to deliver to this deliveryTarget. (Default \[ "main" \])
309-
- **CreateContainerIfNotExist** = *\[Only for DeliverToStorage\]* Create Blob Storage Container if it doesn't already exist. (Default false)
335+
- **Branches** = an array of branch patterns, which are allowed to deliver to this deliveryTarget. (Default [ "main" ])
336+
- **CreateContainerIfNotExist** = *[Only for DeliverToStorage]* Create Blob Storage Container if it doesn't already exist. (Default false)
310337

311338
### Deployment
312339

@@ -347,7 +374,7 @@ Earlier, you could also specify the projects you want to deploy to an environmen
347374
- `deployTo<environmentName>`: is not really new, but has new properties. The complete list of properties is here:
348375
- **EnvironmentType** = specifies the type of environment. The environment type can be used to invoke a custom deployment. (Default SaaS)
349376
- **EnvironmentName** = specifies the "real" name of the environment if it differs from the GitHub environment
350-
- **Branches** = an array of branch patterns, which are allowed to deploy to this environment. (Default \[ "main" \])
377+
- **Branches** = an array of branch patterns, which are allowed to deploy to this environment. (Default [ "main" ])
351378
- **Projects** = In multi-project repositories, this property can be a comma separated list of project patterns to deploy to this environment. (Default \*)
352379
- **SyncMode** = ForceSync if deployment to this environment should happen with ForceSync, else Add. If deploying to the development endpoint you can also specify Development or Clean. (Default Add)
353380
- **ContinuousDeployment** = true if this environment should be used for continuous deployment, else false. (Default: AL-Go will continuously deploy to sandbox environments or environments, which doesn't end in (PROD) or (FAT)
@@ -405,8 +432,8 @@ Now, you can set the checkbox called Use GhTokenWorkflow to allowing you to use
405432

406433
### New Settings
407434

408-
- `keyVaultCodesignCertificateName`: With this setting you can delegate the codesigning to an Azure Key Vault. This can be useful if your certificate has to be stored in a Hardware Security Module
409-
- `PullRequestTrigger`: With this setting you can set which trigger to use for Pull Request Builds. By default AL-Go will use pull_request_target.
435+
- `keyVaultCodesignCertificateName`: With this setting you can delegate the codesigning to an Azure Key Vault. This can be useful if your certificate has to be stored in a Hardware Security Module
436+
- `PullRequestTrigger`: With this setting you can set which trigger to use for Pull Request Builds. By default AL-Go will use pull_request_target.
410437

411438
### New Actions
412439

‎.github/workflows/AddExistingAppOrTestApp.yaml

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ jobs:
4141
runs-on: [ windows-latest ]
4242
steps:
4343
- name: Dump Workflow Information
44-
uses: microsoft/AL-Go-Actions/DumpWorkflowInfo@v6.2
44+
uses: microsoft/AL-Go-Actions/DumpWorkflowInfo@v6.3
4545
with:
4646
shell: powershell
4747

@@ -50,26 +50,26 @@ jobs:
5050

5151
- name: Initialize the workflow
5252
id: init
53-
uses: microsoft/AL-Go-Actions/WorkflowInitialize@v6.2
53+
uses: microsoft/AL-Go-Actions/WorkflowInitialize@v6.3
5454
with:
5555
shell: powershell
5656

5757
- name: Read settings
58-
uses: microsoft/AL-Go-Actions/ReadSettings@v6.2
58+
uses: microsoft/AL-Go-Actions/ReadSettings@v6.3
5959
with:
6060
shell: powershell
6161

6262
- name: Read secrets
6363
id: ReadSecrets
64-
uses: microsoft/AL-Go-Actions/ReadSecrets@v6.2
64+
uses: microsoft/AL-Go-Actions/ReadSecrets@v6.3
6565
with:
6666
shell: powershell
6767
gitHubSecrets: ${{ toJson(secrets) }}
6868
getSecrets: 'TokenForPush'
6969
useGhTokenWorkflowForPush: '${{ github.event.inputs.useGhTokenWorkflow }}'
7070

7171
- name: Add existing app
72-
uses: microsoft/AL-Go-Actions/AddExistingApp@v6.2
72+
uses: microsoft/AL-Go-Actions/AddExistingApp@v6.3
7373
with:
7474
shell: powershell
7575
token: ${{ steps.ReadSecrets.outputs.TokenForPush }}
@@ -79,7 +79,7 @@ jobs:
7979

8080
- name: Finalize the workflow
8181
if: always()
82-
uses: microsoft/AL-Go-Actions/WorkflowPostProcess@v6.2
82+
uses: microsoft/AL-Go-Actions/WorkflowPostProcess@v6.3
8383
env:
8484
GITHUB_TOKEN: ${{ github.token }}
8585
with:

‎.github/workflows/CICD.yaml

Lines changed: 21 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ jobs:
4545
workflowDepth: ${{ steps.DetermineWorkflowDepth.outputs.WorkflowDepth }}
4646
steps:
4747
- name: Dump Workflow Information
48-
uses: microsoft/AL-Go-Actions/DumpWorkflowInfo@v6.2
48+
uses: microsoft/AL-Go-Actions/DumpWorkflowInfo@v6.3
4949
with:
5050
shell: powershell
5151

@@ -56,21 +56,21 @@ jobs:
5656

5757
- name: Initialize the workflow
5858
id: init
59-
uses: microsoft/AL-Go-Actions/WorkflowInitialize@v6.2
59+
uses: microsoft/AL-Go-Actions/WorkflowInitialize@v6.3
6060
with:
6161
shell: powershell
6262

6363
- name: Read settings
6464
id: ReadSettings
65-
uses: microsoft/AL-Go-Actions/ReadSettings@v6.2
65+
uses: microsoft/AL-Go-Actions/ReadSettings@v6.3
6666
with:
6767
shell: powershell
6868
get: type,powerPlatformSolutionFolder,useGitSubmodules
6969

7070
- name: Read submodules token
7171
id: ReadSubmodulesToken
7272
if: env.useGitSubmodules != 'false' && env.useGitSubmodules != ''
73-
uses: microsoft/AL-Go-Actions/ReadSecrets@v6.2
73+
uses: microsoft/AL-Go-Actions/ReadSecrets@v6.3
7474
with:
7575
shell: powershell
7676
gitHubSecrets: ${{ toJson(secrets) }}
@@ -91,7 +91,7 @@ jobs:
9191
9292
- name: Determine Projects To Build
9393
id: determineProjectsToBuild
94-
uses: microsoft/AL-Go-Actions/DetermineProjectsToBuild@v6.2
94+
uses: microsoft/AL-Go-Actions/DetermineProjectsToBuild@v6.3
9595
with:
9696
shell: powershell
9797
maxBuildDepth: ${{ env.workflowDepth }}
@@ -104,23 +104,23 @@ jobs:
104104
105105
- name: Determine Delivery Target Secrets
106106
id: DetermineDeliveryTargetSecrets
107-
uses: microsoft/AL-Go-Actions/DetermineDeliveryTargets@v6.2
107+
uses: microsoft/AL-Go-Actions/DetermineDeliveryTargets@v6.3
108108
with:
109109
shell: powershell
110110
projectsJson: '${{ steps.determineProjectsToBuild.outputs.ProjectsJson }}'
111111
checkContextSecrets: 'false'
112112

113113
- name: Read secrets
114114
id: ReadSecrets
115-
uses: microsoft/AL-Go-Actions/ReadSecrets@v6.2
115+
uses: microsoft/AL-Go-Actions/ReadSecrets@v6.3
116116
with:
117117
shell: powershell
118118
gitHubSecrets: ${{ toJson(secrets) }}
119119
getSecrets: ${{ steps.DetermineDeliveryTargetSecrets.outputs.ContextSecrets }}
120120

121121
- name: Determine Delivery Targets
122122
id: DetermineDeliveryTargets
123-
uses: microsoft/AL-Go-Actions/DetermineDeliveryTargets@v6.2
123+
uses: microsoft/AL-Go-Actions/DetermineDeliveryTargets@v6.3
124124
env:
125125
Secrets: '${{ steps.ReadSecrets.outputs.Secrets }}'
126126
with:
@@ -130,7 +130,7 @@ jobs:
130130

131131
- name: Determine Deployment Environments
132132
id: DetermineDeploymentEnvironments
133-
uses: microsoft/AL-Go-Actions/DetermineDeploymentEnvironments@v6.2
133+
uses: microsoft/AL-Go-Actions/DetermineDeploymentEnvironments@v6.3
134134
env:
135135
GITHUB_TOKEN: ${{ github.token }}
136136
with:
@@ -146,13 +146,13 @@ jobs:
146146
uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
147147

148148
- name: Read settings
149-
uses: microsoft/AL-Go-Actions/ReadSettings@v6.2
149+
uses: microsoft/AL-Go-Actions/ReadSettings@v6.3
150150
with:
151151
shell: powershell
152152
get: templateUrl
153153

154154
- name: Check for updates to AL-Go system files
155-
uses: microsoft/AL-Go-Actions/CheckForUpdates@v6.2
155+
uses: microsoft/AL-Go-Actions/CheckForUpdates@v6.3
156156
with:
157157
shell: powershell
158158
templateUrl: ${{ env.templateUrl }}
@@ -176,8 +176,6 @@ jobs:
176176
buildMode: ${{ matrix.buildMode }}
177177
projectDependenciesJson: ${{ needs.Initialization.outputs.projectDependenciesJson }}
178178
secrets: 'licenseFileUrl,codeSignCertificateUrl,*codeSignCertificatePassword,keyVaultCertificateUrl,*keyVaultCertificatePassword,keyVaultClientId,gitHubPackagesContext,applicationInsightsConnectionString'
179-
publishThisBuildArtifacts: ${{ needs.Initialization.outputs.workflowDepth > 1 }}
180-
publishArtifacts: ${{ github.ref_name == 'main' || startswith(github.ref_name, 'release/') || startswith(github.ref_name, 'releases/') || needs.Initialization.outputs.deliveryTargetsJson != '[]' || needs.Initialization.outputs.environmentCount > 0 }}
181179
signArtifacts: true
182180
useArtifactCache: true
183181

@@ -204,7 +202,7 @@ jobs:
204202
path: '.artifacts'
205203

206204
- name: Read settings
207-
uses: microsoft/AL-Go-Actions/ReadSettings@v6.2
205+
uses: microsoft/AL-Go-Actions/ReadSettings@v6.3
208206
with:
209207
shell: powershell
210208

@@ -213,7 +211,7 @@ jobs:
213211
uses: actions/configure-pages@983d7736d9b0ae728b81ab479565c72886d7745b # v5.0.0
214212

215213
- name: Build Reference Documentation
216-
uses: microsoft/AL-Go-Actions/BuildReferenceDocumentation@v6.2
214+
uses: microsoft/AL-Go-Actions/BuildReferenceDocumentation@v6.3
217215
with:
218216
shell: powershell
219217
artifacts: '.artifacts'
@@ -250,7 +248,7 @@ jobs:
250248
path: '.artifacts'
251249

252250
- name: Read settings
253-
uses: microsoft/AL-Go-Actions/ReadSettings@v6.2
251+
uses: microsoft/AL-Go-Actions/ReadSettings@v6.3
254252
with:
255253
shell: ${{ matrix.shell }}
256254
get: type,powerPlatformSolutionFolder
@@ -264,15 +262,15 @@ jobs:
264262
265263
- name: Read secrets
266264
id: ReadSecrets
267-
uses: microsoft/AL-Go-Actions/ReadSecrets@v6.2
265+
uses: microsoft/AL-Go-Actions/ReadSecrets@v6.3
268266
with:
269267
shell: ${{ matrix.shell }}
270268
gitHubSecrets: ${{ toJson(secrets) }}
271269
getSecrets: '${{ steps.envName.outputs.envName }}-AuthContext,${{ steps.envName.outputs.envName }}_AuthContext,AuthContext'
272270

273271
- name: Deploy to Business Central
274272
id: Deploy
275-
uses: microsoft/AL-Go-Actions/Deploy@v6.2
273+
uses: microsoft/AL-Go-Actions/Deploy@v6.3
276274
env:
277275
Secrets: '${{ steps.ReadSecrets.outputs.Secrets }}'
278276
with:
@@ -284,7 +282,7 @@ jobs:
284282

285283
- name: Deploy to Power Platform
286284
if: env.type == 'PTE' && env.powerPlatformSolutionFolder != ''
287-
uses: microsoft/AL-Go-Actions/DeployPowerPlatform@v6.2
285+
uses: microsoft/AL-Go-Actions/DeployPowerPlatform@v6.3
288286
env:
289287
Secrets: '${{ steps.ReadSecrets.outputs.Secrets }}'
290288
with:
@@ -312,20 +310,20 @@ jobs:
312310
path: '.artifacts'
313311

314312
- name: Read settings
315-
uses: microsoft/AL-Go-Actions/ReadSettings@v6.2
313+
uses: microsoft/AL-Go-Actions/ReadSettings@v6.3
316314
with:
317315
shell: powershell
318316

319317
- name: Read secrets
320318
id: ReadSecrets
321-
uses: microsoft/AL-Go-Actions/ReadSecrets@v6.2
319+
uses: microsoft/AL-Go-Actions/ReadSecrets@v6.3
322320
with:
323321
shell: powershell
324322
gitHubSecrets: ${{ toJson(secrets) }}
325323
getSecrets: '${{ matrix.deliveryTarget }}Context'
326324

327325
- name: Deliver
328-
uses: microsoft/AL-Go-Actions/Deliver@v6.2
326+
uses: microsoft/AL-Go-Actions/Deliver@v6.3
329327
env:
330328
Secrets: '${{ steps.ReadSecrets.outputs.Secrets }}'
331329
with:
@@ -345,7 +343,7 @@ jobs:
345343

346344
- name: Finalize the workflow
347345
id: PostProcess
348-
uses: microsoft/AL-Go-Actions/WorkflowPostProcess@v6.2
346+
uses: microsoft/AL-Go-Actions/WorkflowPostProcess@v6.3
349347
env:
350348
GITHUB_TOKEN: ${{ github.token }}
351349
with:

0 commit comments

Comments
 (0)