Executes query on service requests.

Description

Executes a query on service requests by providing a ServiceRequest object which contain parameters to filter the results by the place of supply and/or the status.

Package Details

Interface

IServiceRequestManager

Syntax

Task<ICollection<ServiceRequest>> ExecuteQuery<T>(ServiceRequestQuery serviceRequestQuery)

Returns

Task<ICollection<ServiceRequest>>

API Endpoint

[POST] /api/servicerequests/query

Parameters

Parameter	Description	Parameter Type

Parameter

Description

Parameter Type

excludeServiceRequests

True to include service requests in the result.

False to exclude service requests in the result.

Query string

ServiceRequestQuery
(details at bottom of page)

This object is used to define the filtering for the place of supply and status.

Request body

Sample request body - filtering by place of supply and status for service id 11.

Note: You cannot use the UserId, ServiceId and OrganizationId at the same time. Only one, or two of them can be used at the same time.

{
  "UserId": 0,
  "ServiceId": 11,
  "OrganizationId": 0,
  "ExcludeMetadata": false,
  "Page": 1,
  "PageSize": 25,
  "Filter": "PlaceOfSupply='ON' AND Status='InProgress'",
  "Version": 1
}

Sample request body - filtering by place of supply for service id 11.

Note: You cannot use the UserId, ServiceId and OrganizationId at the same time. Only one, or two of them can be used at the same time.

{
  "UserId": 0,
  "ServiceId": 11,
  "OrganizationId": 0,
  "ExcludeMetadata": false,
  "Page": 1,
  "PageSize": 25,
  "Filter": "PlaceOfSupply='ON'",
  "Version": 1
}

Sample request body - filtering by status for service id 11.

Note: You cannot use the UserId, ServiceId and OrganizationId at the same time. Only one, or two of them can be used at the same time.

{
  "UserId": 0,
  "ServiceId": 11,
  "OrganizationId": 0,
  "ExcludeMetadata": false,
  "Page": 1,
  "PageSize": 25,
  "Filter": "Status='InProgress'",
  "Version": 1
}

Returns

200 OK - Collection of service requests (with or without metadata)

400 Bad Request - Service requests could not be retrieved

Example - Filtering by place of supply and status

Example - Filtering by place of supply only

Example - Filtering by service request status

ServiceRequestQuery

Name	Type	Description
UserId	Integer	User id associated to service request. Default value is 0.
ServiceId	Integer	Service id associated to service request. Default value is 0.
OrganizationId	Integer	Organization id associated to service request. Default is 0.
Note: You cannot use the UserId, ServiceId and OrganizationId at the same time. Only one, or two of them can be used at the same time.
ExcludeMetadata	Boolean	True to include the service request meta data be included in the result. False to exclude the service request meta data be included in the result.
Page	Integer	The page number. If the value provided is 0 then it will default to 1.
PageSize	Integer	The page size. If the value provided is 0 then it will default to 25.
Filter	String	This is used to filter the results by place of supply and/or status. Note: No filtering will be done if the value is empty Place of supply To filter the place of supply use this filter: "PlaceOfSupply='ON'" Note: The text must be used as provided and is not case sensitive. The province code must be two letters in between single quotes. Possible values: Valid values are in upper case: AB, BC, MB, NB, NL, NS, NT, NU, ON, PE, QC, SK, YT Status To filter the status use this filter: “Status='InProgress'". Note: The text must be used as provided and is not case sensitive. The status must be in between single quotes. Possible values for service request statuses. InProgress Submitted InReview Completed TrainingCompleted InformationRequired Accepted AcceptedWithUpdates Canceled Initiated Expired Rejected Failed PickedUp TestPaymentPending TestPaymentSent Validated Verified Approved OnHold PendingApproval DocumentIssued Draft Assigned Updated ActivityPlanned Closed ActivityCompleted DeclarationSubmitted Place of supply and status Both filters can be used at the same time. Example: "PlaceOfSupply='ON' AND Status='InProgress'"
Version	Number	Filter version number. Value should be set to: 1. This is currently only used for logging purposes.