1. How they were created?
The search parameters have been created by amalgamating the thinking behind search parameter definitions from public facing projects who have spent time looking, investigating and implementing API search parameters:
- NHS Digital - GP Connect
- US Argonaut Data Query Implementation Guide
- NHS Scotland Clinical Portal (API) and SCI Store
The search parameters were created as a starting point for discussion as such a process to improve the search parameters and make them applicable and complete.
2. MAY Parameters
The parameters have been selected on usage frequency. Frequently used parameters have been given SHALL conformance requirement and slightly less common parameters a SHOULD requirement. A number of search parameters fell outside of this criteria were identified as being useful in in the U.K., these are listed in the 2.2 Search
section with a MAY conformance requirement.
identifier
is anticipated, identifier
is listed in the search parameters section of these resources with a MAY conformance requirement. It is believed this MAY conformance is not enough in a U.K. setting and this should be increased to SHALL or SHOULD. MAY parameters are no different to other optional standard FHIR search parameters. If feedback indicates they should remain optional (MAY), they will be treated as such and the references removed from the 2.2 Search
section of the resources.
Feedback is requested from suppliers and consumers to confirm the conformance level for all parameters in the section 2.2 Search
for all resources.
3. Improvement process
An improvement process needs to be developed to improve the search parameters and validate the ones already suggested. Please contact the careconnect team if you have any suggestions.