PScribo

0.10.0

Src/Public/Table.ps1

                                function Table

{

<#

    .SYNOPSIS

        Defines a new PScribo document table.

    .PARAMETER Name

    .PARAMETER InputObject

    .PARAMETER Hashtable

    .PARAMETER Columns

    .PARAMETER ColumnWidths

    .PARAMETER Headers

    .PARAMETER Style

    .PARAMETER Width

    .PARAMETER Tabs

    .PARAMETER List

    .PARAMETER Key

    .PARAMETER Caption

    .EXAMPLE

        Table -Name 'Table 1' -InputObject $(Get-Service) -Columns 'Name','DisplayName','Status' -ColumnWidths 40,20,40

#>

    [CmdletBinding(DefaultParameterSetName = 'InputObject')]

    [OutputType([System.Management.Automation.PSCustomObject])]

    param

    (

        ## Table name/Id

        [Parameter(ValueFromPipelineByPropertyName, Position = 0)]

        [ValidateNotNullOrEmpty()]

        [string] $Name = ([System.Guid]::NewGuid().ToString()),

        # Array of objects

        [Parameter(Mandatory, ValueFromPipeline, ParameterSetName = 'InputObject')]

        [Parameter(Mandatory, ValueFromPipeline, ParameterSetName = 'InputObjectList')]

        [Parameter(Mandatory, ValueFromPipeline, ParameterSetName = 'InputObjectListKey')]

        [Alias('CustomObject','Object')]

        [ValidateNotNullOrEmpty()]

        [System.Object[]] $InputObject,

        # Array of Hashtables

        [Parameter(Mandatory, ValueFromPipeline, ParameterSetName = 'Hashtable')]

        [Parameter(Mandatory, ValueFromPipeline, ParameterSetName = 'HashtableList')]

        [Parameter(Mandatory, ValueFromPipeline, ParameterSetName = 'HashtableListKey')]

        [ValidateNotNullOrEmpty()]

        [System.Collections.Specialized.OrderedDictionary[]] $Hashtable,

        # Array of Hashtable key names or object/PSCustomObject property names to include, in display order.

        # If not supplied then all Hashtable keys or all object properties will be used.

        [Parameter(ValueFromPipelineByPropertyName, Position = 1)]

        [Alias('Properties')]

        [AllowNull()]

        [System.String[]] $Columns = $null,

        ## Column widths as percentages. Total should not exceed 100.

        [Parameter(ValueFromPipelineByPropertyName)]

        [AllowNull()]

        [System.UInt16[]] $ColumnWidths,

        # Array of custom table header strings in display order.

        [Parameter(ValueFromPipelineByPropertyName, Position = 2)]

        [AllowNull()]

        [System.String[]] $Headers = $null,

        ## Table style

        [Parameter(ValueFromPipelineByPropertyName, Position = 3)]

        [ValidateNotNullOrEmpty()]

        [System.String] $Style = $pscriboDocument.DefaultTableStyle,

        ## Table width (%), 0 = Autofit

        [Parameter(ValueFromPipelineByPropertyName)]

        [ValidateRange(0,100)]

        [System.UInt16] $Width = 100,

        ## Indent table

        [Parameter(ValueFromPipelineByPropertyName)]

        [ValidateRange(0,10)]

        [System.UInt16] $Tabs,

        ## List view

        [Parameter(Mandatory, ValueFromPipelineByPropertyName, ParameterSetName = 'InputObjectList')]

        [Parameter(Mandatory, ValueFromPipelineByPropertyName, ParameterSetName = 'HashtableList')]

        [Parameter(Mandatory, ValueFromPipelineByPropertyName, ParameterSetName = 'InputObjectListKey')]

        [Parameter(Mandatory, ValueFromPipelineByPropertyName, ParameterSetName = 'HashtableListKey')]

        [System.Management.Automation.SwitchParameter] $List,

        ## Combine list view based upon the specified key property name

        [Parameter(Mandatory, ValueFromPipelineByPropertyName, ParameterSetName = 'InputObjectListKey')]

        [Parameter(Mandatory, ValueFromPipelineByPropertyName, ParameterSetName = 'HashtableListKey')]

        [System.String] $Key,

        ## Hide the key name in the table output. Note: Key name will always be displayed in text output.

        [Parameter(ValueFromPipelineByPropertyName, ParameterSetName = 'InputObjectListKey')]

        [Parameter(ValueFromPipelineByPropertyName, ParameterSetName = 'HashtableListKey')]

        [System.Management.Automation.SwitchParameter] $HideKey,

        ## Table caption

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.String] $Caption

    )

    begin

    {

        Write-Debug ('Using parameter set "{0}".' -f $PSCmdlet.ParameterSetName)

        [System.Collections.ArrayList] $rows = New-Object -TypeName System.Collections.ArrayList

        Write-PScriboMessage -Message ($localized.ProcessingTable -f $Name)

        if ($Headers -and (-not $Columns))

        {

            Write-PScriboMessage -Message $localized.TableHeadersWithNoColumnsWarning -IsWarning

            $Headers = $Columns

        }

        elseif (($null -ne $Columns) -and ($null -ne $Headers))

        {

            ## Check the number of -Headers matches the number of -Properties

            if ($Headers.Count -ne $Columns.Count)

            {

                Write-PScriboMessage -Message $localized.TableHeadersCountMismatchWarning -IsWarning

                $Headers = $Columns

            }

        }

        if ($ColumnWidths)

        {

            $columnWidthsSum = $ColumnWidths | Measure-Object -Sum | Select-Object -ExpandProperty Sum

            if ($columnWidthsSum -ne 100)

            {

                Write-PScriboMessage -Message ($localized.TableColumnWidthSumWarning -f $columnWidthsSum) -IsWarning

                $ColumnWidths = $null

            }

            elseif ($List -and (-not $Key) -and ($ColumnWidths.Count -ne 2))

            {

                Write-PScriboMessage -Message $localized.ListTableColumnCountWarning -IsWarning

                $ColumnWidths = $null

            }

            elseif (($PSCmdlet.ParameterSetName -eq 'Hashtable') -and (-not $List) -and ($Hashtable[0].Keys.Count -ne $ColumnWidths.Count))

            {

                Write-PScriboMessage -Message $localized.TableColumnWidthMismatchWarning -IsWarning

                $ColumnWidths = $null

            }

            elseif (($PSCmdlet.ParameterSetName -eq 'InputObject') -and (-not $List))

            {

                ## Columns might not have been passed and there is no object in the pipeline here, so check $Columns is an array.

                if (($Columns -is [System.Object[]]) -and ($Columns.Count -ne $ColumnWidths.Count))

                {

                    Write-PScriboMessage -Message $localized.TableColumnWidthMismatchWarning -IsWarning

                    $ColumnWidths = $null

                }

            }

        }

    }

    process

    {

        if ($null -eq $Columns) {

            ## Use all available properties

            if ($PSCmdlet.ParameterSetName -in 'Hashtable','HashtableList','HashtableListKey')

            {

                $Columns = $Hashtable | Select-Object -First 1 -ExpandProperty Keys | Where-Object { $_ -notlike '*__Style' }

            }

            elseif ($PSCmdlet.ParameterSetName -in 'InputObject','InputObjectList','InputObjectListKey')

            {

                ## Pipeline objects are not available in the begin scriptblock

                $object = $InputObject | Select-Object -First 1

                if ($object -is [System.Management.Automation.PSCustomObject])

                {

                    $Columns = $object.PSObject.Properties | Where-Object Name -notlike '*__Style' | Select-Object -ExpandProperty Name

                }

                elseif ($object -is [System.Collections.Specialized.OrderedDictionary])

                {

                    $Columns = $object.Keys | Where-Object { $_ -notlike '*__Style' }

                }

                else

                {

                    $Columns = Get-Member -InputObject $object -MemberType Properties | Where-Object Name -notlike '*__Style' | Select-Object -ExpandProperty Name

                }

            }

        }

        if ($PSCmdlet.ParameterSetName -in 'Hashtable','HashtableList','HashtableListKey')

        {

            foreach ($nestedHashtable in $Hashtable)

            {

                $customObject = New-PScriboTableRow -Hashtable $nestedHashtable

                [ref] $null = $rows.Add($customObject)

            } #end foreach nested hashtable entry

        }

        elseif ($PSCmdlet.ParameterSetName -in 'InputObject','InputObjectList','InputObjectListKey')

        {

            foreach ($object in $InputObject)

            {

                if ($object -is [System.Collections.Specialized.OrderedDictionary])

                {

                    $customObject = New-PScriboTableRow -Hashtable $object

                }

                else

                {

                    $customObject = New-PScriboTableRow -InputObject $object -Properties $Columns -Headers $Headers

                }

                [ref] $null = $rows.Add($customObject)

            }

        }

    }

    end

    {

        if (($PSBoundParameters.ContainsKey('Key')) -and ($PSBoundParameters.ContainsKey('Headers')))

        {

            ## Update the key name to match the rewritten property display name

            $Key = $Headers[$Columns.IndexOf($Key)]

        }

        ## Update the column names as the objects have been have been rewritten with their display names (Headers)

        if ($Headers)

        {

            $Columns = $Headers

        }

        $newPScriboTableParams = @{

            Name         = $Name

            Columns      = $Columns

            ColumnWidths = $ColumnWidths

            Rows         = $rows

            List         = $List

            Style        = $Style

            Width        = $Width

            Tabs         = $Tabs

        }

        if ($PSBoundParameters.ContainsKey('Key'))

        {

            $newPScriboTableParams['ListKey'] = $Key

            $newPScriboTableParams['DisplayListKey'] = -not $HideKey

        }

        if ($PSBoundParameters.ContainsKey('Caption'))

        {

            $newPScriboTableParams['Caption'] = $Caption

        }

        return (New-PScriboTable @newPScriboTableParams)

    }

}

