The existence of a CodeSystem resource on a server should only be interpreted as a declaration of the code system properties, not as a declaration of server support and expected behavior

XMLWordPrintableJSON

    • Type: Change Request
    • Resolution: Persuasive
    • Priority: Medium
    • FHIR Core (FHIR)
    • STU3
    • Terminology Infrastructure
    • CodeSystem
    • REST (http)
      Terminology Service
    • Hide

      The server behavior capabilities will be documented in the TerminologyCapabilities resource rather than in the CodeSystem resource. The CodeSystem resource documents what the code system is capable of regardless of the specific server instance capabilities. Will document this in the CodeSystem resource and the other appropriate places in the spec. A separate tracker item will be submitted for specifying the means of accessing the server terminology capabilities statement.

      Show
      The server behavior capabilities will be documented in the TerminologyCapabilities resource rather than in the CodeSystem resource. The CodeSystem resource documents what the code system is capable of regardless of the specific server instance capabilities. Will document this in the CodeSystem resource and the other appropriate places in the spec. A separate tracker item will be submitted for specifying the means of accessing the server terminology capabilities statement.
    • Rob Hausam/Carol Macumber: 15-0-1
    • Enhancement
    • Compatible, substantive
    • STU3

      The existence of a CodeSystem resource on a server declares the properties of the code system itself, as documented in the resource sections on Scope and Usage, Boundaries and Relationships and Background and Context. There is no mention in those sections regarding any expectation of whether the presence of a CodeSystem resource on a server also implies that the server has actually implemented and supports that particular code system and therefore is expected to behave accordingly in regard to the performance of any terminology service operations.

      Discussion has occurred suggesting that querying the CodeSystem resource endpoint may be a useful means of determining which code systems are supported by a FHIR terminology service, but based on RESTful API principles, no such expectation should be presumed or implied. Instead, any expectations of server support and behavior in regard to a particular code system should be returned either in a server capability statement or preferably in a terminology service capability statement from a capabilities interaction. The terminology service capabilities interaction would be similar to GET [base]/metadata for the server capability statement (but with the specific interaction method presumably yet to be defined?).

            Assignee:
            Unassigned
            Reporter:
            Robert Hausam
            Watchers:
            1 Start watching this issue

              Created:
              Updated:
              Resolved: