Starta nytt IG-projekt

Det första som behöver göras när ett nytt IG-projekt startas är att definiera ett namn som beskriver vad IGn syftar till. Rekommendationen är att uttrycka namnet i form av Tillämpningsområde.

Namnet ska svara på engelska. Undantag görs för etablerade svenska termer där en engelsk motsvarighet saknas. Åäö ersätts då med aao. Namn skrivs med PascalCase (samma som UpperCamelCase).

Det är viktigt att ha ett genomtänkt och hållbart namn från start då namnet kommer att bli del av "tekniska" identitieter på de olika artefakter som IG:n består av.

Teams

Lägg till aktuella kollegor till Teams-teamet Kompetensgrupp FHIR och skapa en ny kanal för det aktuella projektet. Material i projektet samlas i filer under den aktuella kanalen, tex kartläggning av upstream work. Vid behov kan en en OneNote kopplas till kanalen.

AzureDevops

De delar av arbetet som drivs primärt av Kompetensgrupp FHIR hanteras på kompetensgruppens Azure tavla. Vid behov kan en ny yta öppnas för projekt som inte redan har en egen tavla.

Verktyg

Kollegor som ska jobba med FHIR behöver installera verktyg lokalt enligt instruktion på VGRs gitlab (obs länk endast åtkomlig med VGR-ID). Access till gitlab ingår i VGR-ID.

Gitlab repo

Ett IG-projekt behöver en arbetsyta i Gitlab där projektrepon, CI/CD pipelines, konfigurationer och Kubernetes-manifest tas fram och livcykelhanteras. För att underlätta och standardisera konfiguration, katalogstruktur, namnsättning mm har ett skript tagits fram. Kompetensgrupp FHIR bistår med att köra detta.

Subgroup

Skriptet erbjuder möjlighet att skapa antingen IG som blivande specifikation eller IG för utforskande och lärande; Sandbox.
Specification: IG subgroup skapas under Under /fhir/profiler/Tillämpningsprofiler
Sandbox: IG subgroup skapas under Under /fhir/profiler/Sandbox

Som namn anges , vilket resulterar i \ Subgroup name: __VGR__ \ IG Project name: __VGR--IG__ \ IG Project repo slug: __vgr--ig__ (samma som project name men enbart gemener)

Exempel name=TransfusionMedicine:
VGRTransfusionMedicine
├── VGR-TransfusionMedicine-IG
└── VGR-TransfusionMedicine-IG-GitOps

Repo för FSH/SUSHI-projektet

I subgroup skapas ett nytt FSH/SUSHI IG-projekt. Detta namnges enligt VGR--IG Exempel: VGR-TransfusionMedicine-IG

Skapa mappar under /input/fsh

Skriptet skapar mappar enligt beskrivning under Profilering med FHIR Shorthand.

Skapa sushi-filer

Skriptet skapar konfigurationsfiler för projektet och för publiceringsunderlag genom att applicera namnet (tillämpningsområdet) på fördefineirade mallar.

Följade platshållare i mallen tilldelas värden @@IG_NAME@@ = VGRIG @@IG_PACKAGE_ID_LEAF@ = som enbart gemener @@IG_PROJECTNAME@@ = @@IG_TITLE@@ = VGR IG

sushi-config.yaml

id: se.vgregion.fhir.@@IG_PACKAGE_ID_LEAF@@
canonical: https://fhir.vgregion.se/ig/@@IG_PACKAGE_ID_LEAF@@
name: @@IG_NAME@@
title: @@IG_TITLE@@
#description: Example Implementation Guide for getting started with SUSHI
status: draft # draft | active | retired | unknown
version: 0.1.0-SNAPSHOT
fhirVersion: 4.0.1 # https://www.hl7.org/fhir/valueset-FHIR-version.html
copyrightYear: 2026+
releaseLabel: ci-build
license: CC0-1.0 # https://www.hl7.org/fhir/valueset-spdx-license.html
jurisdiction: urn:iso:std:iso:3166#SE "Sweden" # https://www.hl7.org/fhir/valueset-jurisdiction.html
publisher:
  name: Västra Götalandsregionen
  url: https://fhir.vgregion.se
  email: kompetensgrupp.fhir@vgregion.se

publication-request.json

{
  "package-id" : "se.vgregion.fhir.@@IG_PACKAGE_ID_LEAF@@",
  "version" : "0.1.0",
  "path" : "https://fhir.vgregion.se/ig/@@IG_PACKAGE_ID_LEAF@@/0.1.0",
  "mode" : "working",
  "status" : "preview",
  "sequence" : "Releases",
  "descmd" : "First draft publication of VGR @@IG_PROJECTNAME@@ IG",
  "first" : true,
  "title" : "VGR @@IG_PROJECTNAME@@ Implementation Guide",
  "ci-build" : "https://fhir-dev.vgregion.se/ig/@@IG_PACKAGE_ID_LEAF@@/",
  "registry-description" : "Region Västra Götaland's @@IG_PROJECTNAME@@ Implementation Guide",
  "registry-country" : "SE",
  "registry-authority" : "Region Västra Götaland",
  "category" : "Regional Base",
  "introduction" : "Västra Götalandsregionens @@IG_PROJECTNAME@@ Implementation Guide."
}

Namngivning av Implementationsguider

Name
Namn på artefakten för implementationsguiden.
Skrivs enligt mall VGR<Tillämpningsområde>IG
Exempel: VGRTransfusionMedicineIG

Title
Titeln på implementationsguiden.
Skrivs enligt mall VGR <Tillämpningsområde> ImplementationGuide
Exempel: VGR TransfusionMedicine ImplementationGuide

Notera att basprofilerna har en annan namngivningsstandard.

Avslutande av projekt

Ett genomfört projekt bör ha landat i en publicerad IG som ligger på VGR:s gitlab. Kanalen stängs och dess filer försvinner.