# SIG # Begin signature block

# MIIhZwYJKoZIhvcNAQcCoIIhWDCCIVQCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUVJtFZ3UACnWJRJbKYmP69ft8

# 0EOgghsPMIIGrjCCBJagAwIBAgIQBzY3tyRUfNhHrP0oZipeWzANBgkqhkiG9w0B

# AQsFADBiMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYD

# VQQLExB3d3cuZGlnaWNlcnQuY29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVk

# IFJvb3QgRzQwHhcNMjIwMzIzMDAwMDAwWhcNMzcwMzIyMjM1OTU5WjBjMQswCQYD

# VQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xOzA5BgNVBAMTMkRpZ2lD

# ZXJ0IFRydXN0ZWQgRzQgUlNBNDA5NiBTSEEyNTYgVGltZVN0YW1waW5nIENBMIIC

# IjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAxoY1BkmzwT1ySVFVxyUDxPKR

# N6mXUaHW0oPRnkyibaCwzIP5WvYRoUQVQl+kiPNo+n3znIkLf50fng8zH1ATCyZz

# lm34V6gCff1DtITaEfFzsbPuK4CEiiIY3+vaPcQXf6sZKz5C3GeO6lE98NZW1Oco

# LevTsbV15x8GZY2UKdPZ7Gnf2ZCHRgB720RBidx8ald68Dd5n12sy+iEZLRS8nZH

# 92GDGd1ftFQLIWhuNyG7QKxfst5Kfc71ORJn7w6lY2zkpsUdzTYNXNXmG6jBZHRA

# p8ByxbpOH7G1WE15/tePc5OsLDnipUjW8LAxE6lXKZYnLvWHpo9OdhVVJnCYJn+g

# GkcgQ+NDY4B7dW4nJZCYOjgRs/b2nuY7W+yB3iIU2YIqx5K/oN7jPqJz+ucfWmyU

# 8lKVEStYdEAoq3NDzt9KoRxrOMUp88qqlnNCaJ+2RrOdOqPVA+C/8KI8ykLcGEh/

# FDTP0kyr75s9/g64ZCr6dSgkQe1CvwWcZklSUPRR8zZJTYsg0ixXNXkrqPNFYLwj

# jVj33GHek/45wPmyMKVM1+mYSlg+0wOI/rOP015LdhJRk8mMDDtbiiKowSYI+RQQ

# EgN9XyO7ZONj4KbhPvbCdLI/Hgl27KtdRnXiYKNYCQEoAA6EVO7O6V3IXjASvUae

# tdN2udIOa5kM0jO0zbECAwEAAaOCAV0wggFZMBIGA1UdEwEB/wQIMAYBAf8CAQAw

# HQYDVR0OBBYEFLoW2W1NhS9zKXaaL3WMaiCPnshvMB8GA1UdIwQYMBaAFOzX44LS

# cV1kTN8uZz/nupiuHA9PMA4GA1UdDwEB/wQEAwIBhjATBgNVHSUEDDAKBggrBgEF

# BQcDCDB3BggrBgEFBQcBAQRrMGkwJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRp

# Z2ljZXJ0LmNvbTBBBggrBgEFBQcwAoY1aHR0cDovL2NhY2VydHMuZGlnaWNlcnQu

# Y29tL0RpZ2lDZXJ0VHJ1c3RlZFJvb3RHNC5jcnQwQwYDVR0fBDwwOjA4oDagNIYy

# aHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZFJvb3RHNC5j

# cmwwIAYDVR0gBBkwFzAIBgZngQwBBAIwCwYJYIZIAYb9bAcBMA0GCSqGSIb3DQEB

# CwUAA4ICAQB9WY7Ak7ZvmKlEIgF+ZtbYIULhsBguEE0TzzBTzr8Y+8dQXeJLKftw

# ig2qKWn8acHPHQfpPmDI2AvlXFvXbYf6hCAlNDFnzbYSlm/EUExiHQwIgqgWvalW

# zxVzjQEiJc6VaT9Hd/tydBTX/6tPiix6q4XNQ1/tYLaqT5Fmniye4Iqs5f2MvGQm

# h2ySvZ180HAKfO+ovHVPulr3qRCyXen/KFSJ8NWKcXZl2szwcqMj+sAngkSumScb

# qyQeJsG33irr9p6xeZmBo1aGqwpFyd/EjaDnmPv7pp1yr8THwcFqcdnGE4AJxLaf

# zYeHJLtPo0m5d2aR8XKc6UsCUqc3fpNTrDsdCEkPlM05et3/JWOZJyw9P2un8WbD

# Qc1PtkCbISFA0LcTJM3cHXg65J6t5TRxktcma+Q4c6umAU+9Pzt4rUyt+8SVe+0K

# XzM5h0F4ejjpnOHdI/0dKNPH+ejxmF/7K9h+8kaddSweJywm228Vex4Ziza4k9Tm

# 8heZWcpw8De/mADfIBZPJ/tgZxahZrrdVcA6KYawmKAr7ZVBtzrVFZgxtGIJDwq9

# gdkT/r+k0fNX2bwE+oLeMt8EifAAzV3C+dAjfwAL5HYCJtnwZXZCpimHCUcr5n8a

# pIUP/JiW9lVUKx+A+sDyDivl1vupL0QVSucTDh3bNzgaoSv27dZ8/DCCBrAwggSY

# oAMCAQICEAitQLJg0pxMn17Nqb2TrtkwDQYJKoZIhvcNAQEMBQAwYjELMAkGA1UE

# BhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2lj

# ZXJ0LmNvbTEhMB8GA1UEAxMYRGlnaUNlcnQgVHJ1c3RlZCBSb290IEc0MB4XDTIx

# MDQyOTAwMDAwMFoXDTM2MDQyODIzNTk1OVowaTELMAkGA1UEBhMCVVMxFzAVBgNV

# BAoTDkRpZ2lDZXJ0LCBJbmMuMUEwPwYDVQQDEzhEaWdpQ2VydCBUcnVzdGVkIEc0

# IENvZGUgU2lnbmluZyBSU0E0MDk2IFNIQTM4NCAyMDIxIENBMTCCAiIwDQYJKoZI

# hvcNAQEBBQADggIPADCCAgoCggIBANW0L0LQKK14t13VOVkbsYhC9TOM6z2Bl3DF

# u8SFJjCfpI5o2Fz16zQkB+FLT9N4Q/QX1x7a+dLVZxpSTw6hV/yImcGRzIEDPk1w

# JGSzjeIIfTR9TIBXEmtDmpnyxTsf8u/LR1oTpkyzASAl8xDTi7L7CPCK4J0JwGWn

# +piASTWHPVEZ6JAheEUuoZ8s4RjCGszF7pNJcEIyj/vG6hzzZWiRok1MghFIUmje

# EL0UV13oGBNlxX+yT4UsSKRWhDXW+S6cqgAV0Tf+GgaUwnzI6hsy5srC9KejAw50

# pa85tqtgEuPo1rn3MeHcreQYoNjBI0dHs6EPbqOrbZgGgxu3amct0r1EGpIQgY+w

# OwnXx5syWsL/amBUi0nBk+3htFzgb+sm+YzVsvk4EObqzpH1vtP7b5NhNFy8k0Uo

# gzYqZihfsHPOiyYlBrKD1Fz2FRlM7WLgXjPy6OjsCqewAyuRsjZ5vvetCB51pmXM

# u+NIUPN3kRr+21CiRshhWJj1fAIWPIMorTmG7NS3DVPQ+EfmdTCN7DCTdhSmW0td

# dGFNPxKRdt6/WMtyEClB8NXFbSZ2aBFBE1ia3CYrAfSJTVnbeM+BSj5AR1/JgVBz

# hRAjIVlgimRUwcwhGug4GXxmHM14OEUwmU//Y09Mu6oNCFNBfFg9R7P6tuyMMgkC

# zGw8DFYRAgMBAAGjggFZMIIBVTASBgNVHRMBAf8ECDAGAQH/AgEAMB0GA1UdDgQW

# BBRoN+Drtjv4XxGG+/5hewiIZfROQjAfBgNVHSMEGDAWgBTs1+OC0nFdZEzfLmc/

# 57qYrhwPTzAOBgNVHQ8BAf8EBAMCAYYwEwYDVR0lBAwwCgYIKwYBBQUHAwMwdwYI

# KwYBBQUHAQEEazBpMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5j

# b20wQQYIKwYBBQUHMAKGNWh0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdp

# Q2VydFRydXN0ZWRSb290RzQuY3J0MEMGA1UdHwQ8MDowOKA2oDSGMmh0dHA6Ly9j

# cmwzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFRydXN0ZWRSb290RzQuY3JsMBwGA1Ud

# IAQVMBMwBwYFZ4EMAQMwCAYGZ4EMAQQBMA0GCSqGSIb3DQEBDAUAA4ICAQA6I0Q9

# jQh27o+8OpnTVuACGqX4SDTzLLbmdGb3lHKxAMqvbDAnExKekESfS/2eo3wm1Te8

# Ol1IbZXVP0n0J7sWgUVQ/Zy9toXgdn43ccsi91qqkM/1k2rj6yDR1VB5iJqKisG2

# vaFIGH7c2IAaERkYzWGZgVb2yeN258TkG19D+D6U/3Y5PZ7Umc9K3SjrXyahlVhI

# 1Rr+1yc//ZDRdobdHLBgXPMNqO7giaG9OeE4Ttpuuzad++UhU1rDyulq8aI+20O4

# M8hPOBSSmfXdzlRt2V0CFB9AM3wD4pWywiF1c1LLRtjENByipUuNzW92NyyFPxrO

# JukYvpAHsEN/lYgggnDwzMrv/Sk1XB+JOFX3N4qLCaHLC+kxGv8uGVw5ceG+nKcK

# BtYmZ7eS5k5f3nqsSc8upHSSrds8pJyGH+PBVhsrI/+PteqIe3Br5qC6/To/RabE

# 6BaRUotBwEiES5ZNq0RA443wFSjO7fEYVgcqLxDEDAhkPDOPriiMPMuPiAsNvzv0

# zh57ju+168u38HcT5ucoP6wSrqUvImxB+YJcFWbMbA7KxYbD9iYzDAdLoNMHAmpq

# QDBISzSoUSC7rRuFCOJZDW3KBVAr6kocnqX9oKcfBnTn8tZSkP2vhUgh+Vc7tJwD

# 7YZF9LRhbr9o4iZghurIr6n+lB3nYxs6hlZ4TjCCBsYwggSuoAMCAQICEAp6Soie

# yZlCkAZjOE2Gl50wDQYJKoZIhvcNAQELBQAwYzELMAkGA1UEBhMCVVMxFzAVBgNV

# BAoTDkRpZ2lDZXJ0LCBJbmMuMTswOQYDVQQDEzJEaWdpQ2VydCBUcnVzdGVkIEc0

# IFJTQTQwOTYgU0hBMjU2IFRpbWVTdGFtcGluZyBDQTAeFw0yMjAzMjkwMDAwMDBa

# Fw0zMzAzMTQyMzU5NTlaMEwxCzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2Vy

# dCwgSW5jLjEkMCIGA1UEAxMbRGlnaUNlcnQgVGltZXN0YW1wIDIwMjIgLSAyMIIC

# IjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAuSqWI6ZcvF/WSfAVghj0M+7M

# XGzj4CUu0jHkPECu+6vE43hdflw26vUljUOjges4Y/k8iGnePNIwUQ0xB7pGbumj

# S0joiUF/DbLW+YTxmD4LvwqEEnFsoWImAdPOw2z9rDt+3Cocqb0wxhbY2rzrsvGD

# 0Z/NCcW5QWpFQiNBWvhg02UsPn5evZan8Pyx9PQoz0J5HzvHkwdoaOVENFJfD1De

# 1FksRHTAMkcZW+KYLo/Qyj//xmfPPJOVToTpdhiYmREUxSsMoDPbTSSF6IKU4S8D

# 7n+FAsmG4dUYFLcERfPgOL2ivXpxmOwV5/0u7NKbAIqsHY07gGj+0FmYJs7g7a5/

# KC7CnuALS8gI0TK7g/ojPNn/0oy790Mj3+fDWgVifnAs5SuyPWPqyK6BIGtDich+

