Guidance on writing Profiles of FHIR

From IHE Wiki
Revision as of 15:38, 11 October 2017 by JohnMoehrke (talk | contribs)
Jump to navigation Jump to search

This is an outline only, details will be added as requested (send email to JohnMoehke@gmail.com)

Current Guidance on writing Profiles of FHIR

  • First priority is supplement form like any other IHE Profile - It is the Normative content
    • Yes this is a PDF publication mechanism, but it is what we have as approved Governance
    • Volume 1 is very close to what is visualized for FHIR Implementation Guide, so it should translate well
    • Volume 2+ should be kept to minimum, but must include ALL normative requirements (SHALL) of the profile
    • wiki Profiles page
      • This is very important for FHIR profiles as it will be the place where links to additional resources
  • Second priority is FHIR conformance resources: -- Informative at this time
    • Published on IHE FTP site in the Implementation Material
      • The FTP site layout
        • Domain
          • "FHIR" directory
            • all conformance resources are in this directory, not a sub-directory
            • StructureDefinition filename: <Profile-acronym>+<Resource-name>+".structuredefinition"+[".json"|".xml"]
            • CapabilityStatement filename: <Profile-acronym>+<actor-name>+".capabilitystatement.xml"+[".json"|".xml"]
            • example: QEDmProvenance.structuredefinition.xml
            • example: PDQmClient.capabilitystatement.xml
      • See ITI for example ftp://ftp.ihe.net/TF_Implementation_Material/ITI/FHIR/
    • wiki Profiles page should have a "FHIR Implementation Guide" section that itemizes
    • StructureDefinition to hold constraints on each FHIR Resource
      • Cardionality constraints
      • vocabulary (valueset) constraints
      • mapping
      • etc???
    • CapabilityStatement to show minimal conformance requirements per Actor
      • Query parameters that must be supported
      • Resources must be supported (or will be used)
      • ???
  • Third priority is examples
    • For any Resource in your profile, there should be an example on the IHE FTP Implementation Materials
    • Any publicly available FHIR reference implementation server that you know supports your profile should also be mentioned in your Profiles wiki page "FHIR Implementation Guide" section

Not forbidden from experimenting beyond

Near Future

The following are some items the IHE-FHIR-wg is close to having a recommendation. These should be considered experimental, but likely to become guidance.

  • Guidance on how to link your conformance resources on HL7 FHIR Registry
  • Use of GIT for publication rather than FTP
  • Use of ClinFHIR as a tool to capture Volume 1 like material

Future

These are also potential items the IHE-FHIR-wg might further develop. These are less likely to become recommended, and an Profile author should be very cautious with these items.

  • Implementation Guide publication is not mature enough to support IHE governance
    • Experience with FHIR ImplementationGuide resource and various tooling shows that it not ready for use
Retrieved from "http://wiki.ihe.net/index.php?title=Guidance_on_writing_Profiles_of_FHIR&oldid=104976"