BcContainerHelper

6.1.11-preview1992978

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.

#>

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

    )

$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

                $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"

                            $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"

                        }

                    }

                }

            }

        }

        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

# MIIoGgYJKoZIhvcNAQcCoIIoCzCCKAcCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDG4BH8r65ekmsR

# KaEfHSG5iVsdr8BjFtHvqyBfuPztpKCCDYUwggYDMIID66ADAgECAhMzAAAEhJji

# EuB4ozFdAAAAAASEMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjUwNjE5MTgyMTM1WhcNMjYwNjE3MTgyMTM1WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQDtekqMKDnzfsyc1T1QpHfFtr+rkir8ldzLPKmMXbRDouVXAsvBfd6E82tPj4Yz

# aSluGDQoX3NpMKooKeVFjjNRq37yyT/h1QTLMB8dpmsZ/70UM+U/sYxvt1PWWxLj

# MNIXqzB8PjG6i7H2YFgk4YOhfGSekvnzW13dLAtfjD0wiwREPvCNlilRz7XoFde5

# KO01eFiWeteh48qUOqUaAkIznC4XB3sFd1LWUmupXHK05QfJSmnei9qZJBYTt8Zh

# ArGDh7nQn+Y1jOA3oBiCUJ4n1CMaWdDhrgdMuu026oWAbfC3prqkUn8LWp28H+2S

# LetNG5KQZZwvy3Zcn7+PQGl5AgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUBN/0b6Fh6nMdE4FAxYG9kWCpbYUw

# VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh

# dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzUwNTM2MjAfBgNVHSMEGDAW

# gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw

# MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov

# L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx

# XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB

# AGLQps1XU4RTcoDIDLP6QG3NnRE3p/WSMp61Cs8Z+JUv3xJWGtBzYmCINmHVFv6i

# 8pYF/e79FNK6P1oKjduxqHSicBdg8Mj0k8kDFA/0eU26bPBRQUIaiWrhsDOrXWdL

# m7Zmu516oQoUWcINs4jBfjDEVV4bmgQYfe+4/MUJwQJ9h6mfE+kcCP4HlP4ChIQB

# UHoSymakcTBvZw+Qst7sbdt5KnQKkSEN01CzPG1awClCI6zLKf/vKIwnqHw/+Wvc

# Ar7gwKlWNmLwTNi807r9rWsXQep1Q8YMkIuGmZ0a1qCd3GuOkSRznz2/0ojeZVYh

# ZyohCQi1Bs+xfRkv/fy0HfV3mNyO22dFUvHzBZgqE5FbGjmUnrSr1x8lCrK+s4A+

# bOGp2IejOphWoZEPGOco/HEznZ5Lk6w6W+E2Jy3PHoFE0Y8TtkSE4/80Y2lBJhLj

# 27d8ueJ8IdQhSpL/WzTjjnuYH7Dx5o9pWdIGSaFNYuSqOYxrVW7N4AEQVRDZeqDc

# fqPG3O6r5SNsxXbd71DCIQURtUKss53ON+vrlV0rjiKBIdwvMNLQ9zK0jy77owDy

# XXoYkQxakN2uFIBO1UNAvCYXjs4rw3SRmBX9qiZ5ENxcn/pLMkiyb68QdwHUXz+1

# fI6ea3/jjpNPz6Dlc/RMcXIWeMMkhup/XEbwu73U+uz/MIIHejCCBWKgAwIBAgIK

# YQ6Q0gAAAAAAAzANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNV

# BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv

# c29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlm

# aWNhdGUgQXV0aG9yaXR5IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEw

# OTA5WjB+MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYD

# VQQDEx9NaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG

# 9w0BAQEFAAOCAg8AMIICCgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+la

# UKq4BjgaBEm6f8MMHt03a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc

# 6Whe0t+bU7IKLMOv2akrrnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4D

# dato88tt8zpcoRb0RrrgOGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+

# lD3v++MrWhAfTVYoonpy4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nk

# kDstrjNYxbc+/jLTswM9sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6

# A4aN91/w0FK/jJSHvMAhdCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmd

# X4jiJV3TIUs+UsS1Vz8kA/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL

# 5zmhD+kjSbwYuER8ReTBw3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zd