# X7Aa3Rm9n3RBCq+5jgnTdKEvsFR2wZBPlOyGYf/bES+SAzDOMLeLD11Es0MdI1DN

# kdcvnfv8zbHBp8QOxO9APhk6AtQxqWmgSfl14ZvoaORqDI/r5LEhe4ZnWH5/H+gr

# 5BSyFtaBocraMJBr7m91wLA2JrIIO/+9vn9sExjfxm2keUmti39hhwVo99Rw40KV

# 6J67m0uy4rZBPeevpxooya1hsKBBGBlO7UebYZXtPgthWuo+epiSUc0/yUTngIsp

# QnL3ebLdhOon7v59emsCAwEAAaOCAYswggGHMA4GA1UdDwEB/wQEAwIHgDAMBgNV

# HRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMCAGA1UdIAQZMBcwCAYG

# Z4EMAQQCMAsGCWCGSAGG/WwHATAfBgNVHSMEGDAWgBS6FtltTYUvcyl2mi91jGog

# j57IbzAdBgNVHQ4EFgQUjWS3iSH+VlhEhGGn6m8cNo/drw0wWgYDVR0fBFMwUTBP

# oE2gS4ZJaHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZEc0

# UlNBNDA5NlNIQTI1NlRpbWVTdGFtcGluZ0NBLmNybDCBkAYIKwYBBQUHAQEEgYMw

# gYAwJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBYBggrBgEF

# BQcwAoZMaHR0cDovL2NhY2VydHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3Rl

# ZEc0UlNBNDA5NlNIQTI1NlRpbWVTdGFtcGluZ0NBLmNydDANBgkqhkiG9w0BAQsF

# AAOCAgEADS0jdKbR9fjqS5k/AeT2DOSvFp3Zs4yXgimcQ28BLas4tXARv4QZiz9d

# 5YZPvpM63io5WjlO2IRZpbwbmKrobO/RSGkZOFvPiTkdcHDZTt8jImzV3/ZZy6HC

# 6kx2yqHcoSuWuJtVqRprfdH1AglPgtalc4jEmIDf7kmVt7PMxafuDuHvHjiKn+8R

# yTFKWLbfOHzL+lz35FO/bgp8ftfemNUpZYkPopzAZfQBImXH6l50pls1klB89Bem

# h2RPPkaJFmMga8vye9A140pwSKm25x1gvQQiFSVwBnKpRDtpRxHT7unHoD5PELkw

# NuTzqmkJqIt+ZKJllBH7bjLx9bs4rc3AkxHVMnhKSzcqTPNc3LaFwLtwMFV41pj+

# VG1/calIGnjdRncuG3rAM4r4SiiMEqhzzy350yPynhngDZQooOvbGlGglYKOKGuk

# zp123qlzqkhqWUOuX+r4DwZCnd8GaJb+KqB0W2Nm3mssuHiqTXBt8CzxBxV+NbTm

# tQyimaXXFWs1DoXW4CzM4AwkuHxSCx6ZfO/IyMWMWGmvqz3hz8x9Fa4Uv4px38qX

# sdhH6hyF4EVOEhwUKVjMb9N/y77BDkpvIJyu2XMyWQjnLZKhGhH+MpimXSuX4IvT

# nMxttQ2uR2M4RxdbbxPaahBuH0m3RFu0CAqHWlkEdhGhp3cCExwwggbbMIIEw6AD

# AgECAhAEyswKPFRr9qgYCxGuzc8mMA0GCSqGSIb3DQEBCwUAMGkxCzAJBgNVBAYT

# AlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjFBMD8GA1UEAxM4RGlnaUNlcnQg

# VHJ1c3RlZCBHNCBDb2RlIFNpZ25pbmcgUlNBNDA5NiBTSEEzODQgMjAyMSBDQTEw

# HhcNMjExMDE5MDAwMDAwWhcNMjMxMTA0MjM1OTU5WjBgMQswCQYDVQQGEwJHQjEP

# MA0GA1UEBxMGTG9uZG9uMR8wHQYDVQQKExZWaXJ0dWFsIEVuZ2luZSBMaW1pdGVk

# MR8wHQYDVQQDExZWaXJ0dWFsIEVuZ2luZSBMaW1pdGVkMIIBojANBgkqhkiG9w0B

# AQEFAAOCAY8AMIIBigKCAYEAtbm3o57mQYxu0idSifhlyZaDVO0Zu0BnGTFZOtZL

