PowerShellForGitHub

0.13.0

GitHubProjectCards.ps1

                                # Copyright (c) Microsoft Corporation. All rights reserved.

# Licensed under the MIT License.

function Get-GitHubProjectCard

{

<#

    .DESCRIPTION

        Get the cards for a given Github Project Column.

        The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub

    .PARAMETER Column

        ID of the column to retrieve cards for.

    .PARAMETER ArchivedState

        Only cards with this ArchivedState are returned.

        Options are all, archived, or NotArchived (default).

    .PARAMETER AccessToken

        If provided, this will be used as the AccessToken for authentication with the

        REST Api.  Otherwise, will attempt to use the configured value or will run unauthenticated.

    .PARAMETER NoStatus

        If this switch is specified, long-running commands will run on the main thread

        with no command line status update.  When not specified, those commands run in

        the background, enabling the command prompt to provide status information.

        If not supplied here, the DefaultNoStatus configuration property value will be used.

    .EXAMPLE

        Get-GitHubProjectCard -Column 999999

        Get the the not_archived cards for column 999999.

    .EXAMPLE

        Get-GitHubProjectCard -Column 999999 -ArchivedState All

        Gets all the cards for column 999999, no matter the ArchivedState.

    .EXAMPLE

        Get-GitHubProjectCard -Column 999999 -ArchivedState Archived

        Gets the archived cards for column 999999.

    .EXAMPLE

        Get-GitHubProjectCard -Card 999999

        Gets the card with ID 999999.

#>

    [CmdletBinding(

        SupportsShouldProcess,

        DefaultParameterSetName = 'Column')]

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification = "Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")]

    param(

        [Parameter(Mandatory, ParameterSetName = 'Column')]

        [int64] $Column,

        [Parameter(Mandatory, ParameterSetName = 'Card')]

        [int64] $Card,

        [ValidateSet('All', 'Archived', 'NotArchived')]

        [string] $ArchivedState = 'NotArchived',

        [string] $AccessToken,

        [switch] $NoStatus

    )

    Write-InvocationLog

    $telemetryProperties = @{}

    $uriFragment = [String]::Empty

    $description = [String]::Empty

    if ($PSCmdlet.ParameterSetName -eq 'Column')

    {

        $telemetryProperties['Column'] = $true

        $uriFragment = "/projects/columns/$Column/cards"

        $description = "Getting cards for column $Column"

    }

    elseif ($PSCmdlet.ParameterSetName -eq 'Card')

    {

        $telemetryProperties['Card'] = $true

        $uriFragment = "/projects/columns/cards/$Card"

        $description = "Getting project card $Card"

    }

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

    {

        $getParams = @()

        $Archived = $ArchivedState.ToLower().Replace('notarchived','not_archived')

        $getParams += "archived_state=$Archived"

        $uriFragment = "$uriFragment`?" + ($getParams -join '&')

        $description += " with ArchivedState '$Archived'"

    }

    $params = @{

        'UriFragment' = $uriFragment

        'Description' = $description

        'AccessToken' = $AccessToken

        'TelemetryEventName' = $MyInvocation.MyCommand.Name

        'TelemetryProperties' = $telemetryProperties

        'NoStatus' = (Resolve-ParameterWithDefaultConfigurationValue -Name NoStatus -ConfigValueName DefaultNoStatus)

        'AcceptHeader' = 'application/vnd.github.inertia-preview+json'

    }

    return Invoke-GHRestMethodMultipleResult @params

}

function New-GitHubProjectCard

