BcContainerHelper

6.1.11-preview2057508

AppHandling/Extract-AppFileToFolder.ps1

                                <# 

 .Synopsis

  Extract the content of an App File to a Folder

 .Description

 .Parameter AppFilename

  Path of the application file

 .Parameter AppFolder

  Path of the folder in which the application File will be unpacked. If this folder exists, the content will be deleted. Default is $appFile.source.

 .Parameter GenerateAppJson

  Add this switch to generate an sample app.json file in the AppFolder, containing the manifest properties.

 .Parameter ExcludeRuntimeProperty

  Add this switch to remove the runtime version from the app.json 

 .Parameter LatestSupportedRuntimeVersion

  Add a version number to fail if the runtime version is higher than this version number

 .Parameter OpenFolder

  Add this parameter to open the destination folder in explorer

 .Example

  Extract-AppFileToFolder -appFilename c:\temp\baseapp.app

#>

function Extract-AppFileToFolder {

    Param (

        [string] $appFilename,

        [string] $appFolder = "",

        [switch] $generateAppJson,

        [switch] $excludeRuntimeProperty,

        [string] $latestSupportedRuntimeVersion,

        [switch] $openFolder

    )

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

try {

    Set-StrictMode -Off

    if ($appFolder -eq "") {

        if ($openFolder) {

            $generateAppJson = $true

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

        }

        else {

            $appFolder = "$($appFilename).source"

        }

    }

    if ("$appFolder" -eq "($bcContainerHelperConfig.hostHelperFolder)" -or "$appFolder" -eq "$($bcContainerHelperConfig.hostHelperFolder)\") {

        throw "The folder specified in ObjectsFolder will be erased, you cannot specify $($bcContainerHelperConfig.hostHelperFolder)"

    }

    if (!(Test-Path $appFileName)) {

        throw "Unable to find $appFileName"

    }

    $appFileName = (Get-Item $appFileName).FullName

    Write-Host "Extracting $appFilename"    

    if (Test-Path $appFolder -PathType Container) {

        Get-ChildItem -Path $appFolder -Include * | Remove-Item -Recurse -Force

    } else {

        New-Item -Path $appFolder -ItemType Directory -Force -ErrorAction Ignore | Out-Null

    }

    try {

        $filestream      = [System.IO.File]::OpenRead($appFileName)

        $binaryReader    = [System.IO.BinaryReader]::new($filestream)

        $magicNumber1    = $binaryReader.ReadUInt32()

        $metadataSize    = $binaryReader.ReadUInt32()

        $metadataVersion = $binaryReader.ReadUInt32()

        $packageId       = [Guid]::new($binaryReader.ReadBytes(16))

        $contentLength   = $binaryReader.ReadInt64()

        $magicNumber2    = $binaryReader.ReadUInt32()

        if ($magicNumber1 -ne 0x5856414E -or 

            $magicNumber2 -ne 0x5856414E -or 

            $metadataVersion -gt 2 -or

            $filestream.Position + $contentLength -gt $filestream.Length)

        {

            throw "Unsupported package format"

        }

        Add-Type -Assembly System.IO.Compression

        Add-Type -Assembly System.IO.Compression.FileSystem

        $content = $binaryReader.ReadBytes($contentLength)

        if ([bitConverter]::ToInt64($content,0) -eq 72057595132988974) {

            throw "You cannot extract a runtime package"

        }

        $memoryStream = [System.IO.MemoryStream]::new($content)

        $zipArchive = [System.IO.Compression.ZipArchive]::new($memoryStream, [System.IO.Compression.ZipArchiveMode]::Read)

        $prevdir = ""

        # If the app file is a ready-to-run app, it has a readytorunappmanifest.json file inside the archive

        $readyToRunAppManifest = $zipArchive.Entries | Where-Object { $_.FullName -eq "readytorunappmanifest.json" }

        if ($readyToRunAppManifest) {

            # Create a temporary folder to extract the ready-to-run app manifest

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

            New-Item -Path $tmpFolder -ItemType Directory -Force | Out-Null

            # Extract the ready-to-run app manifest and get the embedded app file name

            $fullname = Join-Path $tmpFolder "readytorunappmanifest.json"

            [System.IO.Compression.ZipFileExtensions]::ExtractToFile($readyToRunAppManifest, $fullname)

            $embeddedAppFileName = (Get-Content -Path $fullname -Raw | ConvertFrom-Json).EmbeddedAppFileName

            $embeddedAppFile = $zipArchive.Entries | Where-Object { $_.FullName -eq $embeddedAppFileName }

            if (-not $embeddedAppFile) {

                throw "Unable to find embedded app file '$embeddedAppFile' in the ready-to-run app."

            }

            # Create a temporary folder to extract the app file to

            $fullname = Join-Path $tmpFolder ([Uri]::UnescapeDataString($embeddedAppFile.FullName))

            [System.IO.Compression.ZipFileExtensions]::ExtractToFile($embeddedAppFile, $fullname)

            # Close stream and binary reader before recursive call

            $binaryReader.Close()

            $filestream.Close()

            $memoryStream.Close()

            try {

                # Call the Extract-AppFileToFolder function again to extract the content of the app file

                Extract-AppFileToFolder -appFilename $fullname -appFolder $appFolder -generateAppJson:$generateAppJson -excludeRuntimeProperty:$excludeRuntimeProperty -latestSupportedRuntimeVersion:$latestSupportedRuntimeVersion -openFolder:$openFolder

            } finally {

                # Clean up the temporary folder

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

            }

            return

        }

        $zipArchive.Entries | ForEach-Object {

            $fullname = Join-Path $appFolder ([Uri]::UnescapeDataString($_.FullName))

            $dir = [System.IO.Path]::GetDirectoryName($fullname)

            if ($dir -ne $prevdir) {

                if (-not (Test-Path $dir -PathType Container)) {

                    New-Item -Path $dir -ItemType Directory | Out-Null

                }

            }

            $prevdir = $dir

            [System.IO.Compression.ZipFileExtensions]::ExtractToFile($_, $fullname)

        }

    }

    finally {

        $binaryReader.Close()

        $filestream.Close()

    }

    "/addin/src/", "/perm/", "/entit/", "/serv/", "/tabledata/", "/replay/", "/migration/", "/layout/" | ForEach-Object {

        $folder = Join-Path $appFolder $_

        if (Test-Path $folder) {

            @(Get-ChildItem $folder) | ForEach-Object {

                Copy-Item -Path $_.FullName -Destination $appFolder -Recurse -Force

                Remove-Item -Path $_.FullName -Recurse -Force

            }

        }

    }

    if ($generateAppJson) {

        $manifest = [xml](Get-Content -path (Join-Path $appFolder "NavxManifest.xml") -Encoding UTF8)

        $runtimeStr = "$($manifest.Package.App.Attributes | Where-Object { $_.name -eq "Runtime" } | ForEach-Object { $_.Value } )"

        if ($runtimeStr) {

            $runtime = [System.Version]$runtimeStr

        }

        else {

            $runtime = [System.Version]"9.2"

        }

        $application = "$($manifest.Package.App.Attributes | Where-Object { $_.name -eq "Application" } | ForEach-Object { $_.Value } )"

        $appJson = [ordered]@{

            "id" = $manifest.Package.App.Id

            "name" = $manifest.Package.App.Name

            "publisher" = $manifest.Package.App.Publisher

            "version" = $manifest.Package.App.Version

            "brief" = "$($manifest.Package.App.Attributes | Where-Object { $_.name -eq "Brief" } | ForEach-Object { $_.Value } )"

            "description" = "$($manifest.Package.App.Attributes | Where-Object { $_.name -eq "Description" } | ForEach-Object { $_.Value } )"

            "platform" = "$($manifest.Package.App.Attributes | Where-Object { $_.name -eq "Platform" } | ForEach-Object { $_.Value } )"

        }

        if ($application) {

            $appJson += @{

                "application" = $application

            }

        }

        if ($latestSupportedRuntimeVersion -and $runtimeStr) {

            Write-Host "App Runtime Version is '$runtimeStr'"

            if ($runtime -gt [System.Version]$latestSupportedRuntimeVersion) {

                throw "App is using runtime version $runtimeStr, latest supported runtime version is $latestSupportedRuntimeVersion."

            }

        }

        if ($excludeRuntimeProperty.IsPresent) {

            Write-Host "Excluding Runtime Version from app.json"

        }

        else {

            $appJson += @{

                "runtime" = "$($runtime.Major).$($runtime.Minor)"

            }

        }

        $appJson += [ordered]@{

            "logo" = "$($manifest.Package.App.Attributes | Where-Object { $_.name -eq "Logo" } | ForEach-Object { $_.Value } )".TrimStart('/')

            "url" = "$($manifest.Package.App.Attributes | Where-Object { $_.name -eq "Url" } | ForEach-Object { $_.Value } )"

            "EULA" = "$($manifest.Package.App.Attributes | Where-Object { $_.name -eq "EULA" } | ForEach-Object { $_.Value } )"

            "privacyStatement" = "$($manifest.Package.App.Attributes | Where-Object { $_.name -eq "PrivacyStatement" } | ForEach-Object { $_.Value } )"

            "help" = "$($manifest.Package.App.Attributes | Where-Object { $_.name -eq "Help" } | ForEach-Object { $_.Value } )"

            "target" = "$($manifest.Package.App.Attributes | Where-Object { $_.name -eq "target" } | ForEach-Object { $_.Value } )"

            "screenshots" = @()

            "dependencies" = @()

            "idRanges" = @()

            "features" = @()

        }

        if ($runtime -lt [System.Version]"8.0")  {

            $appJson += @{

                "showMyCode" = "$($manifest.Package.App.Attributes | Where-Object { $_.name -eq "ShowMyCode" } | ForEach-Object { $_.Value } )" -eq "True"

            }

        }

        else {

            $manifest.Package.ChildNodes | Where-Object { $_.name -eq "ResourceExposurePolicy" } | ForEach-Object { 

                $resExp = [ordered]@{}

                "allowDebugging", "allowDownloadingSource", "includeSourceInSymbolFile","applyToDevExtension" | ForEach-Object {

                    $prop = $_

                    if ($manifest.Package.ResourceExposurePolicy.Attributes | Where-Object { $_.name -eq $prop } | ForEach-Object { $_.Value -eq "true" }) {

                        $resExp += @{

                            "$prop" = $true

                        }

                    }

                }

                $appJson += @{ "resourceExposurePolicy" = $resExp }

            }

        }

        if ($runtime -ge [System.Version]"12.0")  {

            $manifest.Package.ChildNodes | Where-Object { $_.name -eq "Source" } | ForEach-Object { 

                $node = $_

                $ht = [ordered]@{}

                "repositoryUrl", "commit" | ForEach-Object {

                    $prop = $_

                    if ($node) {

                        $node.Attributes | Where-Object { $_.name -eq $prop } | ForEach-Object {

                            $ht += @{

                                "$prop" = $_.Value.Trim('"')

                            }

                        }

                    }

                }

                $appJson += @{ "source" = $ht }

            }

            $manifest.Package.ChildNodes | Where-Object { $_.name -eq "Build" } | ForEach-Object { 

                $node = $_

                $ht = [ordered]@{}

                "by", "url" | ForEach-Object {

                    $prop = $_

                    if ($node) {

                        $node.Attributes | Where-Object { $_.name -eq $prop } | ForEach-Object {

                            $ht += @{

                                "$prop" = $_.Value.Trim('"')

                            }

                        }

                    }

                }

                $appJson += @{ "build" = $ht }

            }

        }

        if ($runtime -ge [System.Version]"5.0")  {

            $appInsightsKey = $manifest.Package.App.Attributes | Where-Object { $_.name -eq "applicationInsightsKey" } | ForEach-Object { $_.Value } 

            if ($appInsightsKey) {

                $appJson += @{

                    "applicationInsightsKey" = "$appInsightsKey"

                }

            }

            elseif ($runtime -ge [System.Version]"7.2")  {

                $appInsightsConnectionString = $manifest.Package.App.Attributes | Where-Object { $_.name -eq "applicationInsightsConnectionString" } | ForEach-Object { $_.Value } 

                if ($appInsightsConnectionString) {

                    $appJson += @{

                        "applicationInsightsConnectionString" = "$appInsightsConnectionString"

                    }

                }

            }

        }

        $contextSensitiveHelpUrl = "$($manifest.Package.App.Attributes | Where-Object { $_.name -eq "contextSensitiveHelpUrl" } | ForEach-Object { $_.Value } )"

        if ($contextSensitiveHelpUrl) {

            $appJson += @{

                "contextSensitiveHelpUrl" = $contextSensitiveHelpUrl

            }

        }

        $manifest.Package.ChildNodes | Where-Object { $_.name -eq "Dependencies" } | ForEach-Object { 

            $_.GetEnumerator() | ForEach-Object {

                if ($runtime -gt [System.Version]"4.1") {

                    $propname = "id"

                }

                else {

                    $propname = "appId"

                }

                $appJson.dependencies += [ordered]@{

                    "$propname" = $_.Id

                    "publisher" = $_.publisher

                    "name" = $_.name

                    "version" = $_.minVersion

                }

            }

        }

        $manifest.Package.ChildNodes | Where-Object { $_.name -eq "IdRanges" } | ForEach-Object { 

            $_.GetEnumerator() | ForEach-Object {

                $appJson.idRanges += [ordered]@{

                    "from" = [Int]::Parse($_.MinObjectId)

                    "to" = [Int]::Parse($_.MaxObjectId)

                }

            }

        }

        $manifest.Package.ChildNodes | Where-Object { $_.name -eq "Features" } | ForEach-Object { 

            $_.GetEnumerator() | ForEach-Object {

                $feature = $_.'#text'

                'ExcludeGeneratedTranslations','GenerateCaptions','GenerateLockedTranslations','NoImplicitWith','TranslationFile' | ForEach-Object {

                    if ($feature -eq $_) {

                        $appJson.features += $_

                    }

                }

            }

        }

        $manifest.Package.ChildNodes | Where-Object { $_.name -eq "SupportedLocales" } | ForEach-Object { 

            $first = $true

            $_.GetEnumerator() | ForEach-Object {

                if ($first) {

                    $appJson += @{ "supportedLocales" = @() }

                    $first = $false

                }

                $appJson.supportedLocales += @($_.Local)

            }

        }

        if ($runtime -ge [System.Version]"4.0")  {

            $first = $true

            $manifest.Package.ChildNodes | Where-Object { $_.name -eq "internalsVisibleTo" } | ForEach-Object { 

                if ($first) {

                    $appJson += @{

                        "internalsVisibleTo" = @()

                    }

                }

                $_.GetEnumerator() | ForEach-Object {

                    $appJson.internalsVisibleTo += [ordered]@{

                        "id" = $_.Id

                        "publisher" = $_.publisher

                        "name" = $_.name

                    }

                }

            }

        }

        if ($runtime -ge [System.Version]"6.0") {

            $manifest.Package.ChildNodes | Where-Object { $_.name -eq "preprocessorSymbols" } | ForEach-Object { 

                $first = $true

                $_.GetEnumerator() | ForEach-Object {

                    if ($first) {

                        $appJson += @{ "preprocessorSymbols" = @() }

                        $first = $false

                    }

                    $appJson.preprocessorSymbols += @($_.Name)

                }

            }

            $appJson += @{ "keyVaultUrls" = @() }

            $manifest.Package.ChildNodes | Where-Object { $_.name -eq "KeyVaultUrls" } | ForEach-Object { 

                $_.GetEnumerator() | ForEach-Object {

                    $appJson.keyVaultUrls += @($_.Name)

                }

            }

        }

        $appJson | convertTo-json | Set-Content -Path (Join-Path $appFolder "app.json") -Encoding UTF8

    }

    if ($openFolder) {

        Start-Process $appFolder

    }

}

catch {

    TrackException -telemetryScope $telemetryScope -errorRecord $_

    throw

}

finally {

    Set-StrictMode -Version 2.0

    TrackTrace -telemetryScope $telemetryScope

}

}

Export-ModuleMember -Function Extract-AppFileToFolder

# SIG # Begin signature block

# MIIoUgYJKoZIhvcNAQcCoIIoQzCCKD8CAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCzEDyDBOpjZpxN

# rrUYiHCrHBVtZcfBzVRqEeygjOVf26CCDYUwggYDMIID66ADAgECAhMzAAAEhJji

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

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p

# Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAASEmOIS4HijMV0AAAAA

# BIQwDQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw

# HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIDJU

# 9P9D52AuxtUfmnObA9+3SOAaYMX+BuQrlRluqG/sMEIGCisGAQQBgjcCAQwxNDAy

# oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20wDQYJKoZIhvcNAQEBBQAEggEAVDIC0kRXIbbf64N2dUXeYPW8qXc2Dl3kRfCB

# 4Tl+ulmV/gb4XAqobiwYRr3zN/rSNPgfWCUBWqkMr0JEFhOeRbEtV90gH/WMN7WT

# 1130i/emJPovl12aD9D0bK3j21HotRbdZCrfADv4trwNZu63Nw17cn55a/uGTA9e

# 3QrfGHpSM21W4O9HW+bPHxipVWoItntUk16TKuL409GQ0OLIC5YkPQTRzDmwc3ob

# 5vG9JaYgV08AUbqQbda67hOEDYj7oF4qV0Ub1MIsg15kpT0MkPx2U03TEOp8MS4y

# jSGn66W4K0dabXS6jn/StIb/IR5fZs8t8y0CmJhylYcPBEXDoaGCF60wghepBgor

# BgEEAYI3AwMBMYIXmTCCF5UGCSqGSIb3DQEHAqCCF4YwgheCAgEDMQ8wDQYJYIZI

# AWUDBAIBBQAwggFaBgsqhkiG9w0BCRABBKCCAUkEggFFMIIBQQIBAQYKKwYBBAGE

# WQoDATAxMA0GCWCGSAFlAwQCAQUABCBqJDjq97EliKdQdofZOBHVVxx1qhS1WNsf

# oCcE/hmHxAIGaUL53xZ9GBMyMDI2MDExOTEwMTkwMi45MDRaMASAAgH0oIHZpIHW

# MIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQL

# EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsT

# Hm5TaGllbGQgVFNTIEVTTjoyQTFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9z

# b2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEfswggcoMIIFEKADAgECAhMzAAACEKvN

# 5BYY7zmwAAEAAAIQMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w

# IFBDQSAyMDEwMB4XDTI1MDgxNDE4NDgxMloXDTI2MTExMzE4NDgxMlowgdMxCzAJ

# BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jv

# c29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVs

# ZCBUU1MgRVNOOjJBMUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGlt

# ZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA

# jcc4q057ZwIgpKu4pTXWLejvYEduRf+1mIpbiJEMFWWmU2xpip+zK7xFxKGB1Ccl

# UXBU0/ZQZ6LG8H0gI7yvosrsPEI1DPB/XccGCvswKbAKckngOuGTEPGk7K/vEZa9

# h0Xt02b7m2n9MdIjkLrFl0pDriKyz0QHGpdh93X6+NApfE1TL24Vo0xkeoFGpL3r

# X9gXhIOF59EMnTd2o45FW/oxMgY9q0y0jGO0HrCLTCZr50e7TZRSNYAy2lyKbvKI

# 2MKlN1wLzJvZbbc//L3s1q3J6KhS0KC2VNEImYdFgVkJej4zZqHfScTbx9hjFgFp

# VkJl4xH5VJ8tyJdXE9+vU0k9AaT2QP1Zm3WQmXedSoLjjI7LWznuHwnoGIXLiJMQ

# zPqKqRIFL3wzcrDrZeWgtAdBPbipglZ5CQns6Baj5Mb6a/EZC9G3faJYK5QVHeE6

# eLoSEwp1dz5WurLXNPsp0VWplpl/FJb8jrRT/jOoHu85qRcdYpgByU9W7IWPdrth