# sGbiwZeBe+3W7UvnSSmnEyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3

# T8HhhUSJxAlMxdSlQy90lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS

# 4NaIjAsCAwEAAaOCAe0wggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRI

# bmTlUAXTgqoXNzcitW2oynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTAL

# BgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBD

# uRQFTuHqp8cx0SOJNDBaBgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jv

# c29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3JsMF4GCCsGAQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3

# dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3J0MIGfBgNVHSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEF

# BQcCARYzaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1h

# cnljcHMuaHRtMEAGCCsGAQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkA

# YwB5AF8AcwB0AGEAdABlAG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn

# 8oalmOBUeRou09h0ZyKbC5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7

# v0epo/Np22O/IjWll11lhJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0b

# pdS1HXeUOeLpZMlEPXh6I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/

# KmtYSWMfCWluWpiW5IP0wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvy

# CInWH8MyGOLwxS3OW560STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBp

# mLJZiWhub6e3dMNABQamASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJi

# hsMdYzaXht/a8/jyFqGaJ+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYb

# BL7fQccOKO7eZS/sl/ahXJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbS

# oqKfenoi+kiVH6v7RyOA9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sL

# gOppO6/8MO0ETI7f33VtY5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtX

# cVZOSEXAQsmbdlsKgEhr/Xmfwb1tbWrJUnMTDXpQzTGCGeswghnnAgEBMIGVMH4x

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p

# Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAASEmOIS4HijMV0AAAAA

# BIQwDQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw

# LwYJKoZIhvcNAQkEMSIEIBkwrpxbktdXLiZHAYrGj2VUE53YLEapAnNK5rgK+YLr

# MEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRw

# Oi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEALYz11LzwBiZT

# 6IFZjQ/2FJ6AoAe8Q3zE0PEznnigv/w6ys8aNviR/A41d9ojekVrsEjuA+OG7Cky

# pLrlQ8CiMNTP8083io8mOaqir+8TT4/9QfaeP6ChQc650Ppt3XdV4a44tR+euwd0

# VOVEJNfm/QymmtXThntj8kArP+QENd8VFug7cySNOt/rQllBvlm4eyl+NR4bkmJ2

# 2y16PKiWCdgyckqHH/YutVELhSVeN1iBWRxEcXn+LnutvGE2BxCyqjVdhomd6iVj

# +o2Zw+6z1nrUPev3dFNJrulFFeY/+OSunfJxm5C1xUoBIaHTkTAiADUnRccVlHum

# 9C7WY8Y0faGCF5MwghePBgorBgEEAYI3AwMBMYIXfzCCF3sGCSqGSIb3DQEHAqCC

# F2wwghdoAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFSBgsqhkiG9w0BCRABBKCCAUEE

# ggE9MIIBOQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCD9di9/ToBW

# nSDxnS30J4SHBzOHT9gcMvcFbYigVXevJQIGaSTl5mdyGBMyMDI1MTIwODEyNDYz

# NC4zMTZaMASAAgH0oIHRpIHOMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz

# aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv

# cnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25z

# MScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046OTIwMC0wNUUwLUQ5NDcxJTAjBgNV

# BAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2WgghHpMIIHIDCCBQigAwIB

# AgITMwAAAgkIB+D5XIzmVQABAAACCTANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQG

# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG

# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQg

# VGltZS1TdGFtcCBQQ0EgMjAxMDAeFw0yNTAxMzAxOTQyNTVaFw0yNjA0MjIxOTQy

# NTVaMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYD

# VQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hp

# ZWxkIFRTUyBFU046OTIwMC0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBU

# aW1lLVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC

# AQDClEow9y4M3f1S9z1xtNEETwWL1vEiiw0oD7SXEdv4sdP0xsVyidv6I2rmEl8P

# Ys9LcZjzsWOHI7dQkRL28GP3CXcvY0Zq6nWsHY2QamCZFLF2IlRH6BHx2RkN7ZRD

# Kms7BOo4IGBRlCMkUv9N9/twOzAkpWNsM3b/BQxcwhVgsQqtQ8NEPUuiR+GV5rdQ

# HUT4pjihZTkJwraliz0ZbYpUTH5Oki3d3Bpx9qiPriB6hhNfGPjl0PIp23D579rp

# W6ZmPqPT8j12KX7ySZwNuxs3PYvF/w13GsRXkzIbIyLKEPzj9lzmmrF2wjvvUrx9

# AZw7GLSXk28Dn1XSf62hbkFuUGwPFLp3EbRqIVmBZ42wcz5mSIICy3Qs/hwhEYhU

# ndnABgNpD5avALOV7sUfJrHDZXX6f9ggbjIA6j2nhSASIql8F5LsKBw0RPtDuy3j

# 2CPxtTmZozbLK8TMtxDiMCgxTpfg5iYUvyhV4aqaDLwRBsoBRhO/+hwybKnYwXxK

# eeOrsOwQLnaOE5BmFJYWBOFz3d88LBK9QRBgdEH5CLVh7wkgMIeh96cH5+H0xEvm

# g6t7uztlXX2SV7xdUYPxA3vjjV3EkV7abSHD5HHQZTrd3FqsD/VOYACUVBPrxF+k

# UrZGXxYInZTprYMYEq6UIG1DT4pCVP9DcaCLGIOYEJ1g0wIDAQABo4IBSTCCAUUw

# HQYDVR0OBBYEFEmL6NHEXTjlvfAvQM21dzMWk8rSMB8GA1UdIwQYMBaAFJ+nFV0A

# XmJdg/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWlj

# cm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQ

# Q0ElMjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0

# dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIw

# VGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYD

# VR0lAQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEB

# CwUAA4ICAQBcXnxvODwk4h/jbUBsnFlFtrSuBBZb7wSZfa5lKRMTNfNlmaAC4bd7

# Wo0I5hMxsEJUyupHwh4kD5qkRZczIc0jIABQQ1xDUBa+WTxrp/UAqC17ijFCePZK

# YVjNrHf/Bmjz7FaOI41kxueRhwLNIcQ2gmBqDR5W4TS2htRJYyZAs7jfJmbDtTcU

# OMhEl1OWlx/FnvcQbot5VPzaUwiT6Nie8l6PZjoQsuxiasuSAmxKIQdsHnJ5Qokq

# wdyqXi1FZDtETVvbXfDsofzTta4en2qf48hzEZwUvbkz5smt890nVAK7kz2crrzN

# 3hpnfFuftp/rXLWTvxPQcfWXiEuIUd2Gg7eR8QtyKtJDU8+PDwECkzoaJjbGCKqx

# 9ESgFJzzrXNwhhX6Rc8g2EU/+63mmqWeCF/kJOFg2eJw7au/abESgq3EazyD1VlL

# +HaX+MBHGzQmHtvOm3Ql4wVTN3Wq8X8bCR68qiF5rFasm4RxF6zajZeSHC/qS533

# 6/4aMDqsV6O86RlPPCYGJOPtf2MbKO7XJJeL/UQN0c3uix5RMTo66dbATxPUFEG5

# Ph4PHzGjUbEO7D35LuEBiiG8YrlMROkGl3fBQl9bWbgw9CIUQbwq5cTaExlfEpMd

# SoydJolUTQD5ELKGz1TJahTidd20wlwi5Bk36XImzsH4Ys15iXRfAjCCB3EwggVZ

# oAMCAQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJ

# BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jv

# c29mdCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4

# MjIyNVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh

# c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD

# b3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIw

# MTAwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvX

# JHm9DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa

# /rg2Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AK

# OG6N7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rbo

# YiXcag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIck

# w+DJj361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbni

# jYjklqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F

# 37ZyL9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZ

# fD9M269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIz

# GHLXpyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR

# /bLUHMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1

# Hode2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUC

# AwEAATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0O

# BBYEFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yD

# fQEBMEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lv

# cHMvRG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkr

# BgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUw

# AwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBN

# MEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0

# cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoG

# CCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01p

# Y1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9

# /Cqt4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5

# bbsPMeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvf

# am++Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn

# 0CS9QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlS

# dYo2wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0

# j/aRAfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5

# JL5zbcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakUR

# R6nxt67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4

# O+S3Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVn

# K+ANuOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoI

# Yn/ZcGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNMMIICNAIBATCB+aGB0aSB

# zjCByzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT

# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UE

# CxMcTWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNoaWVs

# ZCBUU1MgRVNOOjkyMDAtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGlt

# ZS1TdGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQB8762rPTQd7InDCQdb1kgF

# KQkCRKCBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u

# MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp

# b24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqG

# SIb3DQEBCwUAAgUA7OEvAzAiGA8yMDI1MTIwODExMDMzMVoYDzIwMjUxMjA5MTEw

# MzMxWjBzMDkGCisGAQQBhFkKBAExKzApMAoCBQDs4S8DAgEAMAYCAQACASowBwIB

# AAICExAwCgIFAOzigIMCAQAwNgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoD

# AqAKMAgCAQACAwehIKEKMAgCAQACAwGGoDANBgkqhkiG9w0BAQsFAAOCAQEAOsnq

# qz+32rk5WnM4wKJzofiVul8fuFkPhZU0+7m/a/SftfBM8TzIi+1hRM79iWJKI2HE

# 11CLBcAa5tuzSZkcLa+NeJFjtiAqd6xIyTEmFiUh4+DrsSv8US9Il3yDNwmCfItN

# r4AMKF+1MdWP4BlpC/LOlLSvAbubxwC3QYA90fyCbGKv5+Hcefc07eE1i2cDNX9V

# hwmGifXt81CtG0TejsE8XBhiOchia416Zou5fqEHFpTievsxCuXZ439CykZ/ZUd+

# pgMA0Q6i4Css7Nq0dHb42uYzpaFSPS52iIeJuEyAp7fT3oAreUMyJosB+LDjwPU3

# BzVlCLvJ3sj5rqTMuTGCBA0wggQJAgEBMIGTMHwxCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w

# IFBDQSAyMDEwAhMzAAACCQgH4PlcjOZVAAEAAAIJMA0GCWCGSAFlAwQCAQUAoIIB

# SjAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZIhvcNAQkEMSIEIGq9

# U7qjvxhn9gkdHDLhaJRPvxhVQdUXKZs/s2ttVzttMIH6BgsqhkiG9w0BCRACLzGB

# 6jCB5zCB5DCBvQQgaBssHsi99AIuZQ5RmGN1SorxuKR8HplVV2hOM3CFEz4wgZgw

# gYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYD

# VQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAgkIB+D5XIzm

# VQABAAACCTAiBCArOurzCeLNT1ehy2WrfPHG7BBdA/hrWwVO1IfyTS6jRzANBgkq

# hkiG9w0BAQsFAASCAgC4ArDD22jGgPMyWnX7KLJaH1XbUbn2fOu1F15txi823AxQ

# ykM/KxaFKFqr+PoRXprM6SbKYlNsrVKJSRiYBgMgeEmcijnSncknZwv6af4+uS6W

# vYEKs9OKuANuBo+yQRf3MRXi/gxaUIczvDmjxGsOaezhoInr544y+PpK04DAjsyN

# BCCM1jXQgMkkAfXfNcDnr3nTbGceAzAxhaVhpjPrbzEgEFyHbAg4/34mXKtiLJkw

# 0NmSvSFZZoHqYF9x3qQ99yuZpNhz5E2h/HcV7UvZVBsMRr551W/VZ1sEE1bOScr4

# Z0zMDC7q4ixgNOj5vOORv7G6tJHuhyvMYI7Ogsi7qD2qOQJ8QImhxSciVSqzAW+C

# +8nwGx/BJ+wQlB/czMBGK3EF0HHn67kxIfjR5F4rRYOSA8cHcnKhBJxD1McdSkLI

# ABX8QVTIZwhzU2BuDVRWQEYrbRSpIFwnvtHY+JOh9W1aX7k7AxyA3kahtLMFNm9S

# T2Ubv8q0cip/49oKRUZMfMcT6PvmYD+ubd8iStcfRy6UN0wjXKSHMojg7UqbA4i/

# 8oL9r3Cdq/ykG3dJwzCHjuSZNVuEUMB+i7IS8TWSZq/k1yy/ONPwIFAsf7inW2Xb

# YwKWxytImowh8/KXcu7IKxDyv4oVO96jh59KR8G0YyvSNLV3xcnbOzsu8EXGVw==

# SIG # End signature block