{

<#

    .DESCRIPTION

        Creates a new card for a Github project.

        The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub

    .PARAMETER Column

        ID of the column to create a card for.

    .PARAMETER Note

        The name of the column to create.

    .PARAMETER ContentId

        The issue or pull request ID you want to associate with this card.

    .PARAMETER ContentType

        The type of content you want to associate with this card.

        Required if you provide ContentId.

        Use Issue when ContentId is an issue ID and use PullRequest when ContentId is a pull request id.

    .PARAMETER AccessToken

        If provided, this will be used as the AccessToken for authentication with the

        REST Api.  Otherwise, will attempt to use the configured value or will run unauthenticated.

    .PARAMETER NoStatus

        If this switch is specified, long-running commands will run on the main thread

        with no command line status update.  When not specified, those commands run in

        the background, enabling the command prompt to provide status information.

        If not supplied here, the DefaultNoStatus configuration property value will be used.

    .EXAMPLE

        New-GitHubProjectCard -Column 999999 -Note 'Note on card'

        Creates a card on column 999999 with the note 'Note on card'.

    .EXAMPLE

        New-GitHubProjectCard -Column 999999 -ContentId 888888 -ContentType Issue

        Creates a card on column 999999 for the issue with ID 888888.

    .EXAMPLE

        New-GitHubProjectCard -Column 999999 -ContentId 888888 -ContentType Issue

        Creates a card on column 999999 for the issue with ID 888888.

    .EXAMPLE

        New-GitHubProjectCard -Column 999999 -ContentId 777777 -ContentType PullRequest

        Creates a card on column 999999 for the pull request with ID 777777.

#>

    [CmdletBinding(

        SupportsShouldProcess,

        DefaultParameterSetName = 'Note')]

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification = "Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")]

    param(

        [Parameter(Mandatory)]

        [int64] $Column,

        [Parameter(Mandatory, ParameterSetName = 'Note')]

        [string] $Note,

        [Parameter(Mandatory, ParameterSetName = 'Content')]

        [int64] $ContentId,

        [Parameter(Mandatory, ParameterSetName = 'Content')]

        [ValidateSet('Issue', 'PullRequest')]

        [string] $ContentType,

        [string] $AccessToken,

        [switch] $NoStatus

    )

    Write-InvocationLog

    $telemetryProperties = @{}

    $uriFragment = "/projects/columns/$Column/cards"

    $apiDescription = "Creating project card"

    if ($PSCmdlet.ParameterSetName -eq 'Note')

    {

        $telemetryProperties['Note'] = $true

        $hashBody = @{

            'note' = $Note

        }

    }

    elseif ($PSCmdlet.ParameterSetName -eq 'Content')

    {

        $telemetryProperties['Content'] = $true

        $hashBody = @{

            'content_id' = $ContentId

            'content_type' = $ContentType

        }

    }

    $params = @{

        'UriFragment' = $uriFragment

        'Body' = (ConvertTo-Json -InputObject $hashBody)

        'Method' = 'Post'

        'Description' = $apiDescription

        'AccessToken' = $AccessToken

        'TelemetryEventName' = $MyInvocation.MyCommand.Name

        'TelemetryProperties' = $telemetryProperties

        'NoStatus' = (Resolve-ParameterWithDefaultConfigurationValue -Name NoStatus -ConfigValueName DefaultNoStatus)

        'AcceptHeader' = 'application/vnd.github.inertia-preview+json'

    }

    return Invoke-GHRestMethod @params

}

function Set-GitHubProjectCard

{

<#

    .DESCRIPTION

        Modify a GitHub Project Card.

        The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub

    .PARAMETER Card

        ID of the card to modify.

    .PARAMETER Note

        The note content for the card.  Only valid for cards without another type of content,

        so this cannot be specified if the card already has a content_id and content_type.

    .PARAMETER Archive

        Archive a project card.

    .PARAMETER Restore

        Restore a project card.

    .PARAMETER AccessToken

        If provided, this will be used as the AccessToken for authentication with the

        REST Api.  Otherwise, will attempt to use the configured value or will run unauthenticated.

    .PARAMETER NoStatus

        If this switch is specified, long-running commands will run on the main thread

        with no command line status update.  When not specified, those commands run in

        the background, enabling the command prompt to provide status information.

        If not supplied here, the DefaultNoStatus configuration property value will be used.

    .EXAMPLE

        Set-GitHubProjectCard -Card 999999 -Note UpdatedNote

        Sets the card note to 'UpdatedNote' for the card with ID 999999.

    .EXAMPLE

        Set-GitHubProjectCard -Card 999999 -Archive

        Archives the card with ID 999999.

    .EXAMPLE

        Set-GitHubProjectCard -Card 999999 -Restore

        Restores the card with ID 999999.

#>

    [CmdletBinding(

    SupportsShouldProcess,

    DefaultParameterSetName = 'Note')]

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification = "Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")]

    param(

        [Parameter(Mandatory)]

        [int64] $Card,

        [string] $Note,

        [Parameter(ParameterSetName = 'Archive')]

        [switch] $Archive,

        [Parameter(ParameterSetName = 'Restore')]

        [switch] $Restore,

        [string] $AccessToken,

        [switch] $NoStatus

    )

    Write-InvocationLog

    $telemetryProperties = @{}

    $uriFragment = "/projects/columns/cards/$Card"

    $apiDescription = "Updating card $Card"

    $hashBody = @{}

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

    {

        $telemetryProperties['Note'] = $true

        $hashBody.add('note', $Note)

    }

    if ($Archive)

    {

        $telemetryProperties['Archive'] = $true

        $hashBody.add('archived', $true)

    }

    if ($Restore)

    {

        $telemetryProperties['Restore'] = $true

        $hashBody.add('archived', $false)

    }

    $params = @{

        'UriFragment' = $uriFragment

        'Description' = $apiDescription

        'Body' = (ConvertTo-Json -InputObject $hashBody)

        'AccessToken' = $AccessToken

        'Method' = 'Patch'

        'TelemetryEventName' = $MyInvocation.MyCommand.Name

        'TelemetryProperties' = $telemetryProperties

        'NoStatus' = (Resolve-ParameterWithDefaultConfigurationValue -Name NoStatus -ConfigValueName DefaultNoStatus)

        'AcceptHeader' = 'application/vnd.github.inertia-preview+json'

    }

    return Invoke-GHRestMethod @params

}

function Remove-GitHubProjectCard

{

<#

    .DESCRIPTION

        Removes a project card.

        The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub

    .PARAMETER Card

        ID of the card to remove.

    .PARAMETER AccessToken

        If provided, this will be used as the AccessToken for authentication with the

        REST Api.  Otherwise, will attempt to use the configured value or will run unauthenticated.

    .PARAMETER NoStatus

        If this switch is specified, long-running commands will run on the main thread

        with no command line status update.  When not specified, those commands run in

        the background, enabling the command prompt to provide status information.

        If not supplied here, the DefaultNoStatus configuration property value will be used.

    .EXAMPLE

        Remove-GitHubProjectCard -Card 999999

        Remove project card with ID 999999.

    .EXAMPLE

        Remove-GitHubProjectCard -Card 999999 -Confirm:$False

        Remove project card with ID 999999 without prompting for confirmation.

#>

    [CmdletBinding(

        SupportsShouldProcess,

        ConfirmImpact = 'High')]

    [Alias('Delete-GitHubProjectCard')]

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification = "Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")]

    param(

        [Parameter(Mandatory)]

        [int64] $Card,

        [string] $AccessToken,

        [switch] $NoStatus

    )

    Write-InvocationLog

    $telemetryProperties = @{}

    $uriFragment = "/projects/columns/cards/$Card"

    $description = "Deleting card $Card"

    if ($PSCmdlet.ShouldProcess($Card, "Remove card"))

    {

        $params = @{

            'UriFragment' = $uriFragment

            'Description' = $description

            'AccessToken' = $AccessToken

            'Method' = 'Delete'

            'TelemetryEventName' = $MyInvocation.MyCommand.Name

            'TelemetryProperties' = $telemetryProperties

            'NoStatus' = (Resolve-ParameterWithDefaultConfigurationValue -Name NoStatus -ConfigValueName DefaultNoStatus)

            'AcceptHeader' = 'application/vnd.github.inertia-preview+json'

        }

        return Invoke-GHRestMethod @params

    }

}

function Move-GitHubProjectCard

{

<#

    .DESCRIPTION

        Move a GitHub Project Card.

        The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub

    .PARAMETER Card

        ID of the card to move.

    .PARAMETER Top

        Moves the card to the top of the column.

    .PARAMETER Bottom

        Moves the card to the bottom of the column.

    .PARAMETER After

        Moves the card to the position after the card ID specified.

    .PARAMETER ColumnId

        The ID of a column in the same project to move the card to.

    .PARAMETER AccessToken

        If provided, this will be used as the AccessToken for authentication with the

        REST Api.  Otherwise, will attempt to use the configured value or will run unauthenticated.

    .PARAMETER NoStatus

        If this switch is specified, long-running commands will run on the main thread

        with no command line status update.  When not specified, those commands run in

        the background, enabling the command prompt to provide status information.

        If not supplied here, the DefaultNoStatus configuration property value will be used.

    .EXAMPLE

        Move-GitHubProjectCard -Card 999999 -Top

        Moves the project card with ID 999999 to the top of the column.

    .EXAMPLE

        Move-GitHubProjectCard -Card 999999 -Bottom

        Moves the project card with ID 999999 to the bottom of the column.

    .EXAMPLE

        Move-GitHubProjectCard -Card 999999 -After 888888

        Moves the project card with ID 999999 to the position after the card ID 888888.

        Within the same column.

    .EXAMPLE

        Move-GitHubProjectCard -Card 999999 -After 888888 -ColumnId 123456

        Moves the project card with ID 999999 to the position after the card ID 888888, in

        the column with ID 123456.

#>

    [CmdletBinding(

        SupportsShouldProcess)]

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification = "Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")]

    param(

        [Parameter(Mandatory)]

        [int64] $Card,

        [switch] $Top,

        [switch] $Bottom,

        [int64] $After,

        [int64] $ColumnId,

        [string] $AccessToken,

        [switch] $NoStatus

    )

    Write-InvocationLog

    $telemetryProperties = @{}

    $uriFragment = "/projects/columns/cards/$Card/moves"

    $apiDescription = "Updating card $Card"

    if (-not ($Top -xor $Bottom -xor ($After -gt 0)))

    {

        $message = 'You must use one (and only one) of the parameters Top, Bottom or After.'

        Write-Log -Message $message -level Error

        throw $message

    }

    elseif ($Top)

    {

        $position = 'top'

    }

    elseif ($Bottom)

    {

        $position = 'bottom'

    }

    else

    {

        $position = "after:$After"

    }

    $hashBody = @{

        'position' = $Position

    }

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

    {

        $telemetryProperties['ColumnId'] = $true

        $hashBody.add('column_id', $ColumnId)

    }

    $params = @{

        'UriFragment' = $uriFragment

        'Description' = $apiDescription

        'Body' = (ConvertTo-Json -InputObject $hashBody)

        'AccessToken' = $AccessToken

        'Method' = 'Post'

        'TelemetryEventName' = $MyInvocation.MyCommand.Name

        'TelemetryProperties' = $telemetryProperties

        'NoStatus' = (Resolve-ParameterWithDefaultConfigurationValue -Name NoStatus -ConfigValueName DefaultNoStatus)

        'AcceptHeader' = 'application/vnd.github.inertia-preview+json'

    }

    return Invoke-GHRestMethod @params

}

# SIG # Begin signature block

# MIIjlgYJKoZIhvcNAQcCoIIjhzCCI4MCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDZCVE3p01NRwCj

# Ai4Q5srALneCzHTRvtokhBXu5pPNAaCCDYUwggYDMIID66ADAgECAhMzAAABiK9S

# 1rmSbej5AAAAAAGIMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjAwMzA0MTgzOTQ4WhcNMjEwMzAzMTgzOTQ4WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQCSCNryE+Cewy2m4t/a74wZ7C9YTwv1PyC4BvM/kSWPNs8n0RTe+FvYfU+E9uf0

# t7nYlAzHjK+plif2BhD+NgdhIUQ8sVwWO39tjvQRHjP2//vSvIfmmkRoML1Ihnjs

# 9kQiZQzYRDYYRp9xSQYmRwQjk5hl8/U7RgOiQDitVHaU7BT1MI92lfZRuIIDDYBd

# vXtbclYJMVOwqZtv0O9zQCret6R+fRSGaDNfEEpcILL+D7RV3M4uaJE4Ta6KAOdv

# V+MVaJp1YXFTZPKtpjHO6d9pHQPZiG7NdC6QbnRGmsa48uNQrb6AfmLKDI1Lp31W

# MogTaX5tZf+CZT9PSuvjOCLNAgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUj9RJL9zNrPcL10RZdMQIXZN7MG8w

# VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh

# dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzQ1ODM4NjAfBgNVHSMEGDAW

# gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw

# MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov

# L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx

# XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB

# ACnXo8hjp7FeT+H6iQlV3CcGnkSbFvIpKYafgzYCFo3UHY1VHYJVb5jHEO8oG26Q

# qBELmak6MTI+ra3WKMTGhE1sEIlowTcp4IAs8a5wpCh6Vf4Z/bAtIppP3p3gXk2X

# 8UXTc+WxjQYsDkFiSzo/OBa5hkdW1g4EpO43l9mjToBdqEPtIXsZ7Hi1/6y4gK0P

# mMiwG8LMpSn0n/oSHGjrUNBgHJPxgs63Slf58QGBznuXiRaXmfTUDdrvhRocdxIM

# i8nXQwWACMiQzJSRzBP5S2wUq7nMAqjaTbeXhJqD2SFVHdUYlKruvtPSwbnqSRWT

# GI8s4FEXt+TL3w5JnwVZmZkUFoioQDMMjFyaKurdJ6pnzbr1h6QW0R97fWc8xEIz

# LIOiU2rjwWAtlQqFO8KNiykjYGyEf5LyAJKAO+rJd9fsYR+VBauIEQoYmjnUbTXM

# SY2Lf5KMluWlDOGVh8q6XjmBccpaT+8tCfxpaVYPi1ncnwTwaPQvVq8RjWDRB7Pa

# 8ruHgj2HJFi69+hcq7mWx5nTUtzzFa7RSZfE5a1a5AuBmGNRr7f8cNfa01+tiWjV

# Kk1a+gJUBSP0sIxecFbVSXTZ7bqeal45XSDIisZBkWb+83TbXdTGMDSUFKTAdtC+

# r35GfsN8QVy59Hb5ZYzAXczhgRmk7NyE6jD0Ym5TKiW5MIIHejCCBWKgAwIBAgIK

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

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p

# Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAAGIr1LWuZJt6PkAAAAA

# AYgwDQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw

# HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIMuB

# V6lTiEPOHIKfeT87blfDptyWqap45u+7dqfo/hooMEIGCisGAQQBgjcCAQwxNDAy

# oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20wDQYJKoZIhvcNAQEBBQAEggEAVkMFn3sgOxx62i+cx+Hyb8ndt0yCuBNxiAp8

# Q5VNjSkswJYgB34yj2d29q4eX3E8MRj44PWvK0lV23bF7LTgt/siEGwifM8oivmm

# usmzzOTZqZXOKy4ij9ugtdN3VGjxzXJsGiZUkCmLb2SsW9F8m1pSPEgXULqil9DR

# d8Rm8h7CjDGV/sqKWO2CJPXijtQUvn8uXBkrp5yy+OmAfhvRAP1lGbgtuH6HFFZW

# ljuL4ms6BjBco03FAOqqpuNhnoU/LHjiFxU+TA3WKw312YJdsQqQ5dAYwrikKFnl

# tqELmf3hhcifQbUTG4J27u6w5wizbeY//8WDveSkoDvn7h9WsKGCEvEwghLtBgor

# BgEEAYI3AwMBMYIS3TCCEtkGCSqGSIb3DQEHAqCCEsowghLGAgEDMQ8wDQYJYIZI

# AWUDBAIBBQAwggFVBgsqhkiG9w0BCRABBKCCAUQEggFAMIIBPAIBAQYKKwYBBAGE

# WQoDATAxMA0GCWCGSAFlAwQCAQUABCDSLvkGjkwejymjqmJWCIyBylvyD09aoT2K

# sDWQNl7TWQIGXqbmLuT8GBMyMDIwMDUxMjE5MTcxMi40NDJaMASAAgH0oIHUpIHR

# MIHOMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSkwJwYDVQQL

# EyBNaWNyb3NvZnQgT3BlcmF0aW9ucyBQdWVydG8gUmljbzEmMCQGA1UECxMdVGhh

# bGVzIFRTUyBFU046MEE1Ni1FMzI5LTRENEQxJTAjBgNVBAMTHE1pY3Jvc29mdCBU

# aW1lLVN0YW1wIFNlcnZpY2Wggg5EMIIE9TCCA92gAwIBAgITMwAAAScvbqPvkagZ

# qAAAAAABJzANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMK

# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0

# IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0Eg

# MjAxMDAeFw0xOTEyMTkwMTE0NTlaFw0yMTAzMTcwMTE0NTlaMIHOMQswCQYDVQQG

# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG

# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSkwJwYDVQQLEyBNaWNyb3NvZnQg

# T3BlcmF0aW9ucyBQdWVydG8gUmljbzEmMCQGA1UECxMdVGhhbGVzIFRTUyBFU046

# MEE1Ni1FMzI5LTRENEQxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNl

# cnZpY2UwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQD4Ad5xEZ5On0uN

# L71ng9xwoDPRKeMUyEIj5yVxPRPh5GVbU7D3pqDsoXzQMhfeRP61L1zlU1HCRS+1

# 29eo0yj1zjbAlmPAwosUgyIonesWt9E4hFlXCGUcIg5XMdvQ+Ouzk2r+awNRuk8A

# BGOa0I4VBy6zqCYHyX2pGauiB43frJSNP6pcrO0CBmpBZNjgepof5Z/50vBuJDUS

# ug6OIMQ7ZwUhSzX4bEmZUUjAycBb62dhQpGqHsXe6ypVDTgAEnGONdSBKkHiNT8H

# 0Zt2lm0vCLwHyTwtgIdi67T/LCp+X2mlPHqXsY3u72X3GYn/3G8YFCkrSc6m3b0w

# TXPd5/2fAgMBAAGjggEbMIIBFzAdBgNVHQ4EFgQU5fSWVYBfOTEkW2JTiV24WNNt

# lfIwHwYDVR0jBBgwFoAU1WM6XIoxkPNDe3xGG8UzaFqFbVUwVgYDVR0fBE8wTTBL

# oEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMv

# TWljVGltU3RhUENBXzIwMTAtMDctMDEuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggr

# BgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNU

# aW1TdGFQQ0FfMjAxMC0wNy0wMS5jcnQwDAYDVR0TAQH/BAIwADATBgNVHSUEDDAK

# BggrBgEFBQcDCDANBgkqhkiG9w0BAQsFAAOCAQEACsqNfNFVxwalZ42cEMuzZc12

# 6Nvluanx8UewDVeUQZEZHRmppMFHAzS/g6RzmxTyR2tKE3mChNGW5dTL730vEbRh

# nYRmBgiX/gT3f4AQrOPnZGXY7zszcrlbgzxpakOX+x0u4rkP3Ashh3B2CdJ11XsB

# di5PiZa1spB6U5S8D15gqTUfoIniLT4v1DBdkWExsKI1vsiFcDcjGJ4xRlMRF+fw

# 7SY0WZoOzwRzKxDTdg4DusAXpaeKbch9iithLFk/vIxQrqCr/niW8tEA+eSzeX/E

# q1D0ZyvOn4e2lTnwoJUKH6OQAWSBogyK4OCbFeJOqdKAUiBTgHKkQIYh/tbKQjCC

# BnEwggRZoAMCAQICCmEJgSoAAAAAAAIwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNV

# BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w

# HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29m

# dCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEwMB4XDTEwMDcwMTIxMzY1

# NVoXDTI1MDcwMTIxNDY1NVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp

# bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw

# b3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAw

# ggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCpHQ28dxGKOiDs/BOX9fp/

# aZRrdFQQ1aUKAIKF++18aEssX8XD5WHCdrc+Zitb8BVTJwQxH0EbGpUdzgkTjnxh

# MFmxMEQP8WCIhFRDDNdNuDgIs0Ldk6zWczBXJoKjRQ3Q6vVHgc2/JGAyWGBG8lhH

# hjKEHnRhZ5FfgVSxz5NMksHEpl3RYRNuKMYa+YaAu99h/EbBJx0kZxJyGiGKr0tk

# iVBisV39dx898Fd1rL2KQk1AUdEPnAY+Z3/1ZsADlkR+79BL/W7lmsqxqPJ6Kgox

# 8NpOBpG2iAg16HgcsOmZzTznL0S6p/TcZL2kAcEgCZN4zfy8wMlEXV4WnAEFTyJN

# AgMBAAGjggHmMIIB4jAQBgkrBgEEAYI3FQEEAwIBADAdBgNVHQ4EFgQU1WM6XIox

# kPNDe3xGG8UzaFqFbVUwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0P

# BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU1fZWy4/oolxiaNE9

# lJBb186aGMQwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQu

# Y29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3Js

# MFoGCCsGAQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3Nv

# ZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcnQwgaAG

# A1UdIAEB/wSBlTCBkjCBjwYJKwYBBAGCNy4DMIGBMD0GCCsGAQUFBwIBFjFodHRw

# Oi8vd3d3Lm1pY3Jvc29mdC5jb20vUEtJL2RvY3MvQ1BTL2RlZmF1bHQuaHRtMEAG

# CCsGAQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAFAAbwBsAGkAYwB5AF8AUwB0AGEA

# dABlAG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQAH5ohRDeLG4Jg/gXED

# PZ2joSFvs+umzPUxvs8F4qn++ldtGTCzwsVmyWrf9efweL3HqJ4l4/m87WtUVwgr

# UYJEEvu5U4zM9GASinbMQEBBm9xcF/9c+V4XNZgkVkt070IQyK+/f8Z/8jd9Wj8c

# 8pl5SpFSAK84Dxf1L3mBZdmptWvkx872ynoAb0swRCQiPM/tA6WWj1kpvLb9BOFw

# nzJKJ/1Vry/+tuWOM7tiX5rbV0Dp8c6ZZpCM/2pif93FSguRJuI57BlKcWOdeyFt

# w5yjojz6f32WapB4pm3S4Zz5Hfw42JT0xqUKloakvZ4argRCg7i1gJsiOCC1JeVk

# 7Pf0v35jWSUPei45V3aicaoGig+JFrphpxHLmtgOR5qAxdDNp9DvfYPw4TtxCd9d

# dJgiCGHasFAeb73x4QDf5zEHpJM692VHeOj4qEir995yfmFrb3epgcunCaw5u+zG