# myfqeAw0omVWN5JxcogYbLo2pANJHlsMdWnxIpN5YwHbGEPCuosBHPk2Xd9+E/pZ

# PQUR6v+D85eEN5A/ZM/xiPpxa8dJZ87BpTvui7/2uflUMJf2Yc9ZLPgEdhQQo0Lw

# MDSTDT48y3sV7Pdo+g5q+MqnJztN/6qt1cgUTe9u+ykCAwEAAaOCAUkwggFFMB0G

# A1UdDgQWBBSe42+FrpdF2avbUhlk86BLSH5kejAfBgNVHSMEGDAWgBSfpxVdAF5i

# XYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQhk5odHRwOi8vd3d3Lm1pY3Jv

# c29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENB

# JTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwGCCsGAQUFBzAChlBodHRw

# Oi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMFRp

# bWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNVHRMBAf8EAjAAMBYGA1Ud

# JQEB/wQMMAoGCCsGAQUFBwMIMA4GA1UdDwEB/wQEAwIHgDANBgkqhkiG9w0BAQsF

# AAOCAgEAvs4rO3oo8czOrxPqnnSEkUVq718QzlrIiy7/EW7JmQXsJoFxHWUF0Ux0

# PDyKFDRXPJVv29F7kpJkBJJmcQg5HQV7blUXIMWQ1qX0KdtFQXI/MRL77Z+pK5x1

# jX+tbRkA7a5Ft7vWuRoAEi02HpFH5m/Akh/dfsbx8wOpecJbYvuHuy4aG0/tGzOW

# FCxMMNhGAIJ4qdV87JnY/uMBmiodlm+Gz357XWW5tg3HrtNZXuQ0tWUv26ud4nGK

# Jo/oLZHP75p4Rpt7dMdYKUF9AuVFBwxYZYpvgk12tfK+/yOwq84/fjXVCdM83Qna

# wtbenbk/lnbc9KsZom+GnvA4itAMUpSXFWrcRkqdUQLN+JrG6fPBoV8+D8U2Q2F4

# XkiCR6EU9JzYKwTuvL6t3nFuxnkLdNjbTg2/yv2j3WaDuCK5lSPgsndIiH6Bku2U

# i3A0aUo6D9z9v+XEuBs9ioVJaOjf/z+Urqg7ESnxG0/T1dKci7vLQ2XNgWFYO+/O

# lDjtGoma1ijX4m14N9qgrXTuWEGwgC7hhBgp3id/LAOf9BSTWA5lBrilsEoexXBr

# On/1wM3rjG0hIsxvF5/YOK78mVRGY6Y7zYJ+uXt4OTOFBwadPv8MklreQZLPnQPt

# iwop4rlLUYaPCiD4YUqRNbLp8Sgyo9g0iAcZYznTuc+8Q8ZIrgwwggdxMIIFWaAD

# AgECAhMzAAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYD

# VQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEe

# MBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3Nv

# ZnQgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAxMDAeFw0yMTA5MzAxODIy

# MjVaFw0zMDA5MzAxODMyMjVaMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo

# aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y

# cG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw

# MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA5OGmTOe0ciELeaLL1yR5

# vQ7VgtP97pwHB9KpbE51yMo1V/YBf2xK4OK9uT4XYDP/XE/HZveVU3Fa4n5KWv64

# NmeFRiMMtY0Tz3cywBAY6GB9alKDRLemjkZrBxTzxXb1hlDcwUTIcVxRMTegCjhu

# je3XD9gmU3w5YQJ6xKr9cmmvHaus9ja+NSZk2pg7uhp7M62AW36MEBydUv626GIl

# 3GoPz130/o5Tz9bshVZN7928jaTjkY+yOSxRnOlwaQ3KNi1wjjHINSi947SHJMPg

# yY9+tVSP3PoFVZhtaDuaRr3tpK56KTesy+uDRedGbsoy1cCGMFxPLOJiss254o2I

# 5JasAUq7vnGpF1tnYN74kpEeHT39IM9zfUGaRnXNxF803RKJ1v2lIH1+/NmeRd+2

# ci/bfV+AutuqfjbsNkz2K26oElHovwUDo9Fzpk03dJQcNIIP8BDyt0cY7afomXw/

# TNuvXsLz1dhzPUNOwTM5TI4CvEJoLhDqhFFG4tG9ahhaYQFzymeiXtcodgLiMxhy

# 16cg8ML6EgrXY28MyTZki1ugpoMhXV8wdJGUlNi5UPkLiWHzNgY1GIRH29wb0f2y

# 1BzFa/ZcUlFdEtsluq9QBXpsxREdcu+N+VLEhReTwDwV2xo3xwgVGD94q0W29R6H

# XtqPnhZyacaue7e3PmriLq0CAwEAAaOCAd0wggHZMBIGCSsGAQQBgjcVAQQFAgMB

# AAEwIwYJKwYBBAGCNxUCBBYEFCqnUv5kxJq+gpE8RjUpzxD/LwTuMB0GA1UdDgQW

# BBSfpxVdAF5iXYP05dJlpxtTNRnpcjBcBgNVHSAEVTBTMFEGDCsGAQQBgjdMg30B

# ATBBMD8GCCsGAQUFBwIBFjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3Bz

# L0RvY3MvUmVwb3NpdG9yeS5odG0wEwYDVR0lBAwwCgYIKwYBBQUHAwgwGQYJKwYB

# BAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMB

# Af8wHwYDVR0jBBgwFoAU1fZWy4/oolxiaNE9lJBb186aGMQwVgYDVR0fBE8wTTBL

# oEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMv

# TWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggr

# BgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNS

# b29DZXJBdXRfMjAxMC0wNi0yMy5jcnQwDQYJKoZIhvcNAQELBQADggIBAJ1Vffwq

# reEsH2cBMSRb4Z5yS/ypb+pcFLY+TkdkeLEGk5c9MTO1OdfCcTY/2mRsfNB1OW27

# DzHkwo/7bNGhlBgi7ulmZzpTTd2YurYeeNg2LpypglYAA7AFvonoaeC6Ce5732pv

# vinLbtg/SHUB2RjebYIM9W0jVOR4U3UkV7ndn/OOPcbzaN9l9qRWqveVtihVJ9Ak

# vUCgvxm2EhIRXT0n4ECWOKz3+SmJw7wXsFSFQrP8DJ6LGYnn8AtqgcKBGUIZUnWK

# NsIdw2FzLixre24/LAl4FOmRsqlb30mjdAy87JGA0j3mSj5mO0+7hvoyGtmW9I/2

# kQH2zsZ0/fZMcm8Qq3UwxTSwethQ/gpY3UA8x1RtnWN0SCyxTkctwRQEcb9k+SS+

# c23Kjgm9swFXSVRk2XPXfx5bRAGOWhmRaw2fpCjcZxkoJLo4S5pu+yFUa2pFEUep

# 8beuyOiJXk+d0tBMdrVXVAmxaQFEfnyhYWxz/gq77EFmPWn9y8FBSX5+k77L+Dvk

# txW/tM4+pTFRhLy/AsGConsXHRWJjXD+57XQKBqJC4822rpM+Zv/Cuk0+CQ1Zyvg

# DbjmjJnW4SLq8CdCPSWU5nR0W2rRnj7tfqAxM328y+l7vzhwRNGQ8cirOoo6CGJ/

# 2XBjU02N7oJtpQUQwXEGahC0HVUzWLOhcGbyoYIDVjCCAj4CAQEwggEBoYHZpIHW

# MIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQL

# EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsT

# Hm5TaGllbGQgVFNTIEVTTjoyQTFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9z

