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

Remove resource type prefix from all SearchParameter.code

    XMLWordPrintableJSON

Details

    • Icon: Change Request Change Request
    • Resolution: Persuasive
    • Icon: Medium Medium
    • National Directory of Healthcare Providers and Services (NDH) (FHIR)
    • 1.0.0-ballot
    • Patient Administration
    • STU
    • (many)
    • Hide

      Take the prefix out from the code. 

      Show
      Take the prefix out from the code. 
    • Bob Dieterle / David Pike : 6-0-0
    • Correction
    • Non-compatible

    Description

      The SearchParameters in this guide prefix many of the search parameter codes -SearchParameter.code  (the parameter used in the url) with the name of the resource it is used for. (e.g. healthcareservice-network). While these prefixes may be necessary to distinguish SearchParameter names/urls (e.g. Healthcareservice-network vs practitionerRole-network), they are not necessary for the as the parameter code used by implementations during search. The context of use is already defined by the fact that the query is being run on a resource type indicated in the URL.  The IGs I have worked with do not have this code prefixing pattern. There does not seem to be a specific purpose for doing this and it could represent additional work for implementers.

       

      Additionally, it does not see link all the parameters do this, but there are sometimes errors in the examples.

      For example, on this page:

      http://hl7.org/fhir/us/ndh/2023Sep/StructureDefinition-ndh-HealthcareService.html#search-parameters

      There is an example for healthcareservice-eligibility

      healthcareservice-eligibility token GET [base]/HealthcareService?healthcareservice-eligibility=2403008

      However, the SearchParameter (http://hl7.org/fhir/us/ndh/2023Sep/SearchParameter-healthcareservice-eligibility.json.html) defines the code as “eligibility”.

       

       

      The Search Parameters should have all the resource type prefixes removed and the examples updated appropriately.

      Attachments

        Activity

          People

            Unassigned Unassigned
            corey_spears Corey Spears
            Corey Spears
            Watchers:
            2 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: