BcContainerHelper

6.1.14-preview2353289

Saas/Publish-PerTenantExtensionApps.ps1

                                <# 

 .Synopsis

  Function for publishing PTE apps to an online tenant

 .Description

  Function for publishing PTE apps to an online tenant

  Please consult the CI/CD Workshop document at http://aka.ms/cicdhol to learn more about this function

 .Parameter clientId

  ClientID of Azure AD App for authenticating to Business Central (SecureString or String)

 .Parameter clientSecret

  ClientSecret of Azure AD App for authenticating to Business Central (SecureString or String)

 .Parameter tenantId

  TenantId of tenant in which you want to publish the Per Tenant Extension Apps

 .Parameter environment

  Name of the environment inside the tenant in which you want to publish the Per Tenant Extension Apps

 .Parameter companyName

  Company Name in which the Azure AD App is registered

 .Parameter appFiles

  Array or comma separated string of apps or .zip files containing apps, which needs to be published

  The apps will be sorted by dependencies and published+installed

 .Parameter useNewLine

  Add this switch to add a newline to progress indicating periods during wait.

  Azure DevOps doesn't update logs until a newline is added.

 .Parameter hideInstalledExtensionsOutput

  Add this parameter to hide the output that lists installed extensions on the specified environment before and after installation of new and updated PTE extensions.

 .Parameter unpublishPreviousVersions

  Add this switch to unpublish previous versions of apps after upgrading to a new version.

#>

