Public/Get-ZomentumOpportunities.ps1
|
function Get-ZomentumOpportunities { <# .SYNOPSIS Gets Opportunities from the Zomentum API. .DESCRIPTION Retrieves Opportunities from the Zomentum API - supports a variety of filtering parameters. .OUTPUTS A powershell object containing the response. #> [CmdletBinding()] Param( # Opportunity ID for retrieving a single Opportunity [Parameter( ParameterSetName = 'Single', Mandatory = $True )] [string]$OpportunityID, # An Object containing filter variables [Parameter( ParameterSetName = 'Multiple')] [PSCustomObject]$Filters, # The pipeline for which opportunities will be fetched. If no argument is passed the default pipline will be used. [Parameter( ParameterSetName = 'Multiple')] [string]$PipelineID, # The Child entities to include with the records. [Parameter( ParameterSetName = 'Single')] [Parameter( ParameterSetName = 'Multiple')] [string]$IncludeChildren ) if ($OpportunityID) { $QueryString = '' if ($IncludeChildren){ $QueryString = $QueryString + "?included_child_entities=$IncludeChildren" } Write-Verbose "Fetching Single Opportunities" $Opportunities = Invoke-ZomentumRequest -method get -resource "opportunities/$OpportunityID" -QueryString $QueryString } else { $QueryString = '' if ($PipelineID){ $QueryString = "&opportunity_pipeline_id=$PipelineID" } if ($IncludeChildren){ $QueryString = $QueryString + "&included_child_entities=$IncludeChildren" } Write-Verbose "Fetching Multiple Opportunities" $Opportunities = Invoke-ZomentumRequest -method get -resource "opportunities" -Filters $Filters -MultiFetch -QueryString $QueryString } return $Opportunities } |