# y9iCtHLNHfS4hQEegPsbiSpUObJb2sgNVZl6h3M7COaYLeqN4DMuEin1wC9UJyH3

# yKxO2ii4sanblrKnQqLJzxlBTeCG+SqaoxFmMNO7dDJL32N79ZmKLxvHIa9Zta7c

# RDyXUHHXodLFVeNp3lfB0d4wwP3M5k37Db9dT+mdHhk4L7zPWAUu7w2gUDXa7wkn

# HNWzfjUeCLraNtvTX4/edIhJEqGCAtIwggI7AgEBMIH8oYHUpIHRMIHOMQswCQYD

# VQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEe

# MBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSkwJwYDVQQLEyBNaWNyb3Nv

# ZnQgT3BlcmF0aW9ucyBQdWVydG8gUmljbzEmMCQGA1UECxMdVGhhbGVzIFRTUyBF

# U046MEE1Ni1FMzI5LTRENEQxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1w

# IFNlcnZpY2WiIwoBATAHBgUrDgMCGgMVALOVuE5sgxzETO4s+poBqI6r1x8zoIGD

# MIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNV

# BAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQG

# A1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwDQYJKoZIhvcNAQEF

# BQACBQDiZSrqMCIYDzIwMjAwNTEyMTgwMjE4WhgPMjAyMDA1MTMxODAyMThaMHcw

# PQYKKwYBBAGEWQoEATEvMC0wCgIFAOJlKuoCAQAwCgIBAAICLysCAf8wBwIBAAIC

# EnEwCgIFAOJmfGoCAQAwNgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAK

# MAgCAQACAwehIKEKMAgCAQACAwGGoDANBgkqhkiG9w0BAQUFAAOBgQBGEJmTTMZQ

# rvvYWAr+clBRhbpOpANMzCfrzTIZlPxooOvTIKKR2nCix9UwHqBZGBab94qudwqD

# M7WDAHL7VItIzxGKh7oZ3B7TiRfSaklQ/LEOVlG98NCkGZBGM7O2D0m8boEs/MfP

# 2UngfPwdhEC3/Bo2f4ZJYMPsOGczzf0hQjGCAw0wggMJAgEBMIGTMHwxCzAJBgNV

# BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w

# HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29m

# dCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAABJy9uo++RqBmoAAAAAAEnMA0GCWCG

# SAFlAwQCAQUAoIIBSjAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZI

# hvcNAQkEMSIEIHgGTjsaEWaoC8k68pTg1oHZEx2UnOuRbZHoYogcskASMIH6Bgsq

# hkiG9w0BCRACLzGB6jCB5zCB5DCBvQQgG5LoSxKGHWoW/wVMlbMztlQ4upAdzEmq

# H//vLu0jPiIwgZgwgYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu

# Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv

# cmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAIT

# MwAAAScvbqPvkagZqAAAAAABJzAiBCBEbxpfRXi+JaiCXK5vxlDpmXfNQycKDrPM

# 19LppHn8+TANBgkqhkiG9w0BAQsFAASCAQDXIUPtJF0haLlkVO0TCRRUFk9RjeK+

# joryz/UW/D8xLvOXGxH0R9fSuwKwpeU52ppgDCYUDY8/2n+QFec+5OlurMQrNgLu

# SR0hSbLsXqtSyxGadp1hOzyVPfnzgocr3qsZCWudFCq8ulGFFHnhVcviDQ+Z/lJi

# R6RqLGosCGxeBe6W/n/MJfyQcd1KnenMT7MEf/17Fbb/b7g90j7AnRjEDPyEckjk

# QoHpX3D6fEGP4Stg/xAwbwZOqC11ERrt+oaIqqhhTAXmCaWc/b5Pl+G4Mri0BXRd

# IMCerAkwUcnEcMZJGQy38frogNQ4XbIPFCGVLvgRlH4wJjqImxdT+mXF

# SIG # End signature block