PSSDPAPI

1.0.2.2

Request/Note/Get-SDPRequestNote.ps1

Function Get-SDPRequestNote
{
    <#
    .SYNOPSIS
        Get note by id
 
    .PARAMETER RequestId
        Request id
 
    .PARAMETER NoteId
        Note id
 
    .PARAMETER InputData
        Custom search object.
 
list_info :
{
    "row_count" : number of rows to be returned(maximum row_count = 100)
    "start_index" : starting row index
    "sort_field" : "fieldName"
    "sort_order" : “asc/desc”,
    "get_total_count" : boolean (by default it will be false)
    "has_more_rows" : boolean (will be returned with the response)
    "total_count" : count (will be returned with the response only)
    "search_criteria" : Refer search criteria object given in the attributes of List Info(For performing advanced search)
    "fields_required" : [ "list of fields required" ]
}
 
    .PARAMETER Limit
        Limit returned data. Default return last 100 items.
 
    .EXAMPLE
        $Notes = Get-SDPRequestNote -RequestId 54321
 
    .EXAMPLE
        $Note = Get-SDPRequestNote -RequestId 54321 -NoteId 12345
 
    .NOTES
        Author: Michal Gajda
 
    .LINK
        https://www.manageengine.com/products/service-desk/sdpod-v3-api/requests/request_note.html#get-list-request-note
        https://www.manageengine.com/products/service-desk/sdpod-v3-api/requests/request_note.html#get-request-note
    #>
    [CmdletBinding(
        SupportsShouldProcess=$True,
        ConfirmImpact="Low",
        DefaultParameterSetName="Search"
    )]
    param (
        [String]$UriSDP,
        [String]$ApiKey,
        [Parameter(Mandatory=$true,
            ValueFromPipeline)]
        [Int]$RequestId,
        [Parameter(ParameterSetName="ItemId")]
        [Int]$NoteId,
        [Parameter(ParameterSetName="Search")]
        $InputData,
        [Parameter(ParameterSetName="Search")]
        [ValidateScript({($_ -is [int] -and $_ -gt 0) -or $_ -eq "All"})]
        $Limit = 100
    )

    Begin
    {
        #Create headers
        if(!$MyInvocation.BoundParameters.ContainsKey("UriSDP")) { $UriSDP = $Global:UriSDP }
        if(!$MyInvocation.BoundParameters.ContainsKey("ApiKey")) { $ApiKey = $Global:ApiKey }
    }

    Process
    {
        if($MyInvocation.BoundParameters.ContainsKey("NoteId"))
        {
            #Get by ID
            $InvokeParams = @{
                UriSDP = $UriSDP
                ApiKey = $ApiKey
                Method = "GET"
                EntityUri = "/api/v3/requests/$RequestId/notes/$NoteId"
            }

            #Send request
            If ($PSCmdlet.ShouldProcess($RequestId,"Get note $NoteId from request id"))
            {
                $Result = Invoke-SDPAPIEntity @InvokeParams
                $Results = $Result.note
            }
        } else {
            #Get by Search
            $InvokeParams = @{
                UriSDP = $UriSDP
                ApiKey = $ApiKey
                Method = "GET"
                EntityUri = "/api/v3/requests/$RequestId/notes"
                Limit = $Limit
            }
            if($MyInvocation.BoundParameters.ContainsKey("InputData"))
            {
                $InvokeParams['InputData'] = $InputData
            } else {
                $InvokeParams['InputData'] = @{
                    list_info = @{
                        start_index = 1
                        row_count = $Limit
                        sort_field = "id"
                        sort_order = "desc"
                    }
                }
            }

            #Send request
            If ($PSCmdlet.ShouldProcess($RequestId,"Get notes from request id"))
            {
                $Result = Invoke-SDPAPIEntity @InvokeParams
                $Results = $Result.notes
            }
        }

        #Return result
        if($MyInvocation.BoundParameters.ContainsKey("Debug"))
        {
            Return $Result
        } else {
            Write-Verbose ($Results | Measure-Object).Count
            Return $Results
        }
    }

    End{}
}