# b2Z0IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcGBSsOAwIaAxUAOsyf2b6riPKn

# nXlIgIL2f53PUsKggYMwgYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz

# aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv

# cnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAx

# MDANBgkqhkiG9w0BAQsFAAIFAO0YT1AwIhgPMjAyNjAxMTkwNjM2MDBaGA8yMDI2

# MDEyMDA2MzYwMFowdDA6BgorBgEEAYRZCgQBMSwwKjAKAgUA7RhPUAIBADAHAgEA

# AgIx0zAHAgEAAgIUFDAKAgUA7Rmg0AIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgor

# BgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBCwUA

# A4IBAQDInW/iz5YGePvnP5/qCHmh/Ycm+hizjoxjuz1od+X1mXN+E/9UY9feSf4L

# 2bHFLiByTwgn7m5CwfmyYaLbHA25hS0ymEvAKj68z0Q4dUxY8CoOyEA8DezXhpPi

# epo+ZzrWKIcSjR5heuB0jYE4fTOhVvICFb+/7EYz7UObLM4AucjGbgiI5QlzcZ37

# ZDO6avLRqkI2wxzqMgaptDD0D2Q9hlAZKo6Y5zmKlbpSuUsc14U5LVnuJcthWUSq

# v3U0/shnUgNyZLGtIasdUVdtlNL4gxLL0FmSd9FT8jbX9eczkSOwQg1XtV5FNCAR

# W0fnvUpVdUw4Pt8cIhGtsROAjU9ZMYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMC

# VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV

# BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp

# bWUtU3RhbXAgUENBIDIwMTACEzMAAAIQq83kFhjvObAAAQAAAhAwDQYJYIZIAWUD

# BAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0B

# CQQxIgQgo45vUNrVYk4Pzz1Zzkx6Oy1bRYevwg/YEFhJynFtxScwgfoGCyqGSIb3

# DQEJEAIvMYHqMIHnMIHkMIG9BCDD1SHufsjzY59S1iHUQY9hnsKSrJPg5a9Mc4Yn

# GmPHxjCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u

# MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp

# b24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAAC

# EKvN5BYY7zmwAAEAAAIQMCIEIDxBcEU1F9GxfEkpOjieca+EbwRuCNRB+h8ZMgMt

# BeTDMA0GCSqGSIb3DQEBCwUABIICAFXPssIs8MjXkoEN65ew3+2egiN8PCq/9MNn

# iMQNG9RmkRvJFPWox6Mg6JFuq0btYg6OPlLSHCmU3zxxikQH2ZfK1WcnI9fdlGMr

# 745dnMGeNaerYygOqR88PIFJhG8BFnp8eLIZN35zcQ5OAVxwXHK65Cl4ChrUR+qO

# nNvR0vfKs2xoVdvSWMjc/zM8xSnx8Xx+QX0scsZdySoc+f5elxyyViz2vohYKCo3

# 3XrI3r1CbrZlu+3FNls6CUcaK1aJSxt5+n6GQmr5+f4AOf4hwGLEOkAuD/6bo2M3

# 3MOXr9llHG0fh4KuYWGwQJt/dLnQdfpmgp4WcBua5qkYUiKsH/aLp18wLyNAlmne

# PlYBvjDd1svDm5/PtIfqsd+DN6wQp/IxIHIgqfxx5NH9A+x2PU1HhM1aDx0zyQ7i

# grZXZxwOzigJmbCXNPbDoeq75rfz6+SyoLAyZLIPTLEATBr0I1vka+HNstoh4SRk

# aOLvrSqQpctu0el+sRsllUthzdMqjVqFoYY3r7c7hK/+1Ub65j1iJtZZXvRTmsZf

# eKTPmqxZR13p13pweDb4VwlyaSPb8IGwzPNi2ohztnQHyMIRxxUnWx6v4XuMKeol

# 0C0L78idSj/itVudfPtLnJcmNZktaCYdSIZq7P8/IK+qnqGppAUyK2YcN3J9Qs79

# MUv6kNT0

# SIG # End signature block