ObjectHandling/Import-TestToolkitToNavContainer.ps1

<#
 .Synopsis
  Import TestToolkit to BC Container
 .Description
  Import the objects from the TestToolkit to the BC Container.
  The TestToolkit objects are already in a folder on the NAV on Docker image from version 0.0.4.3
 .Parameter containerName
  Name of the container for which you want to enter a session
 .Parameter sqlCredential
  For 14.x containers and earlier. Credentials for the SQL admin user if using NavUserPassword authentication. User will be prompted if not provided
 .Parameter credential
  For 15.x containers and later. Credentials for the admin user if using NavUserPassword authentication. User will be prompted if not provided
 .Parameter includeTestLibrariesOnly
  Only import TestLibrary Apps (do not import Test Apps)
 .Parameter includeTestFrameworkOnly
  Only import TestFramework Apps (do not import Test Apps or Test Library apps)
 .Parameter includeTestRunnerOnly
  Only import Test Runner (do not import Test Apps, Test Framework Apps or Test Library apps)
 .Parameter testToolkitCountry
  Only import TestToolkit objects for a specific country.
  You must specify the country code that is used in the TestToolkit object name (e.g. CA, US, MX, etc.).
  This parameter only needs to be used in the event there are multiple country-specific sets of objects in the TestToolkit folder.
 .Parameter doNotUpdateSymbols
  Add this switch to avoid updating symbols when importing the test toolkit
 .Parameter ImportAction
  Specifies the import action. Default is Overwrite
 .Parameter scope
  Specify Global or Tenant based on how you want to publish the package. Default is Global
 .Parameter tenant
  Tenant in which you want to install the test framework (default is default)
 .Parameter useDevEndpoint
  Specify the useDevEndpoint switch if you want to publish using the Dev Endpoint (like VS Code). This allows VS Code to re-publish.
 .Parameter doNotUseRuntimePackages
  Include the doNotUseRuntimePackages switch if you do not want to cache and use the test apps as runtime packages (only 15.x containers)
 .Parameter replaceDependencies
  With this parameter, you can specify a hashtable, describring that the specified dependencies in the apps being published should be replaced
 .Parameter bcAuthContext
  Authorization Context created by New-BcAuthContext. By specifying BcAuthContext and environment, the function will import test toolkit to the online Business Central Environment specified
  Only Test Runner and Test Framework are/will be available in the online Business Central environment
 .Parameter environment
  Environment in which you want to import test toolkit.
 .Example
  Import-TestToolkitToBcContainer -containerName test2
  .Example
  Import-TestToolkitToBcContainer -containerName test2 -testToolkitCountry US
  .Example
  Import-TestToolkitToBcContainer -containerName test2 -includeTestLibrariesOnly -replaceDependencies @{ "437dbf0e-84ff-417a-965d-ed2bb9650972" = @{ "id" = "88b7902e-1655-4e7b-812e-ee9f0667b01b"; "name" = "MyBaseApp"; "publisher" = "Freddy Kristiansen"; "minversion" = "1.0.0.0" }}
#>