# ibBotgpKp7Be3k9WDyIbOiUHVaFY7DG8aL8krpArj+3KJR49U5pLXcevNUQFLL18

# pi9lZ+e2w+dcBAfuJ30J760VtPDwAA7nmAff3f9o+tEB1ZnIeXzlPRyMz7YZS43s

# DeAft8p8jFzmM0jRtt9SXNxKcC0gnX6Cx0vw4AkxmMtreX/Igvj5VVq4M81E84Ce

# fWsU/IpqIL24xpxl3OOwZ53wzn+rPA3T9bj0PUyI/6VvONUIRD/EfODxurVdSDdu

# LHsRag4+Q3xFvZm/WNqsr2qGv7LHT3uKPsjuPBo1Mz9fM/AfPwdEfM3xJ+Y1rBqU

# xnDhwYS97Fw3LM63lTKl3bN4TOFEJX8YPgC02J4vzYSIP0fwBBPyd7MtbiXzFvSo

# Xnl0EQmjH+k4fjOCwn1tgWnI77NET05Jd06F3Od52In9qIJ5Bhu4zlMFEQgE7JON

# OI4/Hl/dBzfNkyItMMRcNiPJAgMBAAGjggIGMIICAjAfBgNVHSMEGDAWgBRoN+Dr

# tjv4XxGG+/5hewiIZfROQjAdBgNVHQ4EFgQUEr+p1bWwrT+zl6+TXhHWz9ewYuAw

# DgYDVR0PAQH/BAQDAgeAMBMGA1UdJQQMMAoGCCsGAQUFBwMDMIG1BgNVHR8Ega0w

# gaowU6BRoE+GTWh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFRydXN0

# ZWRHNENvZGVTaWduaW5nUlNBNDA5NlNIQTM4NDIwMjFDQTEuY3JsMFOgUaBPhk1o

# dHRwOi8vY3JsNC5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkRzRDb2RlU2ln

# bmluZ1JTQTQwOTZTSEEzODQyMDIxQ0ExLmNybDA+BgNVHSAENzA1MDMGBmeBDAEE

# ATApMCcGCCsGAQUFBwIBFhtodHRwOi8vd3d3LmRpZ2ljZXJ0LmNvbS9DUFMwgZQG

# CCsGAQUFBwEBBIGHMIGEMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2Vy

# dC5jb20wXAYIKwYBBQUHMAKGUGh0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9E

# aWdpQ2VydFRydXN0ZWRHNENvZGVTaWduaW5nUlNBNDA5NlNIQTM4NDIwMjFDQTEu

# Y3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAB35Ee2voPHjrdDl

# B80kocW2ZrVcKO5/POchPOvxL1evXPdoaexNDCwXzM/6GXa4U1VhV+GqbeQ+JCZF

# XWbiycxqXEfi5fxj2sRzdF3CDootFiqxK1eqz2W82KR5FX45LTsQMrg6O8kA2nb2

# eBxk6TWYUtS+3jtdS/nwDp/B/A+ol0CaD51hlzq9QY0NNkwsbZ+fKmIxinqEFF6n

# taOmQNWS0EOtNQBYdlf0pNThBuPxENsDtWRS56pg3qfl3+khteed8sFoyY/9g1So

# fbc7DAQiYtTikmekA+s5WkHY1ewiSF/NcXSNNMNgbuAsizoMQ9NkJ/vMhs89+hNU

# e6Tlk9bFffOP9oh5z6Df/XHJslhNY3DxWYQQxtqzZpAk/4GCJ8L9qdeEDvtulPp3

# p6VqNBxQPu98C46pfXgCX0vIieVy3RZOhHD2JCytWNFWXJFvoo03akcyTumiq2+m

# ew6ALwXKKtFeoDHfnzDkVsZRPqY49gECVKifY7Z7Usuf3SBOB6txOlzK15eMR2EI

# RsBSCPVZCevU9z51DP/GLZ6/kCDG6hcu6isenIWAxWw1wiGv6HJpca73ummRYoUe

# KtNV8hg7ItlPimtrjjoT+0ciE8Ohuv5GDBqK0GE4ikCIUZyFg74ppkHV4q+YghXv

# ubkwMSV7ymFRKhgcGQLlDXP+OaVQMYIFwjCCBb4CAQEwfTBpMQswCQYDVQQGEwJV

# UzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xQTA/BgNVBAMTOERpZ2lDZXJ0IFRy

# dXN0ZWQgRzQgQ29kZSBTaWduaW5nIFJTQTQwOTYgU0hBMzg0IDIwMjEgQ0ExAhAE

# yswKPFRr9qgYCxGuzc8mMAkGBSsOAwIaBQCgeDAYBgorBgEEAYI3AgEMMQowCKAC

# gAChAoAAMBkGCSqGSIb3DQEJAzEMBgorBgEEAYI3AgEEMBwGCisGAQQBgjcCAQsx

# DjAMBgorBgEEAYI3AgEVMCMGCSqGSIb3DQEJBDEWBBSCojVHyA608rlfhFnJLCmm

# +XuMuDANBgkqhkiG9w0BAQEFAASCAYByubKe22z3PAeZC/PZyBqczgV9wMZ97Sv3

# 2Sx8vlsgYNdxSc6Mu2VX4tpxJSAVnqPlXltWp1hQvZRNaUQHcQva3ooHhklwAV3e

# Fv5vo4Y/kLqHfuPdo3sbsSapPA0A8kmJzN1u53sxT27R8qSVBj/EuF2avHbvy8k6

# 5g4a34mYxUD8vxmgQsS2/UkzySvcx7svU3fi0QONu0nr0qxay8pP1IcjZ5RCtzVx

# MimGtIv/AsG/fr8cSG5sK92drjCpwX2AOBnJqf+mykjoz9Tb8A43HUbI5ANodk3x

# bPigfbFk6kPcT2yFoE66FjT/6VAT/+mVUKctYIURyP9zgMJW/f4hfXRP1Snu5W2L

# V1fFjAF0vzdTvju/HSlIb8/t0rThKSoJXD9ODy1ZcPMRhH7+Kp7cMJet4Xn0D1dO

# aOMmLxkWRk7QPpITv64WpjiPWZxqATHlQ87nfLNvQMGpe/x6R0iUUB+etOYkuqTU

# C9PEkDOEVaBuwodgVxc+/Je+UKASupyhggMgMIIDHAYJKoZIhvcNAQkGMYIDDTCC

# AwkCAQEwdzBjMQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4x

# OzA5BgNVBAMTMkRpZ2lDZXJ0IFRydXN0ZWQgRzQgUlNBNDA5NiBTSEEyNTYgVGlt

# ZVN0YW1waW5nIENBAhAKekqInsmZQpAGYzhNhpedMA0GCWCGSAFlAwQCAQUAoGkw

# GAYJKoZIhvcNAQkDMQsGCSqGSIb3DQEHATAcBgkqhkiG9w0BCQUxDxcNMjIwNDIw

# MTUwNDUyWjAvBgkqhkiG9w0BCQQxIgQgxHf8acptXw/7joRlSKZU3LqecOtm+t5E

# RA4StU+b3+0wDQYJKoZIhvcNAQEBBQAEggIAJ4kDcXfBm8lJkay+qUcZFWC9u/o+

# iC7NIBulWmJKKfw32NsSgER7NMe+0bpdISjSaPphu/Xpn8coUEhZp2aAp6t5Nqfl

# x3uqWKT9LrgStPmddZKu1Nce/yhskw0ioFFNU0DHVkpK16FgKJ1u6iQfyeUbKI5q

# 2rQnk4z3Rbr/31cnkK2R81vesn7BpRfhd2p2XPRoR4z4bb8Kaeu2rd1DaSlidrtb

# h9x/0tSaajoz+mjxG5NI+BR1VJU/oF8nBbhlQ8LItMspROWBJtP7TF+yx4/1zg+h

# ZLxTEci5KtKHTo0ni8tEgeqptVnzqu9ihMLcYbqI08rsFY/8J9BYb+3+vRqXG/dr

# DmzrNmb2KcRWhdPlNto7dqKbNMTzVTMPbtH4Azdri+WvFpxcHwNBlHOgjWvY1lfo

# bDUiMjw03tYtP/rLEJJPtwbJXd2j8iSluwH/8J5vtIQ4g+ethRcZxSPvunJaLRwF

# MpmME+EjN7RfR+2lrhmnGqJf3wFGw2a0+eaYjcoRiThRsrS8vGpLqBFJVbCa6Hj4

# qctoPznjt1D/ZfcUZ9m+4DTiOW7zmS7nkAtOpsutCOjrZQb0o783qlggGAkonRmC

# Xw8t4B0CD0a1RTvSXuEP53t4hZM5SmYx8njnBkE3VrBWojqDdX3Lhl4zO1ZWFJT4

# nbltn2J1WFrNUyg=

# SIG # End signature block