MDM Query Links

MDM Query links: The HDR FHIR server uses $mdm-query-links operation to view MDM links.

For example: GET http://localhost:7001/oracle-fhir-server/fhir/$mdm-query-links?_offset=0&_count=2

Or, if you are making a POST request:

POST http://localhost:7001/oracle-fhir-server/fhir/$mdm-query-links

{
  "resourceType": "Parameters",
  "parameter": [ {
    "name": "_offset",
    "valueInteger": 0
  }, {
    "name": "_count",
    "valueInteger": 2
  } ]
}

The returning response contains the MDM links.

Response:

{
  "resourceType" : "Parameters",
  "parameter" : [ {
    "name" : "self",
    "valueUri" : "http://localhost:7001/oracle-fhir-server/fhir/$mdm-query-links?_offset=0&_count=2"
  }, {
    "name" : "link",
    "part" : [ {
      "name" : "goldenResourceId",
      "valueString" : "Patient/50006"
    }, {
      "name" : "sourceResourceId",
      "valueString" : "Patient/50005"
    }, {
      "name" : "matchResult",
      "valueString" : "MATCH"
    }, {
      "name" : "linkSource",
      "valueString" : "AUTO"
    }, {
      "name" : "eidMatch",
      "valueBoolean" : false
    }, {
      "name" : "hadToCreateNewResource",
      "valueBoolean" : true
    }, {
      "name" : "score",
      "valueDecimal" : 1
    }, {
      "name" : "linkCreated",
      "valueDecimal" : 1738081583871
    }, {
      "name" : "linkUpdated",
      "valueDecimal" : 1738081583871
    } ]
  } ]
}

The MDM query links operation supports the following query parameters.

Table 12-1 MDM Query Parameters

Name	Type	Description
goldenResourceId	String	ID of the Golden Resource (e.g. Golden Patient Resource).
resourceId	String	ID of the source resource (e.g. Patient resource).
matchResult	String	MATCH, POSSIBLE_MATCH or NO_MATCH.
linkSource	String	AUTO, MANUAL
_offset	int	Offset to begin returning records at.
_count	int	Number of links to be returned in a page
_sort	String	Sort specification
resourceType	String	Resource type (e.g. Patient)

Note:

Sort is specified by adding one or more comma-separated MdmLink property names prefixed by '-' to indicate descending order. For example: http://localhost:7001/oracle-fhir-server/fhir/$mdm-query-links?_sort=myScore,myCreated

Example on matchResult parameter

An HTTP GET like http://localhost:7001/oracle-fhir-server/fhir/$mdm-query-links?matchResult=MATCH or an HTTP POST to the following URL to invoke this operation:

Request Body for POST

{
  "resourceType": "Parameters",
  "parameter": [ {
    "name": "matchResult",
    "valueString": "MATCH"
  } ]
}

This operation returns a Parameters resource that looks like the following:

{
  "resourceType" : "Parameters",
  "parameter" : [ {
    "name" : "self",
    "valueUri" : "http://localhost:7001/oracle-fhir-server/fhir/$mdm-query-links?_offset=0&_count=20"
  }, {
    "name" : "link",
    "part" : [ {
      "name" : "goldenResourceId",
      "valueString" : "Patient/50006"
    }, {
      "name" : "sourceResourceId",
      "valueString" : "Patient/50005"
    }, {
      "name" : "matchResult",
      "valueString" : "MATCH"
    }, {
      "name" : "linkSource",
      "valueString" : "AUTO"
    }, {
      "name" : "eidMatch",
      "valueBoolean" : false
    }, {
      "name" : "hadToCreateNewResource",
      "valueBoolean" : true
    }, {
      "name" : "score",
      "valueDecimal" : 1
    }, {
      "name" : "linkCreated",
      "valueDecimal" : 1738081583871
    }, {
      "name" : "linkUpdated",
      "valueDecimal" : 1738081583871
    } ]
  } ]
}