DSTU2 STU 3 Ballot
This page is part of the FHIR Specification (v1.0.2: DSTU 2). The current version which supercedes this version is

This page is part of the FHIR Specification (v1.6.0: STU 3 Ballot 4). The current version which supercedes this version is 5.0.0 . For a full list of available versions, see the Directory of published versions . For a full list of available versions, see the Directory of published versions . Page versions: . Page versions: R5 R4B R4 R3 R2

6.1.14 2.31.15 Resource List - Operations Resource List - Operations This resource has 1 operation associated with it:

This resource has 1 operation associated with it:

For more information about operations, including how they are invoked, see
$find Find a functional list Find a functional list

For more information about operations, including how they are invoked, see Operations . .

6.1.14.1 2.31.15.1 Find a functional list Find a functional list This operation allows a client to find an identified list for a particular function by its function. The operation takes two parameters, the identity of a patient, and the name of a functional list. The list of defined functional lists can be found at Current Resource Lists . Applications are not required to support all the lists, and may define additional lists of their own. If the system is able to locate a list that serves the identified purpose, it returns it as the body of the response with a 200 OK status. If the resource cannot be located, the server returns a 404 not found (optionally with an OperationOutcome resource)

This operation allows a client to find an identified list for a particular function by its function. The operation takes two parameters, the identity of a patient, and the name of a functional list. The list of defined functional lists can be found at Current Resource Lists . Applications are not required to support all the lists, and may define additional lists of their own. If the system is able to locate a list that serves the identified purpose, it returns it as the body of the response with a 200 OK status. If the resource cannot be located, the server returns a 404 not found (optionally with an OperationOutcome resource)

Formal Definition (as a Formal Definition (as a OperationDefinition ). URL: [base]/List/$find

URL: [base]/List/$find

Note that servers may support searching by a functional list, and not support this operation that allows clients to find the list directly
In Parameters: In Parameters:
Name Cardinality Type Binding Profile Documentation
patient 1..1 id

The id of a patient resource located on the server on which this operation is executed The id of a patient resource located on the server on which this operation is executed

name 1..1 code

The code for the functional list that is being found The code for the functional list that is being found

Note that servers may support searching by a functional list, and not support this operation that allows clients to find the list directly

6.1.14.1.1 2.31.15.1.1 Examples Examples Find the current allergy list for patient 'example' (Request):

Find the current allergy list for patient 'example' (Request): 


GET /ehr/fhir/List/$find?patient=example&name=$current-allergies
Return
the
currnet
allergies
list
for
the
patient
(Response):

Return the currnet allergies list for the patient (Response): 


HTTP/1.1 200 OK
[other headers]

<?xml version="1.0" encoding="UTF-8"?>
<List xmlns="http://hl7.org/fhir">
  <id value="current-allergies"/>
  <text>
    <status value="generated"/>
    <div xmlns="http://www.w3.org/1999/xhtml">
      <p>Patient Peter Chalmers, DOB = Dec 25, 1974, MRN = 12345 (Acme Healthcare) has the following allergies</p>
      <ul>
        <li>cashew nut allergenic extract Injectable Product (<b>High</b>)</li>
        <li>Allergenic extract, penicillin (high)</li>
      </ul>
    </div>
  </text>
  <status value="current"/>
  <mode value="working"/>

  <title value="Current Allergy List"/>
  <code>
    <coding>
      <system value="http://loinc.org"/>
      <code value="52472-8"/>
      <display value="Allergies and Adverse Drug Reactions"/>
    </coding>
    <text value="Current Allergy List"/>
  </code>
  <date value="2015-07-14T23:10:23+11:00"/>

  <source>
    <reference value="Patient/example"/>
  </source>
  <status value="current"/>
  <date value="2015-07-14T23:10:23+11:00"/>

  <orderedBy>
    <coding>
      <system value="http://hl7.org/fhir/list-order"/>
      <code value="entry-date"/>
    </coding>
  </orderedBy>
  <mode value="working"/>

  <entry>
    <item> 
      <reference value="AllergyIntolerance/example"/>
    </item>
  </entry>  
  <entry>
    <item> 
      <reference value="AllergyIntolerance/medication"/>
    </item>
  </entry>  
</List>
 
©
HL7.org
2011+.
FHIR
DSTU2
(v1.0.2-7202)
generated
on
Sat,
Oct
24,
2015
07:43+1100.
Links:
Search
|
Version
History
|
Table
of
Contents
|
Compare
to
DSTU1