fhir search for clients (mirjam)
TRANSCRIPT
© 2014 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
FHIR Searchfor client developers
Mirjam BaltusFHIR Developer DaysNovember 19, 2015
© 2014 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
2
Who am I?
Name: Mirjam Baltus-Bakker Company: Furore, Amsterdam Background:
ICT trainer Furore FHIR team
Contact: [email protected]
© 2014 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Searching FHIR
Basic search
Search parameters
Parameter types
More complex searches
© 2014 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
4
Basic search
SyntaxGET [base]/[resourcetype]?name=value&...
Getting all patientsGET http://acme.org/fhir/Patient
Special case of the “real” search operation:GET http://acme.org/fhir/Patient?name=eve
© 2014 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Search result
Bundle with type “searchset”
Always returns a paged result
Use _count for number of results per page Check the response to see what parameters
were actually used
© 2014 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
6
Search parametersEach resource has a set of “standard” search parameters,so not every element can be searched!:
Our last search used this one
© 2014 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
7
Parameter types
For each type there are specific prefixesand modifiersnumber, date and quantity:Search for [param]=gt[value] retrieves resources where [param] has a value greater than [value]
http://acme.org/fhir/Patient?gender:missing=true
© 2014 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
8
Parameter summary table
© 2014 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
9
Search result parameters
Including other resources
GET [base]/DiagnosticReport?_include=DiagnosticReport:subject:Patient
GET [base]/Patient?_revinclude=Observation:subject
Source resource type
Parameter of type reference
Type of target resource (optional)
© 2014 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
10
Combining parameters
Specifying multiple parameters finds resources matching all params “AND”
GET [base]/Patient?language=fr&language=nlGET [base]/Patient?language=fr&gender=male
Parameters may list multiple values “OR”
GET [base]/Patient?language=fr,nl
© 2014 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
11
Chained searches
How do I find Observations for a patient, searching using his name?
GET [base]/Observation?subject.name=jim
Note: this still only works on the predefined search parameters. You cannot just use any property of the resource.
© 2014 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
WHAT’S NEXT?
© 2014 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
Next Steps for you
Look at the search page of the spechttp://www.hl7.org/fhir/search.html
Come to the Hackathon and try it out!
FHIR Search for server developers session after this
StackOverflow: hl7 fhir tag FHIR DOTNET or HAPI FHIR group on Google Groups
© 2014 HL7 ® International. Licensed under Creative Commons. HL7 & Health Level Seven are registered trademarks of Health Level Seven International. Reg. U.S. TM Office.
The End – Questions?