$match

PDQm $Match

draftPatient Demographics Query for Mobile (PDQm)3.1.0operation3 inputs1 output

This operation implements the [Patient Demographics Match \[ITI-119\]](ITI-119.html) transaction. It is fully compatible with the $match Operation on Patient. The only changes are to constrain the input parameters to use the PDQm Patient Profile for $match Input profile and to constring the output parameters to use the PDQm Patient Profile profile.

Metadata

hl7.org/fhir
Canonical URL
https://profiles.ihe.net/ITI/PDQm/OperationDefinition/PDQmMatch
Code
$match
Kind
operation
Affects State
No
Publisher
IHE IT Infrastructure Technical Committee

Invocation Context

Can be invoked at:
Type Level
Target Resources:
Affects State:No

Input Parameters (3)

NameTypeCard.Description
resource*Patient1..1Use this to provide an entire set of patient details for the MPI to match against (e.g. POST a patient record to Patient/$match).
onlyCertainMatchesboolean0..1If there are multiple potential matches, then the match SHOULD not return the results with this flag set to true. When false, the server MAY return multiple results with each result graded accordingly.
countinteger0..1The 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.

Output Parameters (1)

NameTypeCard.Description
returnBundle1..1A bundle contain a set of Patient records that represent possible matches, optionally it MAY also contain an OperationOutcome with further information about the search results (such as warnings or information messages, such as a count of records that were close but eliminated) If the operation was unsuccessful, then an OperationOutcome MAY be returned along with a BadRequest status Code (e.g. security issue, or insufficient properties in patient fragment - check against profile). Note: as this is the only out parameter, it is a resource, and it has the name 'return', the result of this operation is returned directly as a resource

Additional Information

Version
3.1.0
Date
2024-12-02T14:42:50-06:00
Base Definition
http://hl7.org/fhir/OperationDefinition/Patient-match