function Publish-PerTenantExtensionApps {

    [CmdletBinding(DefaultParameterSetName="AC")]

    Param(

        [Parameter(Mandatory=$true, ParameterSetName="CC")]

        $clientId,

        [Parameter(Mandatory=$true, ParameterSetName="CC")]

        $clientSecret,

        [Parameter(Mandatory=$true, ParameterSetName="CC")]

        [string] $tenantId,

        [Parameter(Mandatory=$true, ParameterSetName="AC")]

        [Hashtable] $bcAuthContext,

        [Parameter(Mandatory=$true)]

        [string] $environment,

        [Parameter(Mandatory=$false)]

        [string] $companyName,

        [Parameter(Mandatory=$true)]

        $appFiles,

        [ValidateSet('Add','Force')]

        [string] $schemaSyncMode = 'Add',

        [ValidateSet('','Current version','Next minor version','Next major version')]

        [string] $schedule = '',

        [switch] $useNewLine,

        [switch] $hideInstalledExtensionsOutput,

        [switch] $unpublishPreviousVersions

    )

$telemetryScope = InitTelemetryScope -name $MyInvocation.InvocationName -parameterValues $PSBoundParameters -includeParameters @()

try {

    function GetAuthHeaders {

        $script:authContext = Renew-BcAuthContext -bcAuthContext $script:authContext

        return @{ "Authorization" = "Bearer $($script:authContext.AccessToken)" }

    }

    $newLine = @{}

    if (!$useNewLine) {

        $newLine = @{ "NoNewLine" = $true }

    }

    if ($PsCmdlet.ParameterSetName -eq "CC") {

        if ($clientId -is [SecureString]) { $clientID = [System.Runtime.InteropServices.Marshal]::PtrToStringBSTR([System.Runtime.InteropServices.Marshal]::SecureStringToBSTR($clientID)) }

        if ($clientId -isnot [String]) { throw "ClientID needs to be a SecureString or a String" }

        if ($clientSecret -is [String]) { $clientSecret = ConvertTo-SecureString -String $clientSecret -AsPlainText -Force }

        if ($clientSecret -isnot [SecureString]) { throw "ClientSecret needs to be a SecureString or a String" }

        $script:authContext = New-BcAuthContext `

            -clientID $clientID `

            -clientSecret $clientSecret `

            -tenantID $tenantId `

            -scopes "https://api.businesscentral.dynamics.com/.default"

        if (-not ($script:AuthContext)) {

            throw "Authentication failed"

        }

    }

    else {

        $script:authContext = Renew-BcAuthContext -bcAuthContext $bcAuthContext

    }

    $appFolder = Join-Path ([System.IO.Path]::GetTempPath()) ([guid]::NewGuid().ToString())

    try {

        $appFiles = CopyAppFilesToFolder -appFiles $appFiles -folder $appFolder

        $automationApiUrl = "$($bcContainerHelperConfig.apiBaseUrl.TrimEnd('/'))/v2.0/$environment/api/microsoft/automation/v2.0"

        Write-Host "$automationApiUrl/companies"

        $companies = Invoke-RestMethod -Headers (GetAuthHeaders) -Method Get -Uri "$automationApiUrl/companies" -UseBasicParsing

        $company = $companies.value | Where-Object { ($companyName -eq "") -or ($_.name -eq $companyName) } | Select-Object -First 1

        if (!($company)) {

            throw "No company $companyName"

        }

        $companyId = $company.id

        if ($companyName -eq "") {

            $companyName = $company.name

        }

        Write-Host "Company '$companyName' has id $companyId"

        Write-Host "$automationApiUrl/companies($companyId)/extensions"

        $getExtensions = Invoke-WebRequest -Headers (GetAuthHeaders) -Method Get -Uri "$automationApiUrl/companies($companyId)/extensions" -UseBasicParsing

        $extensions = (ConvertFrom-Json $getExtensions.Content).value | Sort-Object -Property DisplayName

        if(!$hideInstalledExtensionsOutput) {

            Write-Host "Extensions before:"

            $extensions | ForEach-Object { Write-Host " - $($_.DisplayName), Version $($_.versionMajor).$($_.versionMinor).$($_.versionBuild).$($_.versionRevision), Installed=$($_.isInstalled)" }

            Write-Host

        }

        $body = @{"schedule" = "Current Version"}

        $appDep = $extensions | Where-Object { $_.DisplayName -eq 'Application' }

        $appDepVer = [System.Version]"$($appDep.versionMajor).$($appDep.versionMinor).$($appDep.versionBuild).$($appDep.versionRevision)"

        if ($appDepVer -ge [System.Version]"21.2.0.0") {

            if ($schemaSyncMode -eq 'Force') {

                $body."SchemaSyncMode" = "Force Sync"

            }

            else {

                $body."SchemaSyncMode" = "Add"

            }

        }

        else {

            if ($schemaSyncMode -eq 'Force') {

                throw 'SchemaSyncMode Force is not supported before version 21.2'

            }

        }

        if($schedule) {

            $body."schedule" = $schedule

        }

        $ifMatchHeader = @{ "If-Match" = '*'}

        $jsonHeader = @{ "Content-Type" = 'application/json'}

        $streamHeader = @{ "Content-Type" = 'application/octet-stream'}

        try {

            Sort-AppFilesByDependencies -appFiles $appFiles -excludeRuntimePackages | ForEach-Object {

                $appFile = $_

                Write-Host @newline "$([System.IO.Path]::GetFileName($appFile)) - "

                $appJson = Get-AppJsonFromAppFile -appFile $appFile

                $previousApp = $null

                $existingApp = $extensions | Where-Object { $_.id -eq $appJson.id -and $_.isInstalled }

                if ($existingApp) {

                    if ($existingApp.isInstalled) {

                        $existingVersion = [System.Version]"$($existingApp.versionMajor).$($existingApp.versionMinor).$($existingApp.versionBuild).$($existingApp.versionRevision)"

                        if ($existingVersion -ge $appJson.version) {

                            Write-Host "already installed"

                        }

                        else {

                            Write-Host @newLine "upgrading"

                            $previousApp = $existingApp

                            $existingApp = $null

                        }

                    }

                    else {

                        Write-Host @newLine "installing"

                        $existingApp = $null

                    }

                }

                else {

                    Write-Host @newLine "publishing and installing"

                }

                if (!$existingApp) {

                    $extensionUpload = (Invoke-RestMethod -Method Get -Uri "$automationApiUrl/companies($companyId)/extensionUpload" -Headers (GetAuthHeaders)).value

                    Write-Host @newLine "."

                    if ($extensionUpload -and $extensionUpload.systemId) {

                        $extensionUpload = Invoke-RestMethod `

                            -Method Patch `

                            -Uri "$automationApiUrl/companies($companyId)/extensionUpload($($extensionUpload.systemId))" `

                            -Headers ((GetAuthHeaders) + $ifMatchHeader + $jsonHeader) `

                            -Body ($body | ConvertTo-Json -Compress)

                    }

                    else {

                        $ExtensionUpload = Invoke-RestMethod `

                            -Method Post `

                            -Uri "$automationApiUrl/companies($companyId)/extensionUpload" `

                            -Headers ((GetAuthHeaders) + $jsonHeader) `

                            -Body ($body | ConvertTo-Json -Compress)

                    }

                    Write-Host @newLine "."

                    if ($null -eq $extensionUpload.systemId) {

                        throw "Unable to upload extension"

                    }

                    # Use stream instead of reading the entire file into memory

                    $fileStream = [System.IO.File]::OpenRead($appFile)

                    Invoke-RestMethod `

                        -Method Patch `

                        -Uri $extensionUpload.'extensionContent@odata.mediaEditLink' `

                        -Headers ((GetAuthHeaders) + $ifMatchHeader + $streamHeader) `

                        -Body $fileStream | Out-Null

                    $fileStream.Close()

                    Write-Host @newLine "."

                    Invoke-RestMethod `

                        -Method Post `

                        -Uri "$automationApiUrl/companies($companyId)/extensionUpload($($extensionUpload.systemId))/Microsoft.NAV.upload" `

                        -Headers ((GetAuthHeaders) + $ifMatchHeader) `

                        -ErrorAction SilentlyContinue | Out-Null

                    Write-Host @newLine "."    

                    $completed = $false

                    $errCount = 0

                    $sleepSeconds = 30

                    $lastStatus = ''

                    while (!$completed)

                    {

                        Start-Sleep -Seconds $sleepSeconds

                        try {

                            $extensionDeploymentStatusResponse = Invoke-WebRequest -Headers (GetAuthHeaders) -Method Get -Uri "$automationApiUrl/companies($companyId)/extensionDeploymentStatus" -UseBasicParsing

                            $extensionDeploymentStatuses = (ConvertFrom-Json $extensionDeploymentStatusResponse.Content).value

                            $thisExtension = $extensionDeploymentStatuses | Where-Object { $_.publisher -eq $appJson.publisher -and $_.name -eq $appJson.name -and $_.appVersion -eq $appJson.version }

                            if ($null -eq $thisExtension) {

                                throw "Unable to find extension deployment status"

                            } 

                            $thisExtension | ForEach-Object {

                                if ($_.status -ne $lastStatus) {

                                    if (!$useNewLine) { Write-Host }

                                    Write-Host @newLine $_.status

                                    $lastStatus = $_.status

                                }

                                if ($_.status -eq "InProgress") {

                                    $errCount = 0

                                    $sleepSeconds = 5

                                    Write-Host @newLine "."

                                }

                                elseif ($_.Status -eq "Unknown") {

                                    throw "Unknown Error"

                                }

                                elseif ($_.Status -eq "Completed") {

                                    if (!$useNewLine) { Write-Host }

                                    $completed = $true

                                }

                                else {

                                    $errCount = 5

                                    throw $_.status

                                }

                            }

                        }

                        catch {

                            if (!$useNewLine) { Write-Host }

                            if ($errCount++ -gt 4) {

                                Write-Host $_.Exception.Message

                                throw "Unable to publish app. Please open the Extension Deployment Status Details page in Business Central to see the detailed error message."

                            }

                            $sleepSeconds += $sleepSeconds

                            Write-Host "Error: $($_.Exception.Message). Retrying in $sleepSeconds seconds"

                        }

                    }

                    if ($unpublishPreviousVersions -and $previousApp -and ($appDepVer -ge [System.Version]"25.4.0.0")) { # New unpublish API available from 25.4

                        Write-Host @newLine "Unpublishing previous version"

                        Invoke-RestMethod `

                            -Method Post `

                            -Uri "$automationApiUrl/companies($companyId)/extensions($($previousApp.packageId))/Microsoft.NAV.unpublish" `

                            -Headers (GetAuthHeaders) | Out-Null

                    }

                }

            }

        }

        catch [System.Net.WebException],[System.Net.Http.HttpRequestException] {

            if (!$useNewLine) { Write-Host }

            Write-Host "ERROR $($_.Exception.Message)"

            Write-Host $_.ScriptStackTrace

            throw (GetExtendedErrorMessage $_)

        }

        catch {

            if (!$useNewLine) { Write-Host }

            Write-Host "ERROR: $($_.Exception.Message) [$($_.Exception.GetType().FullName)]"

            throw

        }

        finally {

            $getExtensions = Invoke-WebRequest -Headers (GetAuthHeaders) -Method Get -Uri "$automationApiUrl/companies($companyId)/extensions" -UseBasicParsing

            $extensions = (ConvertFrom-Json $getExtensions.Content).value | Sort-Object -Property DisplayName

            if (!$hideInstalledExtensionsOutput) {

                Write-Host

                Write-Host "Extensions after:"

                $extensions | ForEach-Object { Write-Host " - $($_.DisplayName), Version $($_.versionMajor).$($_.versionMinor).$($_.versionBuild).$($_.versionRevision), Installed=$($_.isInstalled)" }

            }

        }

    }

    catch [System.Net.WebException],[System.Net.Http.HttpRequestException] {

        Write-Host "ERROR $($_.Exception.Message)"

        throw (GetExtendedErrorMessage $_)

    }

    finally {

        if (Test-Path $appFolder) {

            Remove-Item $appFolder -Recurse -Force -ErrorAction SilentlyContinue

        }

    }

}

catch {

    TrackException -telemetryScope $telemetryScope -errorRecord $_

    throw

}

finally {

    $script:authContext = $null

    TrackTrace -telemetryScope $telemetryScope

}

}

Export-ModuleMember -Function Publish-PerTenantExtensionApps

# SIG # Begin signature block

# MIIncQYJKoZIhvcNAQcCoIInYjCCJ14CAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBWCWINe1jT9ccY

# kzwzQ4QQ9o29ZgLDb1zQSw9D7Xym/KCCDMkwggYEMIID7KADAgECAhMzAAACHPrN

# xZvoL37EAAAAAAIcMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAlVTMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBD

# b2RlIFNpZ25pbmcgUENBIDIwMjQwHhcNMjYwNDE2MTg1OTQxWhcNMjcwNDE1MTg1

# OTQxWjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYD

# VQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IB

# DwAwggEKAoIBAQDVsZfgOKmM31HPfoWOoNEiw0SlCiIxUMC0I9NMWbucKOw/e9lP

# oAoehQVu6SG65V4EPzrYsnBnFPNoi4/HoOdjhz1qkrEt4I6tEcxXU6oOeY9zGveC

# /3iBeuhLYxM3M/PkcUoebF+Nednm8OkdSPoDu8imViHPQq/8CQUu0WRR4rE+dMRf

# rpVqfmNi2qWCX94T4MsepijGVkwE//tJg0ryAiYdHT34LSnlG/RSBZmQRGWZ5g8j

# qnKjRParSqMft1gvjuUTVgtWNZfgcLFSK5Wa0myrq8OPcgTGGsRgun+tnSS+IxDT

# xVsAPH1OzvPjwomguByhUe/OcvUN0D5Wmp7xAgMBAAGjggGqMIIBpjAOBgNVHQ8B

# Af8EBAMCB4AwHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0O

# BBYEFNoH7a2YDjOSwpkp6DHcmUS7J+0yMFQGA1UdEQRNMEukSTBHMS0wKwYDVQQL

# EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxFjAUBgNVBAUT

# DTIzMDAxMis1MDc1NjkwHwYDVR0jBBgwFoAUf1k/VCHarU/vBeXmo9ctBpQSCDEw

# YAYDVR0fBFkwVzBVoFOgUYZPaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9w

# cy9jcmwvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNy

# bDBtBggrBgEFBQcBAQRhMF8wXQYIKwYBBQUHMAKGUWh0dHA6Ly93d3cubWljcm9z

# b2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmcl

# MjBQQ0ElMjAyMDI0LmNydDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4IC

# AQAUnEqhaRXe0T3hIJjvdQErEkrA/7bByjn6t5IArODkkRjzkYwtKMc2yYj2quaN

# rLutWw2YZcngKPy1b71YyDJQTy4NDRwaSh9Tw5thrk3NmcPrAHia5vtcBJ1CgtKK

# 7mQbIcQ22d/N3813ayCDDFewu1+jsZmX+r/aTEqaOM4TVxVtRSkuCy8nAXKuChOK

# Li/zA4XuH8iEYqIsj2YoNaeSxVmeGiERXpKdo3dDmYi0kO5w2D8VS4c3+9h6gElY

# BaAAg/dYErBg27qT3vv0zRDJhJufvCNylA8S7/+8H5E/PV5cng6na9VV/w9OV3qu

# uND6zdGa2EX38Glp50F9AIQk3p2xXmcvorDeM4XJ7UlWYBi6g80J1SSOQnInCYFE

# msfUNn3+1AaTJKSJL83quKArTac2pKhu0Yzzzrzo6HrsRiQKzpnRBb1/dMa6P3hz

# 75XbMRBctNsFhZC07WCmjExdLg2eHW5uV0TY8D5+6wozJf7vF3+WHkYPO85Z+BC6

# U4FkNbYNycZ9cE4j1tXRdyDCfml6c0HWPHjNVDObrv9lKt3qUqFpX38VCqVCyNOO

# 1UcXfQiVjJw32U2WUKZjt/neJKHEBsm9kFsLuWzkQ53+qcaSaytmsCnk2gOglrlD

# 5d3kKyvvAw+rzm0lT8K38P6PLxfZQHhu4W8dV7Av8N2ZmDCCBr0wggSloAMCAQIC

# EzMAAAA5O7Y3Gb8GHWcAAAAAADkwDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYT

# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBS

# b290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDExMB4XDTI0MDgwODIwNTQxOFoX

# DTM2MDMyMjIyMTMwNFowVzELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29m

# dCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQ

# Q0EgMjAyNDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANgBnB7jOMeq

# lRYHNa265v4IY9fH8TKhemHfPINe1gpLaV3dhg324WwH06LcHbpnsBukCDNitryo

# 0dtS/EW6I/yEL/bLSY8hKpbfQuWusBPr9qazYcDxCW/qnjb5JsI1s8bNOg3bVATv

# QVL4tcf03aTycsz8QeCdM0l/yHRObJ9QqazM1r6VPEOJ7LL+uEEb73w6QCuhs89a

# 1uv1zerOYMnsneRRwCbpyW11IcggU0cRKDDq1pjVJzIbIF6+oiXXbReOsgeI8zu1

# FyQfK0fVkaya8SmVHQ/tOf23mZ4W9k0Ri22QW9p3UgSC5OUDktKxxcCmGL6tXLfO

# GSWHIIV4YrTJTT6PNty5REojHJuZHArkF9VnHTERWoTjAzfI3kP+5b4alUdhgAZ7

# ttOu1bVnXfHaqPYl2rPs20ji03LOVWsh/radgE17es5hL+t6lV0eVHrVhsssROWJ

# uz2MXMCt7iw7lFPG9LXKGjsmonn2gotGdHIuEg5JnJMJVmixd5LRlkmgYRZKzhxS

# CwyoGIq0PhaA7Y+VPct5pCHkijcIIDm0nlkK+0KyepolcqGm0T/GYQRMhHJlGOOm

# VQop36wUVUYklUy++vDWeEgEo4s7hxN6mIbf2MSIQ/iIfMZgJxC69oukMUXCrOC3

# SkE/xIkgpfl22MM1itkZ35nNXkMolU1lAgMBAAGjggFOMIIBSjAOBgNVHQ8BAf8E

# BAMCAYYwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFH9ZP1Qh2q1P7wXl5qPX

# LQaUEggxMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMA8GA1UdEwEB/wQFMAMB

# Af8wHwYDVR0jBBgwFoAUci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBP

# oE2gS4ZJaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMv

# TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAw

# TgYIKwYBBQUHMAKGQmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMv

# TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNydDANBgkqhkiG9w0BAQwFAAOC

# AgEAFJQfOChP7onn6fLIMKrSlN1WYKwDFgAddymOUO3FrM8d7B/W/iQ6DxXsDn7D

# 5W4wMwYeLystcEqfkjz4NURRgazyMu5yRzQh4LqjA4tStTcJh1opExo7nn5PuPBY

# nbu0+THSuVHTe0VTTPVhily/piFrDo3axQ9P4C+Ol5yet+2gTfekICS5xS+cYfSI

# vgn0JksVBVMYVI5QFu/qhnLhsEFEUzG8fvv0hjgkO+lkpV9ty6GkN4vdnd7ya6Q6

# aR9y34aiM1qmxaxBi6OUnyNl6fkuun/diTFnYDLTppOkr/mg5WSfCiDVMNCxtj4w

# PKC5OmHm1DQIt/MNokbbH3UGsFP1QbzsLocuSqLCvH09Io3fDPTmscR9Y75G4qX7

# RTX8AdBPo0I6OEojf39zuFZt0qOHm65YWQE69cZM2ueE1MB05dNNgHK9gTE7zKvK

# /fg8B2qjW88MT/WF5V5uvZGtqa9FSL2RazArA+rDPuf6JGYz4HpgMZHB4S6szWSK

# YBv0VisCzfxgeU+dquXW9bd0auYlOB58DPcOYKdc3Se94g+xL4pcEhbB54JOgAkw

# YTu/9dLeH2pDqeJZAABVDWRQCaXfO5LgyKwKCLYXpigrZYCjUSBcr+Ve8PFWMhVT

# Ql0v4q8J/AUmQN5W4n101cY2L4A7GTQG1h32HHAvfQESWP0xghn+MIIZ+gIBATBu

# MFcxCzAJBgNVBAYTAlVTMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# KDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIc

# +s3Fm+gvfsQAAAAAAhwwDQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwG

# CisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZI

# hvcNAQkEMSIEIKGLS97DxXlqnllIizEG8KwVVjw22qCB947a33fWbGngMEIGCisG

# AQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3

# Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEAP2xJfQ/JklcSJjhCz7aV

# CDJ89qehk+ICRMxW7ZKWZa6FyWQb+A9mEjyHek3uUOKG8+C9/jgzW6oH8ooeL0ZX

# 7tvdbZr/uVcE9bWh8DOTfkFzXSTTIfBh7dISOB/iMuBXHOa35ZTgwudTfLJuTPoE

# xYBoGG+3nEhig76mfxOZQ0JX0jUCDva7h1umQYPgF2YPh4LPx02ehfvGTyXpsU9U

# iHMWmQs/1h5qsBiQ87DQdmBL2iqa23SgQJgwHVilaAxOGEdvZ/HGRvl6z9gnJsVj

# V3Ko6mggkihq20fkq3xlEhhZ5jzJew9M8IBreiG9/fAVSIiY1ZD0mfS1m8IJ4NXs

# aKGCF7AwghesBgorBgEEAYI3AwMBMYIXnDCCF5gGCSqGSIb3DQEHAqCCF4kwgheF

# AgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFaBgsqhkiG9w0BCRABBKCCAUkEggFFMIIB

# QQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCC2qRzMABFsWVa7A8G5

# cWewUOxBlcAKBeeZmvezc4LfkgIGaev4BU27GBMyMDI2MDQyNzA5MDI1My4yNjda

# MASAAgH0oIHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv

# bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0

# aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0

# ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo0MzFBLTA1RTAtRDk0NzElMCMG

# A1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEf4wggcoMIIFEKAD

# AgECAhMzAAACHUvAkoc4hX45AAEAAAIdMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNV

# BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w

# HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29m

# dCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTI1MDgxNDE4NDgzM1oXDTI2MTExMzE4

# NDgzM1owgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYD

# VQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTAr

# BgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEnMCUG

# A1UECxMeblNoaWVsZCBUU1MgRVNOOjQzMUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxN

# aWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG9w0BAQEFAAOC

# Ag8AMIICCgKCAgEAorSgaAA8oOl4ph574zw29egUN8DDepRHLX8FM1zHNJmXG6Kr

# SqUKwzcKafopuYdPTETTCvb9aJfESuAU0iGNUFI/D6R0kvdfpe2oPX+E3sbTQvGi

# 4JPH5qdIYUaJ45V/4bqe8eNvbWzpC+ZKjH193DeiI1XAI918JoQmBhlEXo/Ton17

# 21luZJgincsf5LjMY3jX84WyXUSX3dsS7h/7xVI+w1yjg7pa+0y3o/me2Tsv6UJU

# dSTQap5ORGSfCnclnP1z3IiiWIWr3Vo7aIPWsgJzq3m5GxpxUHCQk8qzUhk50y/u

# B+LGE3WIK2C77iy9iFsSfSLUnyMEzGRDW9mXHT4PH7Ozz6CHqQEiNvwcHqlvlCh1

# pHQh1NXQSAqOoVBs5mi6easf6yxWTfe5DrR79503r8pU6VqC2Y9XMRU4wH9QbYXY

# sIUZ33Jmndy22W1LBDAbxBPQHCBlncGDU3BgdhVUVLe80mggFO98FdkWho67w4kP

# dCTRkvdvkY8PrQYE/nQjHXCa0g7LcMttZb6ejMHfQ+tUWXv6+nZ4Ynkr2OkaxclF

# Cw4RIYNMWD26AWbQj/WEdzga18fKtw66L5gzXPza6jFBfPJeKE3H8QAuwpirmH4m

# s+5nUjNNQOmNgqJn0U1+3Yn7ClswD79YN0r3fdbYBMDApBZJpNlK7q7HXRsCAwEA

# AaOCAUkwggFFMB0GA1UdDgQWBBSEWfBxNEamZtXm8gl92Yq80jfxXTAfBgNVHSME

# GDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQhk5odHRw

# Oi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBUaW1l

# LVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwGCCsG

# AQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01p

# Y3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNVHRMB

# Af8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMA4GA1UdDwEB/wQEAwIHgDAN

# BgkqhkiG9w0BAQsFAAOCAgEAkdweB4yxvLspLKq0D+miyD4Q0EcxVFpNZuJxiR54

# gWRkeTDDuymNeB03JhlsBpbwSYJ5uZSgDBCvwHED2VL8lJpFlOprJzxsXWC2NTfA

# +O+PO5Fk5jw6LHh6jeBADDEdQAx3Hqi7Zm0JwvQ93z5f6dtxkm29WqOcHYXRXfAQ

# wy1hSrLXyfeblqR66jpP/9n0fCkWU4ggsUjQpQ2Ngj1DV09J4Y3y7p9Nd81+Xs6q

# Yo++7RKm8qiB/5NDeigOLjlAeFgiEXIRUJW+mJyqpQw+OORlaqcFjR8Hu0G+/7bM

# dek68YX+kPpDBk7Ue+I/xgiYJ1xcDRBn/vczLtN72+RIlD4UgXYLuBSCk//pDEPX

# 5z39Cr+rkc6E4Y28FPk4BhloAyvp628P4xfElQY8TcxraUbZShypocE6ny95D1K1

# BkltZmrHVKCxmglnuOlM15NKIrXFlXCzdqpCtIwQ417wNAVF/QDPvzzbumPdTi6f

# b0tLbScYobV6zvbBsMsKEME4Tj1b9oIXC8dybJq4nbboEXYpRwi1QAbpSNrn+PxG

# W9uf1q63FnMJu4gm3Oh63njW/iVf723quzyHrSijWMgY0HiRiHQi0Jyu0h8MdhRU

# p7mxbmLQckPiOFwAlIaUN/k725y/aLWpkRU6fqmLlEOyH5WpyLd23AYy9r8v+Qob

# a6swggdxMIIFWaADAgECAhMzAAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3DQEB

# CwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTIwMAYD

# VQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAxMDAe

# Fw0yMTA5MzAxODIyMjVaFw0zMDA5MzAxODMyMjVaMHwxCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0

# YW1wIFBDQSAyMDEwMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA5OGm

# TOe0ciELeaLL1yR5vQ7VgtP97pwHB9KpbE51yMo1V/YBf2xK4OK9uT4XYDP/XE/H

# ZveVU3Fa4n5KWv64NmeFRiMMtY0Tz3cywBAY6GB9alKDRLemjkZrBxTzxXb1hlDc

# wUTIcVxRMTegCjhuje3XD9gmU3w5YQJ6xKr9cmmvHaus9ja+NSZk2pg7uhp7M62A

# W36MEBydUv626GIl3GoPz130/o5Tz9bshVZN7928jaTjkY+yOSxRnOlwaQ3KNi1w

# jjHINSi947SHJMPgyY9+tVSP3PoFVZhtaDuaRr3tpK56KTesy+uDRedGbsoy1cCG

# MFxPLOJiss254o2I5JasAUq7vnGpF1tnYN74kpEeHT39IM9zfUGaRnXNxF803RKJ

# 1v2lIH1+/NmeRd+2ci/bfV+AutuqfjbsNkz2K26oElHovwUDo9Fzpk03dJQcNIIP

# 8BDyt0cY7afomXw/TNuvXsLz1dhzPUNOwTM5TI4CvEJoLhDqhFFG4tG9ahhaYQFz

# ymeiXtcodgLiMxhy16cg8ML6EgrXY28MyTZki1ugpoMhXV8wdJGUlNi5UPkLiWHz

# NgY1GIRH29wb0f2y1BzFa/ZcUlFdEtsluq9QBXpsxREdcu+N+VLEhReTwDwV2xo3

# xwgVGD94q0W29R6HXtqPnhZyacaue7e3PmriLq0CAwEAAaOCAd0wggHZMBIGCSsG

# AQQBgjcVAQQFAgMBAAEwIwYJKwYBBAGCNxUCBBYEFCqnUv5kxJq+gpE8RjUpzxD/

# LwTuMB0GA1UdDgQWBBSfpxVdAF5iXYP05dJlpxtTNRnpcjBcBgNVHSAEVTBTMFEG

# DCsGAQQBgjdMg30BATBBMD8GCCsGAQUFBwIBFjNodHRwOi8vd3d3Lm1pY3Jvc29m

# dC5jb20vcGtpb3BzL0RvY3MvUmVwb3NpdG9yeS5odG0wEwYDVR0lBAwwCgYIKwYB

# BQUHAwgwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0PBAQDAgGGMA8G

# A1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU1fZWy4/oolxiaNE9lJBb186aGMQw

# VgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9j

# cmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3JsMFoGCCsGAQUF

# BwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3Br

# aS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcnQwDQYJKoZIhvcNAQEL

# BQADggIBAJ1VffwqreEsH2cBMSRb4Z5yS/ypb+pcFLY+TkdkeLEGk5c9MTO1OdfC

# cTY/2mRsfNB1OW27DzHkwo/7bNGhlBgi7ulmZzpTTd2YurYeeNg2LpypglYAA7AF

# vonoaeC6Ce5732pvvinLbtg/SHUB2RjebYIM9W0jVOR4U3UkV7ndn/OOPcbzaN9l

# 9qRWqveVtihVJ9AkvUCgvxm2EhIRXT0n4ECWOKz3+SmJw7wXsFSFQrP8DJ6LGYnn

# 8AtqgcKBGUIZUnWKNsIdw2FzLixre24/LAl4FOmRsqlb30mjdAy87JGA0j3mSj5m

# O0+7hvoyGtmW9I/2kQH2zsZ0/fZMcm8Qq3UwxTSwethQ/gpY3UA8x1RtnWN0SCyx

# TkctwRQEcb9k+SS+c23Kjgm9swFXSVRk2XPXfx5bRAGOWhmRaw2fpCjcZxkoJLo4

# S5pu+yFUa2pFEUep8beuyOiJXk+d0tBMdrVXVAmxaQFEfnyhYWxz/gq77EFmPWn9

# y8FBSX5+k77L+DvktxW/tM4+pTFRhLy/AsGConsXHRWJjXD+57XQKBqJC4822rpM

# +Zv/Cuk0+CQ1ZyvgDbjmjJnW4SLq8CdCPSWU5nR0W2rRnj7tfqAxM328y+l7vzhw

# RNGQ8cirOoo6CGJ/2XBjU02N7oJtpQUQwXEGahC0HVUzWLOhcGbyoYIDWTCCAkEC

# AQEwggEBoYHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv

# bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0

# aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0

# ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo0MzFBLTA1RTAtRDk0NzElMCMG

# A1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcGBSsOAwIa

# AxUAuoO+BKbfXzqyfi9GLEdWHkCLeT+ggYMwgYCkfjB8MQswCQYDVQQGEwJVUzET

# MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV

# TWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1T

# dGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsFAAIFAO2ZGXEwIhgPMjAyNjA0MjYy

# MzA4MzNaGA8yMDI2MDQyNzIzMDgzM1owdzA9BgorBgEEAYRZCgQBMS8wLTAKAgUA

# 7ZkZcQIBADAKAgEAAgJbHgIB/zAHAgEAAgITHzAKAgUA7Zpq8QIBADA2BgorBgEE

# AYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAIDAYag

# MA0GCSqGSIb3DQEBCwUAA4IBAQAbfSvLBy21QdIKj5y8jU+EIEpiHyzgi2wPvy+G

# /SAhUsHaIfdJrmIoTDNi+82f8edApCLr+2Z1h2Pm54wH69pqBn3LfLLtyEmcAcMT

# zavM244riv0ZWtD15DL5xO34Ji4eQlB8ft6w/a0nQCPPKjdprTTRRMLk1/5eTxxH

# H0WaCBqc+txLi+Bflfi3bMcCL3wMjgdalUzF9sH0cd8WWJcUjVF5wxMW7qx0L22U

# 7t0YvIkuyVmo3O0geziQEvc8rorwZC12BmyRPqhldSt0EcUKk/75IqSt0C6JjRX+

# I7tZXm80gOO0NmBW810w/6HVs3vx2VnhA0AFTXBFbNBu5BcBMYIEDTCCBAkCAQEw

# gZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT

# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UE

# AxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIdS8CShziFfjkA

# AQAAAh0wDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0B

# CRABBDAvBgkqhkiG9w0BCQQxIgQg+9CpS50BfrFAnmGdy/yM5sxAF4c0IFxCk/Qn

# xGUp4dkwgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCCxtpXMXEiLJzrqM77e

# p4rTNwrMOj6gpWN9hZvpj5QFUTCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w

# IFBDQSAyMDEwAhMzAAACHUvAkoc4hX45AAEAAAIdMCIEIHidNd4+zRfh5iQ/oFtd

# uhYJv/dBNE/W9bfb7IDRgoycMA0GCSqGSIb3DQEBCwUABIICAHwSIGsH7HD9BqmO

# UJMSxC0zTIrQQ487JlRDaFYr7bJcbfWLUmIRk7nq2QvZG6fAMFqAosNSf+Dre/dk

# Z9eFzEsGJoMS1K3WwR+9qizvOHoh4k9BlUsZ1ZpPn/r7voRgOy41LFX79Io5Z1NL

# RFh+CSPlzlsRX3ENQ6sU9oz1VNmsh7AVtf/6/JcNCKcD2JdVs6EVEKVVfAe6FOrR

# dCKA3s3X9rfe0BnsYWFTVOFlWuPfGTCku/slWwlFPzpXLuNiw5dAKkLkqQgDdnjL

# xIefItZna+xwNx2xouAb4o3NgN5rwiLzwdaaC6Zd9CNm24sHZF4hHzcrh2bHM4Xd

# ZQuKLHm9Jr0+QDG6rOK1UDJZjOsnHtYX2SXeI13ntkszsLZWHACVjRWeRDFQjOGC

# uFlPUu5yZqf6c/imEI2pR0aCsPGlisoGL+4o8te3dJfKcECC72hWV4N7/gAX6b1j

# CBUZ8aTnPSeyOiF9VdKm+TGEfWO+w/YvrPZ8iQag6Jy7RY/eXiS2LRt1ipTYEP1z

# tTOtCZ+4QQFFXsj7AAH9WkzpCXWKjLHPSCLC6MyatljIaZGn+mxLiVAgHNkWG61G

# 638/GqO5kVbpToKQKeWSpX+qqostau7M2Ogta9tkmOVZ4tebRBbcfgnwwkmRSn9W

# 5vcQrN/9iZhoJTYzq6RINKE7fjFG

# SIG # End signature block