NHSE Design and Development Approach

This guidance is under active development by NHS Digital and content may be added or updated on a regular basis.

Metadata Design

This section describes the approach taken for metadata relating to the resources used within the NHSE IG

File Format

All Resources SHALL be in the XML format and stored within GitHub. Snapshots SHALL NOT be used in any assets. All Profiles and Extensions SHALL be created using Firely Forge. The setting for the snapshot component in Forge, SHALL be deselected from the Options menu.

Properties

Filename format The filename SHALL be human readable with a maximum character limit of 64 digits. The physical filename format to be used for these assets is as below, where [Name] is in PascalCase:

  • Profile: NHSEngland-[Name].xml
  • Extension: Extension-NHSEngland-[Name].xml
  • ValueSet: ValueSet-NHSEngland-[Name].xml
  • CodeSystem: CodeSystem-NHSEngland-[Name].xml
  • ConceptMap: ConceptMap-NHSEngland-[Name].xml

url property The url format to be used for these assets is as below, where [Name] is in PascalCase:

  • Profile: https://fhir.hl7.org.uk/StructureDefinition/NHSEngland-[Name]
  • Extension https://fhir.hl7.org.uk/StructureDefinition/Extension-NHSEngland-[Name]
  • ValueSets: https://fhir.hl7.org.uk/ValueSet/NHSEngland-[Name]
  • CodeSystems: https://fhir.hl7.org.uk/CodeSystem/NHSEngland-[Name]
  • ConceptMaps: https://fhir.hl7.org.uk/ConceptMap/NHSEngland-[Name]

Common properties

  • id: NHSEngland-[Name] - [Name] is in PascalCase
  • name: NHSEngland-[Name] - [Name] is in PascalCase
  • title: NHSEngland-[Name] – [Name] is in Proper Case
  • status: draft – unless stated otherwise

back to top