Page Comparison

...

Executes query on service requests.

Description

Excecutes Executes a query on service requests by providing a ServiceRequest object which contain parameters to filter out 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

[POST]

/api/servicerequests/query

Code Block

language	json

[API JSON Structure]

Returns

...

Parameters

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.

Code Block

language	json

{
  "UserId": 0,
  "ServiceId": 11,
  "OrganizationId": 0,
  "ExcludeMetadata": false,
  "ExcludeServiceRequests": 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.

Code Block

language	json

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

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

Code Block

language	json

{
  "UserId": 0,
  "ServiceId": 11,
  "OrganizationId": 0,
  "ExcludeMetadata": false,
  "ExcludeServiceRequests": 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 couldn’t be retrieved

Example - Filtering by place of supply and status

...

Code Block

language	c#

//This is an exemple of a query using filtering for the place of supply and status.
//This will filter all service requests for service id 11.
const ServiceRequestStatus status = ServiceRequestStatus.InProgress;
var query = new ServiceRequestQuery
{
    ServiceId = ServiceId,
    Page = 1,
    PageSize = 25,
    Version = 1.0F,
    Filter = $"Status='{status}'"
};
            
// Get all service requests with metadata using the place of supply and status filter.
var requestWithMetadata = await serviceRequestManager.ExecuteQuery<ServiceRequestMetadata>(query, false);

// Get all service requests without metadata using the place of supply and status filter.
var requestsNoMetadata = await serviceRequestManager.ExecuteQuery<NoMetadata>(query, true);

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.
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.
ExcludeServiceRequests	Boolean	True to include service requests in the result. False to exclude service requests in the result. This is currently not used in the code.
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. 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. Place of supply and status Both filters can be used at the same time. Example: "PlaceOfSupply='ON' AND Status='InProgress'" List of 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 Valid values are in upper case: AB, BC, MB, NB, NL, NS, NT, NU, ON, PE, QC, SK, YT
Version	Number	Filter version number. This is currently not used in the code.

Versions Compared

Old Version 1

New Version 2

Key

Description

Package Details

Interface

Returns

API

Returns

Parameters

Returns

Example - Filtering by place of supply and status

ServiceRequestQuery