CH IG (R4), published by HL7 Switzerland. This guide is not an authorized publication; it is the continuous build for version 1.2.3 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/ahdis/ch-ig/ and changes regularly. See the Directory of published versions

Guidance

✂️ Best practice: Keep a Guidance page but replace this informative content with your own IG-specific guidance ✂️

For IG authors, the Guidance for FHIR IG Creation provides comprehensive best practices for implementation guide development.

Guidelines HL7 Switzerland

• Guidelines for Swiss IG Development
• HL7.ch FHIR IG Balloting
• HL7 Switzerland IG template for IG Publisher: propose a change-link, logos, css adjustments

Multi-Language Support

• Producing Multi-Language IGs
• Zulip Channel Multi-lingual IGs
• https://github.com/FHIR/multi-lang-test-ig/

Styles for Narrative

There are defined styles:

• stu-note (see the Home page)
• dragon (see below)
• etc

Instance Fragments

You can embed instance fragments within a page:

{
  "resourceType" : "Practitioner",
  "id" : "HansMuster",
  "meta" : {
    "profile" : [
      🔗 "http://fhir.ch/ig/ch-ig/StructureDefinition/ch-ig-practitioner"
    ]
  },
  "text" : {
    "status" : "generated",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: Practitioner HansMuster</b></p><a name=\"HansMuster\"> </a><a name=\"hcHansMuster\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profile: <a href=\"StructureDefinition-ch-ig-practitioner.html\">CH IG Practitioner</a></p></div><p><b>name</b>: Hans Muster </p></div>"
  },
  "name" : [
    {
      "family" : "Muster",
      "given" : [
        "Hans"
      ]
    }
  ]
}

Creating Diagrams

• Class Diagrams
• Mermaid
• PlantUml (see example from CH Core below)

Cross-Versioning

See details about extensions for converting between versions (see also FHIR Cross-Version Mapping Pack).

CH IG example using a backport extension: Cross-Version Encounter R4:

<Encounter xmlns="http://hl7.org/fhir">
  <id value="xver-encounter-r4"/>
  ...
  <extension
             url="http://hl7.org/fhir/5.0/StructureDefinition/extension-Encounter.subjectStatus">
    <valueCodeableConcept>
      <coding>
        <system
                value="http://terminology.hl7.org/CodeSystem/research-subject-state"/>
        <code value="follow-up"/>
        <display value="Follow-up"/>
      </coding>
      <text value="Follow-up"/>
    </valueCodeableConcept>
  </extension>
  ...
</Encounter>

CH IG profile using a backport extension: CH IG Encounter