{ "description": "This operation is a adaptation of the FHIR R4 Patient match operation, for use with the Practitioner and PractitionerRole resources. The operation takes a Parameters instance containing a single candidate Practitioner (and optionally PractitionerRole) resource populated with the characteristics of the practitioner being searched for. The data provided is interpreted as an MPI input and passed to an MPI algorithm of some kind that uses them to determine the most appropriate matches in the practitioner set. These matches may not result in an exact match of all specified criteria. Allowances are made for variations in spelling as well as potential data entry errors. The complete set of specified criteria are evaluated as a whole to deterimine the likelihood of each candidate practitioner being a match. The operation can only be invoked by POST with the Parameters resource (with inline Practitioner resource and optionally PractitionerRole resource instance) sent as the HTTP body.", "_filename": "ppr-Practitioner-match.json", "package_name": "ca.on.phsd.r4-alpha", "date": "2021-07-09T01:45:48+00:00", "system": false, "publisher": "Ontario Health", "instance": false, "name": "EMPIPractitionerMatch", "type": "true", "experimental": null, "resourceType": "OperationDefinition", "title": null, "package_version": "0.1.3", "status": "draft", "id": "b18ab316-fceb-4dae-8b70-37f088f87ad9", "kind": "operation", "comment": "The response from an \"mpi\" query is a bundle containing Practitioner and PractitionerRole records, ordered from most likely to least likely. If there are no practitioner matches, the MPI SHALL return an empty search set with no error, but may include an operation outcome with further advice regarding practitioner selection. All practitioner records SHALL have a search score from 0 to 1, where 1 is the most certain match that indicates the MPI's position on the match quality.", "url": "https://ehealthontario.ca/fhir/OperationDefinition/ppr-Practitioner-match", "code": "match", "version": null, "contact": [ { "telecom": [ { "value": "http://ontariohealth.ca", "system": "url" } ] } ], "parameter": [ { "max": "1", "min": 1, "use": "in", "name": "Practitioner", "type": "canonical", "documentation": "Use this to provide an entire set of Practitioner details for the MPI to match against (e.g. POST a parameters instance containing the practitioner record to Practitioner/$match).", "targetProfile": [ "http://ehealthontario.ca/fhir/StructureDefinition/ca-on-ppr-practitioner-matchreq-profile-Practitioner|1.0.0" ] }, { "max": "1", "min": 0, "use": "in", "name": "count", "type": "integer", "documentation": "The maximum number of records to return. If no value is provided, the server decides how many matches to return. Note that clients should be careful when using this, as it may prevent probable - and valid - matches from being returned" }, { "max": "1", "min": 0, "use": "in", "name": "PractitionerRole", "type": "canonical", "documentation": "Use this to provide an additional PractitionerRole details for the MPI to match against (e.g. include a PractitionerRole resource in the parameter instance posted to to Practitioner/$match).", "targetProfile": [ "http://ehealthontario.ca/fhir/StructureDefinition/ca-on-ppr-practitioner-matchreq-profile-PractitionerRole|1.0.0" ] }, { "max": "1", "min": 1, "use": "out", "name": "return", "type": "canonical", "documentation": "A bundle contain a set of Practitioner and PractitionerRole records that represent possible matches", "targetProfile": [ "http://ehealthontario.ca/fhir/StructureDefinition/ca-on-ppr-practitioner-response-profile-Bundle|1.0.0" ] } ] }