BcContainerHelper

6.1.11-preview1992204

AppHandling/Sort-AppFilesByDependencies.ps1

                                <# 

 .Synopsis

  Sort an array of app files

 .Description

  Sort an array of app files with dependencies first, for compile and publish order

 .Parameter appFiles

  Array of app files

 .Parameter includeOnlyAppIds

  Array of AppIds. If specified, then include Only Apps in the specified AppFile array or archive which is contained in this Array and their dependencies

 .Parameter unknownDependencies

  If specified, this reference parameter will contain unresolved dependencies after sorting

 .Parameter excludeRuntimePackages

  If specified, runtime packages will be ignored

 .Parameter includeSystemDependencies

  If specified, dependencies on Microsoft.Application and Microsoft.Platform will be included

 .Parameter includeDependencyVersion

  If specified, the version of the dependencies will be included in the output

 .Example

  $files = Sort-AppFilesByDependencies -appFiles @($app1, $app2)

#>

function Sort-AppFilesByDependencies {

    Param(

        [Parameter(Mandatory=$false)]

        [string] $containerName = "",

        [Parameter(Mandatory=$false)]

        [string[]] $appFiles,

        [string[]] $includeOnlyAppIds = @(),

        $excludeInstalledApps = @(),

        [Parameter(Mandatory=$false)]

        [ref] $unknownDependencies,

        [switch] $excludeRuntimePackages,

        [switch] $includeSystemDependencies,

        [switch] $includeDependencyVersion

    )

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

    try {

        if (!$appFiles) {

            return @()

        }

        # Read all app.json objects, populate $apps

        $apps = $()

        $files = @{}

        $appFiles | ForEach-Object {

            $appFile = $_

            $includeIt = $true

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

            try {

                Extract-AppFileToFolder -appFilename $appFile -appFolder $tmpFolder -generateAppJson 6> $null

                $appJsonFile = Join-Path $tmpFolder "app.json"

                $appJson = [System.IO.File]::ReadAllLines($appJsonFile) | ConvertFrom-Json

            }

            catch {

                if ($_.exception.message -eq "You cannot extract a runtime package") {

                    if ($excludeRuntimePackages) {

                        $includeIt = $false

                    }

                    else {

                        $appJson = Get-AppJsonFromAppFile -appFile $appFile

                    }

                }

                else {

                    throw "Unable to extract and analyze appFile $appFile"

                }

            }

            finally {

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

            }

            if ($includeIt) {

                $key = "$($appJson.Id):$($appJson.Version)"

                if (-not $files.ContainsKey($key)) {

                    $files += @{ "$($appJson.Id):$($appJson.Version)" = $appFile }

                    $apps += @($appJson)

                }

            }

        }

        # Populate SortedApps and UnresolvedDependencies

        $script:sortedApps = @()

        $script:unresolvedDependencies = $()

        function AddAnApp { Param($anApp) 

            $alreadyAdded = $script:sortedApps | Where-Object { $_.Id -eq $anApp.Id -and $_.Version -eq $anApp.Version }

            if (-not ($alreadyAdded)) {

                AddDependencies -anApp $anApp

                $script:sortedApps += $anApp

            }

        }

        function AddDependency { Param($dependency)

            $dependencyAppId = "$(if ($dependency.PSObject.Properties.name -eq 'AppId') { $dependency.AppId } else { $dependency.Id })"

            $dependentApp = $apps | Where-Object { $_.Id -eq $dependencyAppId } | Sort-Object -Property @{ "Expression" = "[System.Version]Version" }

            if ($dependentApp) {

                if ($dependentApp -is [Array]) {

                    Write-Host -ForegroundColor Yellow "AppFiles contains multiple versions of the app with AppId $dependencyAppId"

                    $dependentApp = $dependentApp | Select-Object -Last 1

                }

                AddAnApp -AnApp $dependentApp

            }

            else {

                if (-not ($script:unresolvedDependencies | Where-Object { $_ } | Where-Object { "$(if ($_.PSObject.Properties.name -eq 'AppId') { $_.AppId } else { $_.Id })" -eq $dependencyAppId })) {

                    $appFileName = "$($dependency.publisher)_$($dependency.name)_$($dependency.version).app".Split([System.IO.Path]::GetInvalidFileNameChars()) -join ''

                    if ($dependencyAppid -ne '63ca2fa4-4f03-4f2b-a480-172fef340d3f' -and $dependencyAppId -ne '437dbf0e-84ff-417a-965d-ed2bb9650972' -and $dependencyAppId -ne 'f3552374-a1f2-4356-848e-196002525837') {

                        Write-Warning "Dependency $($dependencyAppId):$appFileName not found"

                    }

                    $script:unresolvedDependencies += @($dependency)

                }

            }

        }

        function AddDependencies { Param($anApp)

            if ($anApp) {

                if ($anApp.psobject.Members | Where-Object name -eq "dependencies") {

                    if ($anApp.Dependencies) {

                        $anApp.Dependencies | ForEach-Object { AddDependency -Dependency $_ }

                    }

                }

                if ($includeSystemDependencies.IsPresent) {

                    if ($anApp.psobject.Members | Where-Object name -eq "application") {

                        AddDependency -dependency ([PSCustomObject]@{

                            "publisher" = "Microsoft"

                            "name" = "Application"

                            "version" = $anApp.Application

                            "id" = 'Microsoft.Application'

                        })

                    }

                    if ($anApp.psobject.Members | Where-Object name -eq "platform") {

                        AddDependency -dependency ([PSCustomObject]@{

                            "publisher" = "Microsoft"

                            "name" = "Platform"

                            "version" = $anApp.Platform

                            "id" = 'Microsoft.Platform'

                        })

                    }

                }

            }

        }

        function MarkSortedApps { Param($AppId)

            $script:sortedApps | Where-Object { $_.Id -eq $AppId } | ForEach-Object {

                $_.Included = $true

                if ($_.Dependencies) {

                    $_.Dependencies | ForEach-Object {

                        $dependency = $_

                        if ($dependency) {

                            $dependencyAppId = "$(if ($dependency.PSObject.Properties.name -eq 'AppId') { $dependency.AppId } else { $dependency.Id })"

                            MarkSortedApps -AppId $dependencyAppId

                        }

                    }

                }

            }

        }

        $apps | Where-Object { $_ } | Where-Object { $_.Name -eq "Application" } | ForEach-Object { AddAnApp -anApp $_ }

        $apps | Where-Object { $_ } | ForEach-Object { AddAnApp -AnApp $_ }

        if ($excludeInstalledApps) {

            $script:sortedApps = $script:sortedApps | ForEach-Object {

                $appName = [System.IO.Path]::GetFileName($files["$($_.id):$($_.version)"])

                $app = $_

                $installedApp = $excludeInstalledApps | Where-Object { $_.id -eq $app.id }

                if (!$installedApp) {

                    $app

                }

                elseif ([System.Version]$app.Version -eq $installedApp.Version ) {

                    Write-Host "$appName is already installed with the same version"

                }

                elseif ([System.Version]$app.Version -lt $installedApp.Version ) {

                    Write-DevOpsWarning -Message "$appName is already installed with a newer version ($($installedApp.Version))"

                }

                else {

                    $app

                }

            }

        }

        if ($includeOnlyAppIds) {

            $script:sortedApps | ForEach-Object { $_ | Add-Member -NotePropertyName 'Included' -NotePropertyValue $false }

            $includeOnlyAppIds | ForEach-Object { MarkSortedApps -AppId $_ }

            $script:sortedApps | ForEach-Object {

                if ($_.Included) {

                    $files["$($_.id):$($_.version)"]

                }

                else {

                    $appName = [System.IO.Path]::GetFileName($files["$($_.id):$($_.version)"])

                    Write-Host "$appName (AppId=$($_.id)) is skipped as it is not referenced"

                }

            }

        }

        else {

            $script:sortedApps | ForEach-Object {

                $files["$($_.id):$($_.version)"]

            }

        }

        if ($unknownDependencies) {

            $unknownDependencies.value = @($script:unresolvedDependencies | ForEach-Object { if ($_) { 

                "$(if ($_.PSObject.Properties.name -eq 'AppId') { $_.AppId } else { $_.Id }):$(if($includeDependencyVersion.IsPresent){"$($_.Version):"})" + $("$($_.publisher)_$($_.name)_$($_.version).app".Split([System.IO.Path]::GetInvalidFileNameChars()) -join '')

            } })

        }

    }

    catch {

        TrackException -telemetryScope $telemetryScope -errorRecord $_

        throw

    }

    finally {

        TrackTrace -telemetryScope $telemetryScope

    }

}

Export-ModuleMember -Function Sort-AppFilesByDependencies

# SIG # Begin signature block

# MIIoGwYJKoZIhvcNAQcCoIIoDDCCKAgCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAPa4d6+NEned/W

# sJ/d+O+PYetj70HonMGFm0EqoX7s16CCDYUwggYDMIID66ADAgECAhMzAAAEhJji

# 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/Xmfwb1tbWrJUnMTDXpQzTGCGewwghnoAgEBMIGVMH4x

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p

# Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAASEmOIS4HijMV0AAAAA

# BIQwDQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw

# LwYJKoZIhvcNAQkEMSIEIJHxmPuLybVgMOVtVdsO+lgMGsxfNRsx4X3gEY8KcJ1X

# MEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRw

# Oi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEAp44ZQKfnYmt9

# MBMWRaCc6HvOWLdVnsMf3bWFCbbeKYYyrLPb7Xvb7Yo8u6xT8zvgnILtAWNpWiCw

# C2SDfF8pNpmZ2nZq9wv9w8/ILF7mOF3c87aDCYep0uwaO+uPP4ghAUp3EhH1HK25

# PWMnzfzxOU88wbEQ9zlGY1ru3sq36hF98blWLhpmp9u9Yt9ad8OGbF8dSBAVbLKq

# xGLGG16cYNftlY8geERf5v1PC01nz5D1DiJ3BZxSWKGb39bR3aP7BCRs4ofDIQzF

# BIH5TEC8sonDOCn/vhCZxE08w1MnvkMpCY0xeVjPUx71BMUUovJ6jiKF6eH2bvEo

# qfTwCJuaCKGCF5QwgheQBgorBgEEAYI3AwMBMYIXgDCCF3wGCSqGSIb3DQEHAqCC

# F20wghdpAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFSBgsqhkiG9w0BCRABBKCCAUEE

# ggE9MIIBOQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCCOi2WSgknS

# 1FB0wnSpJG3MahJBsWmaVut7SlQgXtU7SwIGaSc9dr+1GBMyMDI1MTIwODEyNDc1

# MS4zMzhaMASAAgH0oIHRpIHOMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz

# aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv

# cnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25z

# MScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046MzMwMy0wNUUwLUQ5NDcxJTAjBgNV

# BAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2WgghHqMIIHIDCCBQigAwIB

# AgITMwAAAg9XmkcUQOZG5gABAAACDzANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQG

# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG

# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQg

# VGltZS1TdGFtcCBQQ0EgMjAxMDAeFw0yNTAxMzAxOTQzMDRaFw0yNjA0MjIxOTQz

# MDRaMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYD

# VQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hp

# ZWxkIFRTUyBFU046MzMwMy0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBU

# aW1lLVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC

# AQCl6DTurxf66o73G0A2yKo1/nYvITBQsd50F52SQzo2cSrt+EDEFCDlSxZzWJD7

# ujQ1Z1dMbMT6YhK7JUvwxQ+LkQXv2k/3v3xw8xJ2mhXuwbT+s1WOL0+9g9AOEAAM

# 6WGjCzI/LZq3/tzHr56in/Z++o/2soGhyGhKMDwWl4J4L1Fn8ndtoM1SBibPdqmw

# mPXpB9QtaP+TCOC1vAaGQOdsqXQ8AdlK6Vuk9yW9ty7S0kRP1nXkFseM33NzBu//

# ubaoJHb1ceYPZ4U4EOXBHi/2g09WRL9QWItHjPGJYjuJ0ckyrOG1ksfAZWP+Bu8P

# XAq4s1Ba/h/nXhXAwuxThpvaFb4T0bOjYO/h2LPRbdDMcMfS9Zbhq10hXP6ZFHR0

# RRJ+rr5A8ID9l0UgoUu/gNvCqHCMowz97udo7eWODA7LaVv81FHHYw3X5DSTUqJ6

# pwP+/0lxatxajbSGsm267zqVNsuzUoF2FzPM+YUIwiOpgQvvjYIBkB+KUwZf2vRI

# PWmhAEzWZAGTox/0vj4eHgxwER9fpThcsbZGSxx0nL54Hz+L36KJyEVio+oJVvUx

# m75YEESaTh1RnL0Dls91sBw6mvKrO2O+NCbUtfx+cQXYS0JcWZef810BW9Bn/eIv

# ow3Kcx0dVuqDfIWfW7imeTLAK9QAEk+oZCJzUUTvhh2hYQIDAQABo4IBSTCCAUUw

# HQYDVR0OBBYEFJnUMQ2OtyAhLR/MD2qtJ9lKRP9ZMB8GA1UdIwQYMBaAFJ+nFV0A

# XmJdg/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWlj

# cm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQ

# Q0ElMjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0

# dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIw

# VGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYD

# VR0lAQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEB

# CwUAA4ICAQBTowbo1bUE7fXTy+uW9m58qGEXRBGVMEQiFEfSui1fhN7jS+kSiN0S

# R5Kl3AuV49xOxgHo9+GIne5Mpg5n4NS5PW8nWIWGj/8jkE3pdJZSvAZarXD4l43i

# MNxDhdBZqVCkAYcdFVZnxdy+25MRY6RfaGwkinjnYNFA6DYL/1cxw6Ya4sXyV7Fg

# PdMmxVpffnPEDFv4mcVx3jvPZod7gqiDcUHbyV1gaND3PejyJ1MGfBYbAQxsynLX

# 1FUsWLwKsNPRJjynwlzBT/OQbxnzkjLibi4h4dOwcN+H4myDtUSnYq9Xf4YvFlZ+

# mJs5Ytx4U9JVCyW/WERtIEieTvTRgvAYj/4Mh1F2Elf8cdILgzi9ezqYefxdsBD8

# Vix35yMC5LTnDUoyVVulUeeDAJY8+6YBbtXIty4phIkihiIHsyWVxW2YGG6A6UWe

# nuwY6z9oBONvMHlqtD37ZyLn0h1kCkkp5kcIIhMtpzEcPkfqlkbDVogMoWy80xul

# xt64P4+1YIzkRht3zTO+jLONu1pmBt+8EUh7DVct/33tuW5NOSx56jXQ1TdOdFBp

# gcW8HvJii8smQ1TQP42HNIKIJY5aiMkK9M2HoxYrQy2MoHNOPySsOzr3le/4SDdX

# 67uobGkUNerlJKzKpTR5ZU0SeNAu5oCyDb6gdtTiaN50lCC6m44sXjCCB3EwggVZ

# 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/ZcGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNNMIICNQIBATCB+aGB0aSB

# zjCByzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT

# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UE

# CxMcTWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNoaWVs

# ZCBUU1MgRVNOOjMzMDMtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGlt

# ZS1TdGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQBetIzj2C/MkdiI03EyNsCt

# SOMdWqCBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u

# MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp

# b24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqG

# SIb3DQEBCwUAAgUA7ODj2jAiGA8yMDI1MTIwODA1NDI1MFoYDzIwMjUxMjA5MDU0

# MjUwWjB0MDoGCisGAQQBhFkKBAExLDAqMAoCBQDs4OPaAgEAMAcCAQACAgwJMAcC

# AQACAhMjMAoCBQDs4jVaAgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkK

# AwKgCjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBADjQ

# 4tRjtp/a966Qd2UZrj1I7WUAa2Bx3gtPEVG0aH0EcyeuptMzZc/K7wi3EDvb1wmX

# SWyIpUvCKgcplXQU5Z1QaoxyEe8XNQW0CAYBcwUW8XP6AR1eNUBEaW44+pVu2CEW

# 5yB9I4Fsyiq6x0+PL+wl1Q62ISXcayY1dnAEz9eA/Jtu+u9HPgR+YJjOed19lI4X

# mHIFgx6SQ+xKlg3QOgTFsU0eLIbx+McVGRAsYd8PnW8py12AtwW2Xq0qTqIg0kwc

# 9ust18WgtuJ6TB26ZcX4DQ9Puui6ar8R5X0/purtSe/XXCtfrpR8hxm9kKnMLWam

# FDvaD2+4Pkwwi3yxDX0xggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEG

# A1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWlj

# cm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFt

# cCBQQ0EgMjAxMAITMwAAAg9XmkcUQOZG5gABAAACDzANBglghkgBZQMEAgEFAKCC

# AUowGgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCCj

# OXbFGZ7kOhLngYaCb2N8ksyqLccEpFHFTq9bfottAzCB+gYLKoZIhvcNAQkQAi8x

# geowgecwgeQwgb0EIN1Hd5UmKnm7FW7xP3niGsfHJt4xR8Xu+MxgXXc0iqn4MIGY

# MIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNV

# BAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQG

# A1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIPV5pHFEDm

# RuYAAQAAAg8wIgQgwbWrou+EZTmuzAO9gLWHX7oB1breQWo39CZmyLF7dGYwDQYJ

# KoZIhvcNAQELBQAEggIAGMOT87GYoQ4E8VfJ1QZGSqsayu+sbpmDT3pDT4IT9L1I

# ObzHa0jTl6YThtqFU5gKLRr5X9dDNzs1qzMZJuCVyaT8tvuwm+x92ipt4ZeMclAp

# z2jsArgtyDUmKjvdbeX3ilI/aQDA4Njb0R93YWvGz/VQjFCjSPkISOzl00bg+wKw

# ipY/mTDlGB5Y77ged1RdVs6uSGlzYq0M0rKRE0G10i/6D8fbJCflj+JLa9EhKaeX

# ocCdgCN5cZaaOGBJrX0Madg8TYaJhK6m8J7h5mzcChLBRuq64ZSDxIvPt41ZdGcz

# OACzmRCehAo6VpJsLYOolR8rm1gtnBaADQLFj+5KzYPrMamb08yuoKPlFAVAUSrp

# EMx4/yg14HJL+v/3xboBUulDHZ2KGT7aZBCEod6ZooIfqWBi15gkoWfSLE401tUn

# khVSfe9HFu02IDENjvYxpUMe4vfQB2JH2SQCO6avx1+SqB2luWDKM0joBZfq0lZv

# H0yMrNgh48f+736fd0CfRhpiCk/Taq5snMYN8+RGsukjjUgcHyz/UPYMfnWNIXjT

# 7Q7SDqCIS6r2wWmG/eIJDs7VKQ6JsFRT8gDimvtiwGEY2HEqpD765xAIdyF6kupq

# PxvpfTyZYEKqRPpSNsRN5L+TAH6vtBG8nyPWHMV4VaSsrOtp6Kzi+n0PqfJEy7A=

# SIG # End signature block