function Import-TestToolkitToBcContainer {
    Param (
        [string] $containerName = $bcContainerHelperConfig.defaultContainerName,
        [PSCredential] $sqlCredential = $null,
        [PSCredential] $credential = $null,
        [switch] $includeTestLibrariesOnly,
        [switch] $includeTestFrameworkOnly,
        [switch] $includeTestRunnerOnly,
        [switch] $includePerformanceToolkit,
        [string] $testToolkitCountry,
        [switch] $doNotUpdateSymbols,
        [ValidateSet("Overwrite","Skip")]
        [string] $ImportAction = "Overwrite",
        [switch] $doNotUseRuntimePackages,
        [Parameter(Mandatory=$false)]
        [ValidateSet('Global','Tenant')]
        [string] $scope,
        [string] $tenant = "default",
        [switch] $useDevEndpoint,
        [hashtable] $replaceDependencies = $null,
        [Hashtable] $bcAuthContext,
        [string] $environment

    )

$telemetryScope = InitTelemetryScope `
                    -name $MyInvocation.InvocationName `
                    -parameterValues $PSBoundParameters `
                    -includeParameters @("containerName","includeTestLibrariesOnly","includeTestFrameworkOnly","includeTestRunnerOnly","includePerformanceToolkit","testToolkitCountry")
try {

    if ($replaceDependencies) {
        $doNotUseRuntimePackages = $true
    }
    if (!($scope)) {
        if ($useDevEndpoint) {
            $scope = "tenant"
        }
        else {
            $scope = "global"
        }
    }

    $inspect = docker inspect $containerName | ConvertFrom-Json
    if ($inspect.Config.Labels.psobject.Properties.Match('maintainer').Count -eq 0 -or $inspect.Config.Labels.maintainer -ne "Dynamics SMB") {
        throw "Container $containerName is not a Business Central container"
    }
    [System.Version]$version = $inspect.Config.Labels.version
    $country = $inspect.Config.Labels.country

    $isBcSandbox = $inspect.Config.Env | Where-Object { $_ -eq "IsBcSandbox=Y" }

    $customConfig = Get-BcContainerServerConfiguration -ContainerName $containerName

    if ($bcAuthContext -and $environment) {
        
        $appFiles = GetTestToolkitApps -containerName $containerName -includeTestRunnerOnly:$includeTestRunnerOnly -includeTestFrameworkOnly:$includeTestFrameworkOnly -includeTestLibrariesOnly:$includeTestLibrariesOnly -includePerformanceToolkit:$includePerformanceToolkit
        $appFiles | % {
            $appInfo = Invoke-ScriptInBCContainer -containerName $containerName -scriptblock { Param($appFile)
                Get-NAVAppInfo -Path $appFile
            } -argumentList $_ | Where-Object { $_ -isnot [System.String] }

            $targetVersion = ""
            if ($appInfo.Version.Major -eq 18 -and $appInfo.Version.Minor -eq 0) {
                $targetVersion = "18.0.23013.23913"
            }
            Install-BcAppFromAppSource -bcAuthContext $bcauthcontext -environment $environment -appId $appInfo.AppId -appVersion $targetVersion -acceptIsvEula -installOrUpdateNeededDependencies
        }
        Write-Host -ForegroundColor Green "TestToolkit successfully published"
    }
    else {
        $doNotUpdateSymbols = $doNotUpdateSymbols -or (!(([bool]($customConfig.PSobject.Properties.name -eq "EnableSymbolLoadingAtServerStartup")) -and $customConfig.EnableSymbolLoadingAtServerStartup -eq "True"))
    
        $generateSymbols = $false
        if ($version.Major -eq 14 -and !$doNotUpdateSymbols -and $customConfig.ClientServicesCredentialType -ne "Windows") {
            $generateSymbols = $true
            $doNotUpdateSymbols = $true
        }
    
    
        if ($version.Major -ge 15) {
            if ($version -lt [Version]("15.0.35528.0")) {
                throw "Container $containerName (platform version $version) doesn't support the Test Toolkit yet, you need a laster version"
            }
    
            Invoke-ScriptInBcContainer -containerName $containerName -scriptblock {
                $mockAssembliesPath = "C:\Test Assemblies\Mock Assemblies"
                if (Test-Path $mockAssembliesPath) {
                    $serviceTierAddInsFolder = (Get-Item "C:\Program Files\Microsoft Dynamics NAV\*\Service\Add-ins").FullName
                    if (!(Test-Path (Join-Path $serviceTierAddInsFolder "Mock Assemblies"))) {
                        new-item -itemtype symboliclink -path $serviceTierAddInsFolder -name "Mock Assemblies" -value $mockAssembliesPath | Out-Null
                        Set-NavServerInstance $serverInstance -restart
                        while (Get-NavTenant $serverInstance | Where-Object { $_.State -eq "Mounting" }) {
                            Start-Sleep -Seconds 1
                        }
                    }
                }
            }
    
            $appFiles = GetTestToolkitApps -containerName $containerName -includeTestRunnerOnly:$includeTestRunnerOnly -includeTestFrameworkOnly:$includeTestFrameworkOnly -includeTestLibrariesOnly:$includeTestLibrariesOnly -includePerformanceToolkit:$includePerformanceToolkit
    
            if (!$doNotUseRuntimePackages) {
                if ($isBcSandbox) {
                    $folderPrefix = "sandbox"
                }
                else {
                    $folderPrefix = "onprem"
                }
                $applicationsPath = Join-Path $extensionsFolder "$folderPrefix-Applications-$Version-$country"
                if (!(Test-Path $applicationsPath)) {
                    New-Item -Path $applicationsPath -ItemType Directory | Out-Null
                }
            }
    
            $appFiles | % {
                $appFile = $_
                if (!$doNotUseRuntimePackages) {
                    $name = [System.IO.Path]::GetFileName($appFile)
                    $runtimeAppFile = "$applicationsPath\$($name.Replace('.app','.runtime.app'))"
                    $useRuntimeApp = $false
                    if (Test-Path $runtimeAppFile) {
                        if ((Get-Item $runtimeAppFile).Length -eq 0) {
                            Remove-Item $runtimeAppFile -force
                        }
                        else {
                            $appFile = $runtimeAppFile
                            $useRuntimeApp = $true
                        }
                    }
                }
    
                $tenantAppInfo = Invoke-ScriptInBCContainer -containerName $containerName -scriptblock { Param($appFile, $tenant)
                    $navAppInfo = Get-NAVAppInfo -Path $appFile
                    (Get-NAVAppInfo -ServerInstance $serverInstance -Name $navAppInfo.Name -Publisher $navAppInfo.Publisher -Version $navAppInfo.Version -tenant $tenant -tenantSpecificProperties)
                } -argumentList $appFile, $tenant | Where-Object { $_ -isnot [System.String] }
    
                if ($tenantAppInfo) {
                    if ($tenantAppInfo.IsInstalled) {
                        Write-Host "Skipping app '$appFile' as it is already installed"
                    }
                    else {
                        Sync-BcContainerApp -containerName $containerName -tenant $tenant -appName $tenantAppInfo.Name -appPublisher $tenantAppInfo.Publisher -appVersion $tenantAppInfo.Version -Force
                        Install-BcContainerApp -containerName $containerName -tenant $tenant -appName $tenantAppInfo.Name -appPublisher $tenantAppInfo.Publisher -appVersion $tenantAppInfo.Version -Force
                    }
                }
                else {
                    Publish-BcContainerApp -containerName $containerName -appFile ":$appFile" -skipVerification -sync -install -scope $scope -useDevEndpoint:$useDevEndpoint -replaceDependencies $replaceDependencies -credential $credential -tenant $tenant
        
                    if (!$doNotUseRuntimePackages -and !$useRuntimeApp) {
                        Invoke-ScriptInBCContainer -containerName $containerName -scriptblock { Param($appFile, $runtimeAppFile)
                            
                            $navAppInfo = Get-NAVAppInfo -Path $appFile
                            $appPublisher = $navAppInfo.Publisher
                            $appName = $navAppInfo.Name
                            $appVersion = $navAppInfo.Version
        
                            Get-NavAppRuntimePackage -ServerInstance $serverInstance -Publisher $appPublisher -Name $appName -version $appVersion -Path $runtimeAppFile -Tenant default
                        } -argumentList $appFile, (Get-BcContainerPath -containerName $containerName -path $runtimeAppFile -throw)
                    }
                }
            }
            Write-Host -ForegroundColor Green "TestToolkit successfully imported"
        }
        else {
            $sqlCredential = Get-DefaultSqlCredential -containerName $containerName -sqlCredential $sqlCredential -doNotAskForCredential
            Invoke-ScriptInBcContainer -containerName $containerName -ScriptBlock { Param([PSCredential]$sqlCredential, $includeTestLibrariesOnly, $testToolkitCountry, $doNotUpdateSymbols, $ImportAction)
            
                $customConfigFile = Join-Path (Get-Item "C:\Program Files\Microsoft Dynamics NAV\*\Service").FullName "CustomSettings.config"
                [xml]$customConfig = [System.IO.File]::ReadAllText($customConfigFile)
                $databaseServer = $customConfig.SelectSingleNode("//appSettings/add[@key='DatabaseServer']").Value
                $databaseInstance = $customConfig.SelectSingleNode("//appSettings/add[@key='DatabaseInstance']").Value
                $databaseName = $customConfig.SelectSingleNode("//appSettings/add[@key='DatabaseName']").Value
                $managementServicesPort = $customConfig.SelectSingleNode("//appSettings/add[@key='ManagementServicesPort']").Value
                if ($databaseInstance) { $databaseServer += "\$databaseInstance" }
           
                $params = @{}
                if ($sqlCredential) {
                    $params = @{ 'Username' = $sqlCredential.UserName; 'Password' = ([System.Runtime.InteropServices.Marshal]::PtrToStringAuto([System.Runtime.InteropServices.Marshal]::SecureStringToBSTR($sqlCredential.Password))) }
                }
                if ($testToolkitCountry) {
                    $fileFilter = "*.$testToolkitCountry.fob"
                }
                else {
                    $fileFilter = "*.fob"
                }
                Get-ChildItem -Path "C:\TestToolKit" -Filter $fileFilter | ForEach-Object { 
                    if (!$includeTestLibrariesOnly -or $_.Name.StartsWith("CALTestLibraries")) {
                        $objectsFile = $_.FullName
                        Write-Host "Importing Objects from $objectsFile (container path)"
                        $databaseServerParameter = $databaseServer
        
                        if (!$doNotUpdateSymbols) {
                            Write-Host "Generating Symbols while importing"
                            # HACK: Parameter insertion...
                            # generatesymbolreference is not supported by Import-NAVApplicationObject yet
                            # insert an extra parameter for the finsql command by splitting the filter property
                            $databaseServerParameter = '",generatesymbolreference=1,ServerName="'+$databaseServer
                        }
            
                        Import-NAVApplicationObject @params -Path $objectsFile `
                                                    -DatabaseName $databaseName `
                                                    -DatabaseServer $databaseServerParameter `
                                                    -ImportAction $ImportAction `
                                                    -SynchronizeSchemaChanges No `
                                                    -NavServerName localhost `
                                                    -NavServerInstance $ServerInstance `
                                                    -NavServerManagementPort "$managementServicesPort" `
                                                    -Confirm:$false
            
                    }
                }
        
                # Sync after all objects hav been imported
                Get-NAVTenant -ServerInstance $ServerInstance | Sync-NavTenant -Mode ForceSync -Force
        
            } -ArgumentList $sqlCredential, ($includeTestLibrariesOnly -or $includeTestFrameworkOnly), $testToolkitCountry, $doNotUpdateSymbols, $ImportAction
        
            if ($generateSymbols) {
                Write-Host "Generating symbols"
                Generate-SymbolsInNavContainer -containerName $containerName -sqlCredential $sqlCredential
            }
            Write-Host -ForegroundColor Green "TestToolkit successfully imported"
        }
    }
}
catch {
    TrackException -telemetryScope $telemetryScope -errorRecord $_
    throw
}
finally {
    TrackTrace -telemetryScope $telemetryScope
}
}
Set-Alias -Name Import-TestToolkitToNavContainer -Value Import-TestToolkitToBcContainer
Export-ModuleMember -Function Import-TestToolkitToBcContainer -Alias Import-TestToolkitToNavContainer