Uploaded image for project: 'FHIR Specification Feedback'
  1. FHIR Specification Feedback
  2. FHIR-33158

Clarify "composite" vs "AND" and "OR" search parameters

    XMLWordPrintableJSON

Details

    • Icon: Change Request Change Request
    • Resolution: Persuasive
    • Icon: Medium Medium
    • FHIR Core (FHIR)
    • R4
    • FHIR Infrastructure
    • Search
    • Rick Geimer / Gino Canessa: 13-0-2
    • Clarification
    • Non-substantive
    • R5

    Description

      http://build.fhir.org/search.html#combining describes three ways of "combining" search parameters, which I'd summarize as:

      • "AND search parameter" – e.g., Patient?language=FR&language=NL for French/Dutch bilingual patients
      • "OR search parameter" – e.g., Patient?language=FR,NL for patients who speak at least one of French or Dutch
      • "Composite search parameter" – e.g., Group?characteristic-value=gender$mixed for Groups with a single characteristic that means "gender: mixed" (rather than, say, one characteristic meaning "gender: male" and another meaning "preferred Chex cereal format: mixed", which you might inadvertently match with a non-composite query like{{Group?characteristic=gender&value=mixed}}).

       

      ... but these definitions are all grouped under a heading called "Composite Search Parameters". The element ID ("#combining") is clearer, since "AND" and "OR" parameters are not examples of "composite" search parameters. 

      We should:

      1. Rename this section to "Combining Search Parameters"
      2. Eliminate the introductory sentences "Composite search parameters support joining single values with a $. For example, the result of the search operation is the intersection of the resources that match the criteria specified by each individual search parameter. " which are mis-placed and belong in the bottom paragraph of the section (but they're already effectively communicated by the text present in the bottom paragraph).

      Attachments

        Activity

          People

            ginocanessa Gino Canessa
            jmandel Josh Mandel
            Watchers:
            2 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: