NVRAppDevOps

Author(s)

• Kamil Sacek

Functions

Add-FontsToBcContainer Add-GitToAlProjectFolder AddTelemetryProperty Backup-BcContainerDatabases Cancel-AppSourceSubmission Check-BcContainerHelperPermissions Clean-BcContainerDatabase Compile-AppInBcContainer Compile-AppWithBcCompilerFolder Compile-ObjectsInNavContainer Convert-AlcOutputToDevOps Convert-BcAppsToRuntimePackages Convert-ModifiedObjectsToAl ConvertTo-HashTable ConvertTo-OrderedDictionary Convert-Txt2Al Copy-AlSourceFiles Copy-AppFilesToCompilerFolder Copy-AppFilesToFolder Copy-BcEnvironment Copy-CompanyInBcContainer Copy-FileFromBcContainer Copy-FileToBcContainer Copy-ItemFromBcContainer Copy-ItemToBcContainer Create-AadAppsForNav Create-AadUsersInBcContainer Create-AlProjectFolderFromBcContainer Create-CustomTraefikImage Create-MyDeltaFolder Create-MyOriginalFolder Create-SymbolsFileFromAppFile Download-Artifacts Download-BcEnvironmentInstalledExtensionToFolder Download-BcNuGetPackageToFolder Download-File Enter-BcContainer Export-BcContainerDatabasesAsBacpac Export-ModifiedObjectsAsDeltas Export-NavContainerObjects Extract-AppFileToFolder Extract-FilesFromBcContainerImage Extract-FilesFromStoppedBcContainer Find-BcNuGetPackage Flush-ContainerHelperCache Generate-SymbolsInNavContainer Get-AlLanguageExtensionFromArtifacts Get-AppJsonFromAppFile Get-AppSourceProduct Get-AppSourceSubmission Get-AzureFeedWildcardVersion Get-BCArtifactUrl Get-BcContainerApiCompanyId Get-BcContainerApp Get-BcContainerAppInfo Get-BcContainerAppRuntimePackage Get-BcContainerArtifactUrl Get-BcContainerBcUser Get-BcContainerCountry Get-BcContainerDebugInfo Get-BcContainerEula Get-BcContainerEventLog Get-BcContainerGenericTag Get-BcContainerId Get-BcContainerImageLabels Get-BcContainerImageName Get-BcContainerImageTags Get-BcContainerIpAddress Get-BcContainerLegal Get-BcContainerLicenseInformation Get-BcContainerName Get-BcContainerNavVersion Get-BcContainerOsVersion Get-BcContainerPath Get-BcContainerPlatformVersion Get-BcContainers Get-BcContainerServerConfiguration Get-BcContainerSession Get-BcContainerSharedFolders Get-BcContainerTenants Get-BcEnvironmentAvailableRestorePeriods Get-BcEnvironmentDatabaseExportHistory Get-BcEnvironmentInstalledExtensions Get-BcEnvironmentOperations Get-BcEnvironmentPublishedApps Get-BcEnvironments Get-BcEnvironmentScheduledUpgrade Get-BcEnvironmentUpdateWindow Get-BcEnvironmentUsedStorage Get-BcNotificationRecipients Get-BcNuGetPackage Get-BcNuGetPackageId Get-BestBcContainerImageName Get-BestGenericImageName Get-CompanyInBcContainer Get-LatestAlLanguageExtensionUrl Get-LocaleFromCountry Get-NavArtifactUrl Get-NavVersionFromVersionInfo Get-PackageInfoFromRapidStartFile Get-PlainText Get-TestsFromBcContainer Import-BcContainerLicense Import-CertificateToBcContainer Import-ConfigPackageInBcContainer Import-DeltasToNavContainer Import-ObjectsToNavContainer Import-PfxCertificateToBcContainer Import-TestToolkitToBcContainer InitTelemetryScope Install-AzDevops Install-BcAppFromAppSource Install-BcContainerApp Install-NAVSipCryptoProviderFromBcContainer Invoke-BcContainerApi invoke-gh invoke-git Invoke-IngestionApiDelete Invoke-IngestionApiGet Invoke-IngestionApiGetCollection Invoke-IngestionApiPost Invoke-IngestionApiPut Invoke-NavContainerCodeunit Invoke-ScriptInBcContainer New-AadAppsForBc New-ALGoAppSourceContext New-ALGoAuthContext New-ALGoNugetContext New-ALGoRepo New-ALGoStorageContext New-AppSourceSubmission New-BcAuthContext New-BcCompilerFolder New-BcContainer New-BcContainerBcUser New-BcContainerTenant New-BcContainerWindowsUser New-BcContainerWizard New-BcEnvironment New-BcEnvironmentDatabaseExport New-BcImage New-BcNotificationRecipient New-BcNuGetPackage New-CompanyInBcContainer New-DesktopShortcut New-LetsEncryptCertificate Open-BcContainer Promote-AppSourceSubmission Publish-BcContainerApp Publish-BcNuGetPackageToContainer Publish-BuildOutputToAzureFeed Publish-BuildOutputToStorage Publish-NewApplicationToBcContainer Publish-PerTenantExtensionApps Push-BcNuGetPackage RegisterTelemetryScope Remove-AadAppsForBc Remove-BcCompilerFolder Remove-BcContainer Remove-BcContainerSession Remove-BcContainerTenant Remove-BcDatabase Remove-BcEnvironment Remove-CompanyInBcContainer Remove-ConfigPackageInBcContainer Remove-DesktopShortcut Rename-BcEnvironment Renew-BcAuthContext Renew-LetsEncryptCertificate Repair-BcContainerApp Replace-BcServerContainer Replace-DependenciesInAppFile Reschedule-BcEnvironmentUpgrade Resolve-DependenciesFromAzureFeed Restart-BcContainer Restart-BcContainerServiceTier Restore-BcDatabaseFromArtifacts Restore-BcEnvironment Restore-DatabasesInBcContainer Run-AlCops Run-AlPipeline Run-AlValidation Run-BCPTTestsInBcContainer Run-ConnectionTestToBcContainer Run-TestsInBcContainer Set-BcContainerFeatureKeys Set-BcContainerKeyVaultAadAppAndCertificate Set-BcContainerServerConfiguration Set-BcEnvironmentApplicationInsightsKey Set-BcEnvironmentUpdateWindow Setup-BcContainerTestUsers Setup-TraefikContainerForBcContainers Sign-BcContainerApp Sort-AppFilesByDependencies Sort-AppFoldersByDependencies Start-BcContainer Start-BcContainerAppDataUpgrade Stop-BcContainer Sync-BcContainerApp Test-BcContainer TrackException TrackTrace UnInstall-BcContainerApp UnPublish-BcContainerApp UploadImportAndApply-ConfigPackageInBcContainer Wait-BcContainerReady Wait-BcEnvironmentsReady Write-BcContainerHelperWelcomeText

Dependencies

This module has no dependencies.

Release Notes

2.8.7
- Removed RequiredModule for bccontianerhelper! Can have impact to the scripts. You need to import bccontainerhelper module by yourself if needed.

2.8.6
- Try to preserve file encoding when reading and writing settings.json file in Invoke-PaketForAl
- Enhance module path resolution by checking both "program files" and "PFiles64" or "pfiles" for different files in artifacts
- Fix path handling for locating ALLanguage.vsix in Get-ALCompilerFromArtifact function
- Refactor path handling for ALLanguage.vsix extraction
- Add Microsoft Shopify Connector app path to artifact import

2.8.5
- Add retry for running tests in Run-ALTestInContainer
- Fix bug in missing version for dependencies in Get-ALAppOrderByID and Get-ALAppOrder

2.8.4
- conditional mapping of the repository folder into the container
- accept_insiderEula parameter for New-BCContainer in Init-ALEnvironment
- add Sign-ALAppsAzure to sign apps with Azure KeyVault certificate
- add Install-SigningTool to install the signing tool
- If environment variable PaketExePath is set, use it for Paket execution
- Add Invoke-PaketForAl to run Paket commands for AL projects easilly

2.8.3
- BCv24 compilation support by adding the Microsoft Business Foundation.app into dependencies
- Long path support for NuGet cmdlets
- Add verbose output of paket.dependencies for better debugging
- Fix missing .app. management module in BCv24 Powershell 5 bridge

2.8.2
- Fix problems with Install-ALNugetPackage and Compile-ALProjectTree when packages were not installed

2.8.1
- Fix Download-ALApp when no dependencies to download

2.8.0
- Support for downloading NuGet packages with Unified naming for Download-ALApp, Download-ALAppFromNuget and Compile-ALProjectTree
- If $env:NVRAppDevOpsNugetFeedUrl is set to Azure DevOps MS feed with MS packages, the Format-AppNameForNuget will try to find the package name by ID. This is workaround for finding correct package names for e.g. Czech localization
apps having tag CZ even when they are build on W1.

2.7.1
- Fixing compatibility with BCv24 folder structure of the vsix/alc.exe (Issue #37, #38)            

2.7.0
- Fixing compatibility with BCv24 folder structure of the vsix/alc.exe (Issue #37, #38 and #39 - thanks @skmcavoy for reporting!)

2.6.7
- Fix Get-ALAppOrder infinite loop in case of cyclic dependencies (set to max 20 iterations)

2.6.6
- Fix bug when Install-ALNugetPackageByPaket with Ignore parameter doesn't work correctly (no app is copied to target folder)

2.6.2
- Fix error " Method invocation failed because [System.Int32] does not contain a method named 'Contains'" in Install-ALNugetPackageByPaket.ps1

2.5.0
- Added ConvertTo-PaketDependencies script to convert App.json dependencies into paket.dependencies file to be able to download symbols/apps through Paket CLI (https://fsprojects.github.io/Paket/)
- Added parameters UnifiedNaming and DependencyTag into New-ALNuSpec to be able to use unified naming for the dependencies and the package as it will be used by Microsoft
- Added New-ALNuSpecForAppFile to create nuspec file for app file
- Added Format-AppNameForNuget to format app name for NuGet package name based on Unified naming rules

2.4.0
- Removed custom parameter '-e CustomNavSettings=ServicesUseNTLMAuthentication=true' when initializing environment. If needed, add it as optionalParameters. This parameter makes problems on BCv22.5 and newer ("There was no endpoint listening at http://localhost:7086/BC/ManagementServicePs/Service.svc that could accept the message. This is often caused by an incorrect address or SOAP action. See InnerException, if present, for more details."))

2.3.0
- Add support for new alc.exe parameters SourceRepositoryUrl, SourceCommit, BuildBy and BuildUrl
           
2.2.0
- Add Install-ALNugetPackageByPaket to install nuget package by Paket manager. Paket have better dependency resolving than nuget.exe

2.1.0
- Add IncludeBaseApp switch into New-ALNuSpec to include microsoft Application into dependencies (preview, to be able to select package based on MS application version dependency)

2.0.44
- Fixed issue #34 - rulesetfile parameter bug in Compile-AppWithArtifact.ps1 (thanks @skmcavoy)

2.0.43
- Fixed support for v21 and older management script location in Get-BCModulePathFromArtifact

2.0.42
- Add support for v22 management script location in Get-BCModulePathFromArtifact
       
2.0.41
- Format-AppNameForNuget now replace / character

2.0.40
- Fixing regular expression for replacing () characters
       
2.0.39
- Format-AppNameForNuget now replace even () characters
       
2.0.38
- Update lastused on the artifact when module is imported from it

2.0.36
- Replace & i nuget package with _

2.0.35
- Add Escaping of special chars in New-ALNuSpec

2.0.34
- Install-ALNugetPackage HighestMinor for x.y.z.0 will search for x.y.*.* instead x.*.*.*
       
2.0.33
- Install-ALNugetPackage Lowest and HighestMinor search bugfix

2.0.32
- Install-ALNugetPackage ExactVersion filter bugfix

2.0.31
- Install-ALNugetPackage ExactVersion switch to prevent applying DependencyVersion for the main package

2.0.19
- Get-ALAppOrder gets the highest dependency version if multiple dependencies on same app

2.0.15
- Install-ALNugetPackage versionmode Lowest now search for lowest version which is higher or equal to requested version (e.g. requeted 1.2.0.0 will take 1.2.123.0 if lowest)

2.0.14
- Add Upload-FileToShp function for uploading file to sharepoint
       
2.0.10
- Fixing Microsoft dependencies when sandbox artifact used in Compile-AppWithArtifact.ps1 (localization apps not found bug)

2.0.7
- Add Compile-AppWithArtifact, Get-ALCompileFromArtifact and parameter artifactUrl into Compile-ALProjectTree and Get-ALAppOrder to
 support compilation without container

2.0.6
- Add Get-BCModulePathFromArtifact
       
2.0.5
- Fixed way how the SQL libraries are loaded. You need to install SqlServer PS Module (Install-module SqlServer)

2.0.3
- Add support for SQL libraries needed for database manipulation cmdlets as part of Import-BCModulesFromArtifacts

2.0.2
- Add Import-BCModulesFromArtifacts

2.0.0
- Changed dependency on bccontainerhelper
- Add parameter DependencyVersion parameter to Download-ALAppFromNuget
- If LatestMinor used, list the available versions and select the corect version based on Major
- do not download Microsoft apps through download script when compiling
- Add IncludeAppFiles switch to Get-ALAppOrder

1.1.8
- Add Get-BatchWI to get multiple WIs in one call

1.1.7
- Add Expand parameter to Get-WI

1.1.1-1.1.5
- ArtifactUrl support - see https://freddysblog.com/
- Get-WI double api-version bug fix