M365Documentation

3.2.0

Internal/Translation/Optimize-M365DocSection.ps1

                                Function Optimize-M365DocSection(){

    <#

    .DESCRIPTION

    This Script translates as many properties from the Graph API to names used in the UI.

    .PARAMETER Data

    M365 documentation section object which should be optimized.

    .PARAMETER ExcludeValues

    All values are replaced with an empty string.

    .EXAMPLE 

    $docNew = Optimize-M365DocSection -Section $DocSection

    .NOTES

    Author: Thomas Kurth/baseVISION

    Date:   05.04.2021

    #>

    [OutputType('DocSection')]

    [CmdletBinding()]

    Param(

        [Parameter(ValueFromPipeline,Mandatory)]

        [DocSection]$Section,

        [switch]$UseTranslationFiles,

        [switch]$UseCamelCase,

        [int]$MaxStringLengthSettings = 350,

        [switch]$ExcludeEmptyValues,

        [switch]$ExcludeValues,

        [String[]]$ExcludeProperties

    )

    Begin {

    }

    Process {

        ## Manual Variable Definition

        ########################################################

        #$DebugPreference = "Continue"

        $ScriptName = "Optimize-M365DocSection"

        #region Initialization

        ########################################################

        $DataNew = New-Object DocSection

        $DataNew.Title = $Section.Title

        $DataNew.Text = $Section.Text

        $DataNew.SubSections = @()

        $DataNew.Objects = @()

        $DataNew.Transpose = $Section.Transpose

        #endregion

        #region Translate

        ########################################################

        foreach($Section2 in $Section.SubSections){

            $DataNew.SubSections += Optimize-M365DocSection -Section $Section2 -UseTranslationFiles:$UseTranslationFiles -UseCamelCase:$UseCamelCase -MaxStringLengthSettings $MaxStringLengthSettings -ExcludeEmptyValues:$ExcludeEmptyValues -ExcludeValues:$ExcludeValues -ExcludeProperties $ExcludeProperties

        }

        foreach($Object in $Section.Objects){

            $ObjectNew = New-Object -Type PSObject

            #Prepare File based translation

            $TypeName = $Object.'@odata.type'

            $TranslationFile = "$PSScriptRoot\..\..\Data\LabelTranslation\$TypeName.json"

            $translateJson = Get-Content $TranslationFile -ErrorAction SilentlyContinue

            if($null -eq $translateJson){

                $translateJson = "{}"

            }

            $translation = $translateJson | ConvertFrom-Json

            foreach($p in $Object.psobject.properties) {   

                # Skip excluded properties or empty values if specified.

                if($ExcludeProperties -contains $p.Name){

                    continue

                }

                if([string]::IsNullOrWhiteSpace($p.Value) -and $ExcludeEmptyValues){

                    continue

                }

                $Translated = $false

                $Name = $p.Name

                $Value = $p.Value

                #File based translation enabled and odata type available

                if($UseTranslationFiles -and (-not ([String]::IsNullOrWhiteSpace($TypeName)))){

                    if([String]::IsNullOrWhiteSpace($translation."$($p.Name)")){

                        $TranslationValue = switch($p.Name){

                            "displayName" { "Displayname" }

                            "lastModifiedDateTime" { "Modified at" }

                            "@odata.type" { "OData Type" }

                            "supportsScopeTags" { "Support for Scope Tags" }

                            "roleScopeTagIds" {  "Role Scopes Tags" }

                            "deviceManagementApplicabilityRuleOsEdition" {  "Applicability OS Edition" }

                            "deviceManagementApplicabilityRuleOsVersion" {  "Applicability OS Version" }

                            "deviceManagementApplicabilityRuleDeviceMode" {  "Applicability Device Mode" }

                            "createdDateTime" {  "Created at" }

                            "description" {  "Description" }

                            "version" {  "Version" }

                            "id" {'ID'}

                            default { '' }   

                        }

                        if(-not ([String]::IsNullOrWhiteSpace($TranslationValue))){

                            $Name = $TranslationValue

                            $Translated = $true

                        }

                        if([String]::IsNullOrWhiteSpace($TranslationValue)){

                            $ConfigSection = " "

                        } else {

                            $ConfigSection = "Metadata"

                        }

                        if($p.TypeNameOfValue -eq "System.Boolean"){

                            $TranslationObject = New-Object PSObject -Property @{

                                Name = $TranslationValue

                                Section = $ConfigSection

                                DataType = $p.TypeNameOfValue

                                ValueTrue = "Block"

                                ValueFalse = "Not Configured"

                            }

                        } else {

                            $TranslationObject = New-Object PSObject -Property @{

                                Name = $TranslationValue

                                Section = $ConfigSection

                                DataType = $p.TypeNameOfValue

                            }

                        }

                        $translation | Add-Member Noteproperty -Name $p.Name -Value $TranslationObject -Force 

                        $translation | ConvertTo-Json | Out-File -FilePath $TranslationFile -Force

                        #Variable set for user information in main function

                        $Script:NewTranslationFiles += $TranslationFile

                    } else { 

                        #Only use translated value if not empty  

                        if(-not ([String]::IsNullOrWhiteSpace($translation."$($p.Name)".Name))){

                            if(([String]::IsNullOrWhiteSpace($translation."$($p.Name)".Section))){

                                $Name = "$($translation."$($p.Name)".Name)"

                            } else {

                                $Name = "$($translation."$($p.Name)".Section)\$($translation."$($p.Name)".Name)"

                                $Name = $Name.Replace("/","\")

                            }

                            $Translated = $true

                        }

                    }

                }

                #Camelcase Translation

                if($Translated -eq $false -and $UseCamelCase){

                    #Only use Camel Case converter if not already translated.

                    $TempName = Convert-CamelCaseToDisplayName -Value $p.Name

                    if(-not ([String]::IsNullOrWhiteSpace($TempName))){

                        $Name = $TempName

                    } 

                }

                # Optimize Value

                if($p.TypeNameOfValue -eq "System.Boolean"){

                    if(-not ([String]::IsNullOrWhiteSpace($translation."$($p.Name)".Name))){

                        if($p.Value -eq $true){

                            $Value = $translation."$($p.Name)".ValueTrue

                        } else {

                            $Value = $translation."$($p.Name)".ValueFalse

                        }

                    }

                } else {

                    $TempValue = Format-MsGraphData "$($p.Value)"

                    if($TempValue.Length -gt $MaxStringLengthSettings){

                        $Value = "$($TempValue.substring(0, $MaxStringLengthSettings))..."

                    } else {

                        $Value = "$($TempValue) "

                    }

                }

                if($null -eq $Value){

                    $Value = ""

                } else {

                    if($value.GetType().Name -ne "Boolean" -and $value.GetType().Name -ne "System.Boolean"){

                        $value = $value.Trim()

                    }

                }

                if(($ExcludeValues -and $p.Name -in @("Value","ValueName") -and $DataNew.Title -eq "Settings") -or ($ExcludeValues -and $DataNew.Title -ne "Settings")){

                    $Value = ""

                }

                try{

                    $ObjectNew | Add-Member Noteproperty $Name $Value -ErrorAction Stop

                } catch {

                    $ObjectNew | Add-Member Noteproperty "$Name`2" $Value -ErrorAction Stop

                }     

            }

            $DataNew.Objects += $ObjectNew

        }

        #endregion

        #region Finishing

        ########################################################

        return $DataNew

        if($Script:NewTranslationFiles.Count -gt 0 -and $Script:UseTranslation){

            Write-Information "You used the option to translate API properties. Some of the configurations of your tenant could not be translated because translations are missing."

            foreach($file in ($Script:NewTranslationFiles | Select-Object -Unique)){

                Write-Information " - $($file.Replace('Internal\..\',''))"

            }

            Write-Information "You can support the project by translating and submitting the files as issue on the project page. Then it will be included for the future."

            Write-Information "Follow the guide here https://github.com/ThomasKur/IntuneDocumentation/blob/master/AddTranslation.md" 

        }

        Write-Information "End Script $Scriptname"

        #endregion

    }

    End {

    }

}

# SIG # Begin signature block

# MIIjYwYJKoZIhvcNAQcCoIIjVDCCI1ACAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUscGmDZV4nN2QQi39abRtwQ59

# JUWggh2BMIIFMDCCBBigAwIBAgIQBAkYG1/Vu2Z1U0O1b5VQCDANBgkqhkiG9w0B

# AQsFADBlMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYD

# VQQLExB3d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVk

# IElEIFJvb3QgQ0EwHhcNMTMxMDIyMTIwMDAwWhcNMjgxMDIyMTIwMDAwWjByMQsw

# CQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cu

# ZGlnaWNlcnQuY29tMTEwLwYDVQQDEyhEaWdpQ2VydCBTSEEyIEFzc3VyZWQgSUQg

# Q29kZSBTaWduaW5nIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA

# +NOzHH8OEa9ndwfTCzFJGc/Q+0WZsTrbRPV/5aid2zLXcep2nQUut4/6kkPApfmJ

# 1DcZ17aq8JyGpdglrA55KDp+6dFn08b7KSfH03sjlOSRI5aQd4L5oYQjZhJUM1B0

# sSgmuyRpwsJS8hRniolF1C2ho+mILCCVrhxKhwjfDPXiTWAYvqrEsq5wMWYzcT6s

# cKKrzn/pfMuSoeU7MRzP6vIK5Fe7SrXpdOYr/mzLfnQ5Ng2Q7+S1TqSp6moKq4Tz

# rGdOtcT3jNEgJSPrCGQ+UpbB8g8S9MWOD8Gi6CxR93O8vYWxYoNzQYIH5DiLanMg

# 0A9kczyen6Yzqf0Z3yWT0QIDAQABo4IBzTCCAckwEgYDVR0TAQH/BAgwBgEB/wIB

# ADAOBgNVHQ8BAf8EBAMCAYYwEwYDVR0lBAwwCgYIKwYBBQUHAwMweQYIKwYBBQUH

# AQEEbTBrMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wQwYI

# KwYBBQUHMAKGN2h0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFz

# c3VyZWRJRFJvb3RDQS5jcnQwgYEGA1UdHwR6MHgwOqA4oDaGNGh0dHA6Ly9jcmw0

# LmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcmwwOqA4oDaG

# NGh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RD

# QS5jcmwwTwYDVR0gBEgwRjA4BgpghkgBhv1sAAIEMCowKAYIKwYBBQUHAgEWHGh0

# dHBzOi8vd3d3LmRpZ2ljZXJ0LmNvbS9DUFMwCgYIYIZIAYb9bAMwHQYDVR0OBBYE

# FFrEuXsqCqOl6nEDwGD5LfZldQ5YMB8GA1UdIwQYMBaAFEXroq/0ksuCMS1Ri6en

# IZ3zbcgPMA0GCSqGSIb3DQEBCwUAA4IBAQA+7A1aJLPzItEVyCx8JSl2qB1dHC06

# GsTvMGHXfgtg/cM9D8Svi/3vKt8gVTew4fbRknUPUbRupY5a4l4kgU4QpO4/cY5j

# DhNLrddfRHnzNhQGivecRk5c/5CxGwcOkRX7uq+1UcKNJK4kxscnKqEpKBo6cSgC

# PC6Ro8AlEeKcFEehemhor5unXCBc2XGxDI+7qPjFEmifz0DLQESlE/DmZAwlCEIy

# sjaKJAL+L3J+HNdJRZboWR3p+nRka7LrZkPas7CM1ekN3fYBIM6ZMWM9CBoYs4Gb

# T8aTEAb8B4H6i9r5gkn3Ym6hU/oSlBiFLpKR6mhsRDKyZqHnGKSaZFHvMIIFQjCC

# BCqgAwIBAgIQA/0ggFQEDhseOlG0BHuf0TANBgkqhkiG9w0BAQsFADByMQswCQYD

# VQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGln

# aWNlcnQuY29tMTEwLwYDVQQDEyhEaWdpQ2VydCBTSEEyIEFzc3VyZWQgSUQgQ29k

# ZSBTaWduaW5nIENBMB4XDTIwMTExNzAwMDAwMFoXDTIzMTEyMTIzNTk1OVowfzEL

# MAkGA1UEBhMCQ0gxEjAQBgNVBAgTCVNvbG90aHVybjERMA8GA1UEBwwIRMOkbmlr

# ZW4xFjAUBgNVBAoTDWJhc2VWSVNJT04gQUcxGTAXBgNVBAsTEEludGVybmFsIFNj

# cmlwdHMxFjAUBgNVBAMTDWJhc2VWSVNJT04gQUcwggEiMA0GCSqGSIb3DQEBAQUA

# A4IBDwAwggEKAoIBAQDqZTpY3kwE9qEek50BKNM79X1Wkc5gOBynXJHmUBReFEzO

# 1pLqHwxFfvuvRl0fiyJKuTPLuIyszMoXtD7RWDKR9N/3u6LgtUhm/izh2u0UncDZ

# 4bouw36VnD17Xn3Ox07SRzBp9UVinpN69t2t1S/PNMlNLSHDnFA6tPp4X9jHETL0

# 1q3nkduweYOAjBmShGwA3+MdWTUrW8bpDiQRH80xwJKBNtBjpyr7kIDDal+8Ai9A

# /zwez6IA1lOJI5E4pqSPmzJOrz1kxNbxBl5OEG/2J+LulY221Oa3m68BPRa+0KMG

# 89wyK/WLpa3t2mgpZnG8EUdbQYah1H2TOjSgp295AgMBAAGjggHFMIIBwTAfBgNV

# HSMEGDAWgBRaxLl7KgqjpepxA8Bg+S32ZXUOWDAdBgNVHQ4EFgQUgO/Fbqz1/e4B

# i63rBg2M3Uehu6AwDgYDVR0PAQH/BAQDAgeAMBMGA1UdJQQMMAoGCCsGAQUFBwMD

# MHcGA1UdHwRwMG4wNaAzoDGGL2h0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9zaGEy

# LWFzc3VyZWQtY3MtZzEuY3JsMDWgM6Axhi9odHRwOi8vY3JsNC5kaWdpY2VydC5j

# b20vc2hhMi1hc3N1cmVkLWNzLWcxLmNybDBMBgNVHSAERTBDMDcGCWCGSAGG/WwD

# ATAqMCgGCCsGAQUFBwIBFhxodHRwczovL3d3dy5kaWdpY2VydC5jb20vQ1BTMAgG

# BmeBDAEEATCBhAYIKwYBBQUHAQEEeDB2MCQGCCsGAQUFBzABhhhodHRwOi8vb2Nz

# cC5kaWdpY2VydC5jb20wTgYIKwYBBQUHMAKGQmh0dHA6Ly9jYWNlcnRzLmRpZ2lj

# ZXJ0LmNvbS9EaWdpQ2VydFNIQTJBc3N1cmVkSURDb2RlU2lnbmluZ0NBLmNydDAM

# BgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4IBAQCSEe3CT6FTD/U/1eFY+b6h

# dh3i/CS/1+c9tY55Ygkb95H6EtyODxelck1giAEJDAC7Aqqlnm3KQSwDmJoJHvD0

# Y49h2SML4AmFZGJxsfcRRIdNiijDKbjexA0cGBA09uvh6JD3Y/BbNYf6Va+YbtAE

# 7V8kdRbIewwxD8NcKXggCrS28wzLsNNF8BgsgPQXhiYp1WMvS8oPm5c5kyOwNoxm

# wh5EJ1/07xuPUovgfwOWUKTpChu/aiqFCXRrSLY43CJlB9KrcP02PUC1kJXBl469

# j+De4PpS2ySLbiHL3CGB0mhADeTTt3a1EE4hbYJfosA5D57fllEHJdkq/yfckcsN

# MIIFjTCCBHWgAwIBAgIQDpsYjvnQLefv21DiCEAYWjANBgkqhkiG9w0BAQwFADBl

# MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3

# d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJv

# b3QgQ0EwHhcNMjIwODAxMDAwMDAwWhcNMzExMTA5MjM1OTU5WjBiMQswCQYDVQQG

# EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl

# cnQuY29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3QgRzQwggIiMA0G

# CSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC/5pBzaN675F1KPDAiMGkz7MKnJS7J

# IT3yithZwuEppz1Yq3aaza57G4QNxDAf8xukOBbrVsaXbR2rsnnyyhHS5F/WBTxS

# D1Ifxp4VpX6+n6lXFllVcq9ok3DCsrp1mWpzMpTREEQQLt+C8weE5nQ7bXHiLQwb

# 7iDVySAdYyktzuxeTsiT+CFhmzTrBcZe7FsavOvJz82sNEBfsXpm7nfISKhmV1ef

# VFiODCu3T6cw2Vbuyntd463JT17lNecxy9qTXtyOj4DatpGYQJB5w3jHtrHEtWoY

# OAMQjdjUN6QuBX2I9YI+EJFwq1WCQTLX2wRzKm6RAXwhTNS8rhsDdV14Ztk6MUSa

# M0C/CNdaSaTC5qmgZ92kJ7yhTzm1EVgX9yRcRo9k98FpiHaYdj1ZXUJ2h4mXaXpI

# 8OCiEhtmmnTK3kse5w5jrubU75KSOp493ADkRSWJtppEGSt+wJS00mFt6zPZxd9L

# BADMfRyVw4/3IbKyEbe7f/LVjHAsQWCqsWMYRJUadmJ+9oCw++hkpjPRiQfhvbfm

# Q6QYuKZ3AeEPlAwhHbJUKSWJbOUOUlFHdL4mrLZBdd56rF+NP8m800ERElvlEFDr

# McXKchYiCd98THU/Y+whX8QgUWtvsauGi0/C1kVfnSD8oR7FwI+isX4KJpn15Gkv

# mB0t9dmpsh3lGwIDAQABo4IBOjCCATYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4E

# FgQU7NfjgtJxXWRM3y5nP+e6mK4cD08wHwYDVR0jBBgwFoAUReuir/SSy4IxLVGL

# p6chnfNtyA8wDgYDVR0PAQH/BAQDAgGGMHkGCCsGAQUFBwEBBG0wazAkBggrBgEF

# BQcwAYYYaHR0cDovL29jc3AuZGlnaWNlcnQuY29tMEMGCCsGAQUFBzAChjdodHRw

# Oi8vY2FjZXJ0cy5kaWdpY2VydC5jb20vRGlnaUNlcnRBc3N1cmVkSURSb290Q0Eu

# Y3J0MEUGA1UdHwQ+MDwwOqA4oDaGNGh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9E

# aWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcmwwEQYDVR0gBAowCDAGBgRVHSAAMA0G

# CSqGSIb3DQEBDAUAA4IBAQBwoL9DXFXnOF+go3QbPbYW1/e/Vwe9mqyhhyzshV6p

# Grsi+IcaaVQi7aSId229GhT0E0p6Ly23OO/0/4C5+KH38nLeJLxSA8hO0Cre+i1W

# z/n096wwepqLsl7Uz9FDRJtDIeuWcqFItJnLnU+nBgMTdydE1Od/6Fmo8L8vC6bp

# 8jQ87PcDx4eo0kxAGTVGamlUsLihVo7spNU96LHc/RzY9HdaXFSMb++hUD38dglo

# hJ9vytsgjTVgHAIDyyCwrFigDkBjxZgiwbJZ9VVrzyerbHbObyMt9H5xaiNrIv8S

# uFQtJ37YOtnwtoeW/VvRXKwYw02fc7cBqZ9Xql4o4rmUMIIGrjCCBJagAwIBAgIQ

# BzY3tyRUfNhHrP0oZipeWzANBgkqhkiG9w0BAQsFADBiMQswCQYDVQQGEwJVUzEV

# MBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29t

# MSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3QgRzQwHhcNMjIwMzIzMDAw

# MDAwWhcNMzcwMzIyMjM1OTU5WjBjMQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGln

# aUNlcnQsIEluYy4xOzA5BgNVBAMTMkRpZ2lDZXJ0IFRydXN0ZWQgRzQgUlNBNDA5

# NiBTSEEyNTYgVGltZVN0YW1waW5nIENBMIICIjANBgkqhkiG9w0BAQEFAAOCAg8A

# MIICCgKCAgEAxoY1BkmzwT1ySVFVxyUDxPKRN6mXUaHW0oPRnkyibaCwzIP5WvYR

# oUQVQl+kiPNo+n3znIkLf50fng8zH1ATCyZzlm34V6gCff1DtITaEfFzsbPuK4CE

# iiIY3+vaPcQXf6sZKz5C3GeO6lE98NZW1OcoLevTsbV15x8GZY2UKdPZ7Gnf2ZCH

# RgB720RBidx8ald68Dd5n12sy+iEZLRS8nZH92GDGd1ftFQLIWhuNyG7QKxfst5K

# fc71ORJn7w6lY2zkpsUdzTYNXNXmG6jBZHRAp8ByxbpOH7G1WE15/tePc5OsLDni

# pUjW8LAxE6lXKZYnLvWHpo9OdhVVJnCYJn+gGkcgQ+NDY4B7dW4nJZCYOjgRs/b2

# nuY7W+yB3iIU2YIqx5K/oN7jPqJz+ucfWmyU8lKVEStYdEAoq3NDzt9KoRxrOMUp

# 88qqlnNCaJ+2RrOdOqPVA+C/8KI8ykLcGEh/FDTP0kyr75s9/g64ZCr6dSgkQe1C

# vwWcZklSUPRR8zZJTYsg0ixXNXkrqPNFYLwjjVj33GHek/45wPmyMKVM1+mYSlg+

# 0wOI/rOP015LdhJRk8mMDDtbiiKowSYI+RQQEgN9XyO7ZONj4KbhPvbCdLI/Hgl2

# 7KtdRnXiYKNYCQEoAA6EVO7O6V3IXjASvUaetdN2udIOa5kM0jO0zbECAwEAAaOC

# AV0wggFZMBIGA1UdEwEB/wQIMAYBAf8CAQAwHQYDVR0OBBYEFLoW2W1NhS9zKXaa

# L3WMaiCPnshvMB8GA1UdIwQYMBaAFOzX44LScV1kTN8uZz/nupiuHA9PMA4GA1Ud

# DwEB/wQEAwIBhjATBgNVHSUEDDAKBggrBgEFBQcDCDB3BggrBgEFBQcBAQRrMGkw

# JAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBBBggrBgEFBQcw

# AoY1aHR0cDovL2NhY2VydHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZFJv

# b3RHNC5jcnQwQwYDVR0fBDwwOjA4oDagNIYyaHR0cDovL2NybDMuZGlnaWNlcnQu

# Y29tL0RpZ2lDZXJ0VHJ1c3RlZFJvb3RHNC5jcmwwIAYDVR0gBBkwFzAIBgZngQwB

# BAIwCwYJYIZIAYb9bAcBMA0GCSqGSIb3DQEBCwUAA4ICAQB9WY7Ak7ZvmKlEIgF+

# ZtbYIULhsBguEE0TzzBTzr8Y+8dQXeJLKftwig2qKWn8acHPHQfpPmDI2AvlXFvX

# bYf6hCAlNDFnzbYSlm/EUExiHQwIgqgWvalWzxVzjQEiJc6VaT9Hd/tydBTX/6tP

# iix6q4XNQ1/tYLaqT5Fmniye4Iqs5f2MvGQmh2ySvZ180HAKfO+ovHVPulr3qRCy

# Xen/KFSJ8NWKcXZl2szwcqMj+sAngkSumScbqyQeJsG33irr9p6xeZmBo1aGqwpF

# yd/EjaDnmPv7pp1yr8THwcFqcdnGE4AJxLafzYeHJLtPo0m5d2aR8XKc6UsCUqc3

# fpNTrDsdCEkPlM05et3/JWOZJyw9P2un8WbDQc1PtkCbISFA0LcTJM3cHXg65J6t

# 5TRxktcma+Q4c6umAU+9Pzt4rUyt+8SVe+0KXzM5h0F4ejjpnOHdI/0dKNPH+ejx

# mF/7K9h+8kaddSweJywm228Vex4Ziza4k9Tm8heZWcpw8De/mADfIBZPJ/tgZxah

# ZrrdVcA6KYawmKAr7ZVBtzrVFZgxtGIJDwq9gdkT/r+k0fNX2bwE+oLeMt8EifAA

# zV3C+dAjfwAL5HYCJtnwZXZCpimHCUcr5n8apIUP/JiW9lVUKx+A+sDyDivl1vup

# L0QVSucTDh3bNzgaoSv27dZ8/DCCBsAwggSooAMCAQICEAxNaXJLlPo8Kko9KQeA

# PVowDQYJKoZIhvcNAQELBQAwYzELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lD

# ZXJ0LCBJbmMuMTswOQYDVQQDEzJEaWdpQ2VydCBUcnVzdGVkIEc0IFJTQTQwOTYg

# U0hBMjU2IFRpbWVTdGFtcGluZyBDQTAeFw0yMjA5MjEwMDAwMDBaFw0zMzExMjEy

# MzU5NTlaMEYxCzAJBgNVBAYTAlVTMREwDwYDVQQKEwhEaWdpQ2VydDEkMCIGA1UE

# AxMbRGlnaUNlcnQgVGltZXN0YW1wIDIwMjIgLSAyMIICIjANBgkqhkiG9w0BAQEF

# AAOCAg8AMIICCgKCAgEAz+ylJjrGqfJru43BDZrboegUhXQzGias0BxVHh42bbyS

# VQxh9J0Jdz0Vlggva2Sk/QaDFteRkjgcMQKW+3KxlzpVrzPsYYrppijbkGNcvYlT

# 4DotjIdCriak5Lt4eLl6FuFWxsC6ZFO7KhbnUEi7iGkMiMbxvuAvfTuxylONQIMe

# 58tySSgeTIAehVbnhe3yYbyqOgd99qtu5Wbd4lz1L+2N1E2VhGjjgMtqedHSEJFG

# Kes+JvK0jM1MuWbIu6pQOA3ljJRdGVq/9XtAbm8WqJqclUeGhXk+DF5mjBoKJL6c

# qtKctvdPbnjEKD+jHA9QBje6CNk1prUe2nhYHTno+EyREJZ+TeHdwq2lfvgtGx/s

# K0YYoxn2Off1wU9xLokDEaJLu5i/+k/kezbvBkTkVf826uV8MefzwlLE5hZ7Wn6l

# JXPbwGqZIS1j5Vn1TS+QHye30qsU5Thmh1EIa/tTQznQZPpWz+D0CuYUbWR4u5j9

# lMNzIfMvwi4g14Gs0/EH1OG92V1LbjGUKYvmQaRllMBY5eUuKZCmt2Fk+tkgbBhR

# YLqmgQ8JJVPxvzvpqwcOagc5YhnJ1oV/E9mNec9ixezhe7nMZxMHmsF47caIyLBu

# MnnHC1mDjcbu9Sx8e47LZInxscS451NeX1XSfRkpWQNO+l3qRXMchH7XzuLUOncC

# AwEAAaOCAYswggGHMA4GA1UdDwEB/wQEAwIHgDAMBgNVHRMBAf8EAjAAMBYGA1Ud

# JQEB/wQMMAoGCCsGAQUFBwMIMCAGA1UdIAQZMBcwCAYGZ4EMAQQCMAsGCWCGSAGG

# /WwHATAfBgNVHSMEGDAWgBS6FtltTYUvcyl2mi91jGogj57IbzAdBgNVHQ4EFgQU

# Yore0GH8jzEU7ZcLzT0qlBTfUpwwWgYDVR0fBFMwUTBPoE2gS4ZJaHR0cDovL2Ny

# bDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZEc0UlNBNDA5NlNIQTI1NlRp

# bWVTdGFtcGluZ0NBLmNybDCBkAYIKwYBBQUHAQEEgYMwgYAwJAYIKwYBBQUHMAGG

# GGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBYBggrBgEFBQcwAoZMaHR0cDovL2Nh

# Y2VydHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZEc0UlNBNDA5NlNIQTI1

# NlRpbWVTdGFtcGluZ0NBLmNydDANBgkqhkiG9w0BAQsFAAOCAgEAVaoqGvNG83hX

# NzD8deNP1oUj8fz5lTmbJeb3coqYw3fUZPwV+zbCSVEseIhjVQlGOQD8adTKmyn7

# oz/AyQCbEx2wmIncePLNfIXNU52vYuJhZqMUKkWHSphCK1D8G7WeCDAJ+uQt1wmJ

# efkJ5ojOfRu4aqKbwVNgCeijuJ3XrR8cuOyYQfD2DoD75P/fnRCn6wC6X0qPGjpS

# tOq/CUkVNTZZmg9U0rIbf35eCa12VIp0bcrSBWcrduv/mLImlTgZiEQU5QpZomvn

# Ij5EIdI/HMCb7XxIstiSDJFPPGaUr10CU+ue4p7k0x+GAWScAMLpWnR1DT3heYi/

# HAGXyRkjgNc2Wl+WFrFjDMZGQDvOXTXUWT5Dmhiuw8nLw/ubE19qtcfg8wXDWd8n

# YiveQclTuf80EGf2JjKYe/5cQpSBlIKdrAqLxksVStOYkEVgM4DgI974A6T2RUfl

# zrgDQkfoQTZxd639ouiXdE4u2h4djFrIHprVwvDGIqhPm73YHJpRxC+a9l+nJ5e6

# li6FV8Bg53hWf2rvwpWaSxECyIKcyRoFfLpxtU56mWz06J7UWpjIn7+NuxhcQ/XQ

# KujiYu54BNu90ftbCqhwfvCXhHjjCANdRyxjqCU4lwHSPzra5eX25pvcfizM/xdM

# TQCi2NYBDriL7ubgclWJLCcZYfZ3AYwxggVMMIIFSAIBATCBhjByMQswCQYDVQQG

# EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl

# cnQuY29tMTEwLwYDVQQDEyhEaWdpQ2VydCBTSEEyIEFzc3VyZWQgSUQgQ29kZSBT

# aWduaW5nIENBAhAD/SCAVAQOGx46UbQEe5/RMAkGBSsOAwIaBQCgeDAYBgorBgEE

# AYI3AgEMMQowCKACgAChAoAAMBkGCSqGSIb3DQEJAzEMBgorBgEEAYI3AgEEMBwG

# CisGAQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMCMGCSqGSIb3DQEJBDEWBBSAuBGU

# TNUWwCTrw8ebEPmETrYDuzANBgkqhkiG9w0BAQEFAASCAQC5QsI9TnJ/epxJAyOP

# fgpQWXWRgFQ3h240MWcxFG4XJl+EUlUpPdNQLsxLy+xci8jJyHoZTAVR75t5nqV8

# RlwShq53X172eB4peHJ8IYXBTbp/N6dy6BKnhVQt+fPMjjDOuiYoidYc+hpeyiSQ

# wlM1tklJCL4MXRMCbgfxEa9MpX2EeLX7O2GP/ncIkW0tPGcSa9Bcw53DaDAu8nGX

# AH08xZtDREh14oAP3IVHNc/LXCC1Bp7lCrLP7YqbDP+lmApLXi+RJTCe8ivFVxt+

# V8CV2sJS7XYPplzvUNa0Qr7NTrrbnoxzEzAgNhiQ1NbmkDVHpVpgv7Sq+r9QwIq8

# 8Xw4oYIDIDCCAxwGCSqGSIb3DQEJBjGCAw0wggMJAgEBMHcwYzELMAkGA1UEBhMC

# VVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMTswOQYDVQQDEzJEaWdpQ2VydCBU

# cnVzdGVkIEc0IFJTQTQwOTYgU0hBMjU2IFRpbWVTdGFtcGluZyBDQQIQDE1pckuU

# +jwqSj0pB4A9WjANBglghkgBZQMEAgEFAKBpMBgGCSqGSIb3DQEJAzELBgkqhkiG

# 9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTIzMDcyMTEzNTUyMVowLwYJKoZIhvcNAQkE

# MSIEILfXiHvXBgcKOyrWp+rjvF/u+UKEu+8atnTs7RauMrdWMA0GCSqGSIb3DQEB

# AQUABIICACPJd0NHH00/KxpBC9g2eIRr5xcj48xRsXLodb0alcRoo5ywtK8x1YLY

# OVI2bU308TRd2aBbpHu9T0/vr8oIKX2OGAp+BgQv46uzbexf1ZRdNHw3YsmgiPXP

# RkCRzAehDuMopSe/cE9aY3q+aO3jqXtqstmTs9wgYLHjnKbwk1slbSBQ0HRyZ2xl

# ZVYmXHYTUE35eR+nH3MyWHekP2KGDXvQ6rTBn8OY/QUit12SFt1J4A4hTBxiNebz

# jvczQOPw+yJQKpm8r35CuQ/wT1DKTKQZ2S03c80Dg22g0WEvVQTaka/fLlik0vup

# ZPC0mMKelYDDyos4A83nbJ7BXTkMOqojGeiDk2h6xzaCo5m8ko8+/7RzShUSW+we

# qTxhYVQ2xuL8c/9t7j1/0V8drxDDHVPqfk1OS4F5YGXuZNqrDtaDf1lb7ub7cxKp

# VnaBLHbZbg7vlQnAbdISH5vUpSidCvSU7WQQoAuCP1o56nhR8OAESj4SHck/r0Aw

# Zq+uZaNcZOuFtBbTgpHmGAJCVaY52IS+YELIxznOIeTJ2ioI+b5rIM2CmfygRBGZ

# sRRhFLbAboIkV1xbPm+/beEa0T3Znlk3nYxu1bj+oMn8drB5RTkSEyupDlopdw4q

# uRdn+zekcxvdKumbEVLkLG39n+kolTNFHSpJVEBlFjQGRk6YH7IC

# SIG # End signature block