MedNet interface implementation guide
0.15.0 - CI Build

MedNet interface implementation guide - Local Development build (v0.15.0). See the Directory of published versions

Data Type Profile: MedNet Interface (MNI) - Human Name

Official URL: https://mednet.swiss/fhir/StructureDefinition/mni-humanName Version: 0.15.0
Active as of 2022-06-13 Computable Name: MNIHumanName

Copyright/Legal: novcom AG

MedNet Interface (MNI) - Human Name Profile

Usage:

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

This structure is derived from CHCoreHumanName

Summary

Must-Support: 6 elements

This structure is derived from CHCoreHumanName

NameFlagsCard.TypeDescription & Constraintsdoco
.. HumanName 0..*CHCoreHumanNameName of a human - parts and usage
... use S0..1codeusual | official | temp | nickname | anonymous | old | maiden
... text S0..1stringIn case the name could not be divided in firstname, lastname, this field could be used to contain a non structured name value
... family S0..1stringFamily name (often called 'Surname')
... prefix S0..*stringFor a salutation use a prefix without the iso21090-EN-qualifier extension. For academical titles and legal status use the http://hl7.org/fhir/ExtensionDefinition/iso21090-EN-qualifier with the codes AC, LS.
... suffix S0..*stringParts that come after the name

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. HumanName I0..*CHCoreHumanNameName of a human - parts and usage
... id 0..1stringUnique id for inter-element referencing
... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
... use ?!SΣ0..1codeusual | official | temp | nickname | anonymous | old | maiden
Binding: NameUse (required): The use of a human name.

... family SΣ0..1stringFamily name (often called 'Surname')
.... id 0..1stringxml:id (or equivalent in JSON)
.... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... ch-ext-ech-11-name 0..1codeExtension
URL: http://fhir.ch/ig/ch-core/StructureDefinition/ch-ext-ech-11-name
Binding: eCH-011 NameDataTypes (required): A set of codes advising a system or user which name in a set of names to select for a given purpose.


.... value 0..1stringPrimitive value for string
Max Length: 1048576
... given SΣ0..*stringGiven names (not always 'first'). Includes middle names
This repeating element order: Given Names appear in the correct order for presenting the name
.... id 0..1stringxml:id (or equivalent in JSON)
.... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... ch-ext-ech-11-firstname 0..1codeExtension
URL: http://fhir.ch/ig/ch-core/StructureDefinition/ch-ext-ech-11-firstname
Binding: eCH-011 FirstNameDataTypes (required): A set of codes advising a system or user which name in a set of names to select for a given purpose.


.... value 0..1stringPrimitive value for string
Max Length: 1048576
... prefix SΣ0..*stringFor a salutation use a prefix without the iso21090-EN-qualifier extension. For academical titles and legal status use the http://hl7.org/fhir/ExtensionDefinition/iso21090-EN-qualifier with the codes AC, LS.
This repeating element order: Prefixes appear in the correct order for presenting the name
.... id 0..1stringxml:id (or equivalent in JSON)
.... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... iso21090-EN-qualifier 0..*codeFor academical titles and legal status use the http://hl7.org/fhir/ExtensionDefinition/iso21090-EN-qualifier with the codes AC, LS.
URL: http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier
Binding: EntityNamePartQualifier (required): A set of codes each of which specifies a certain subcategory of the name part in addition to the main name part type.


.... value 0..1stringPrimitive value for string
Max Length: 1048576
... suffix SΣ0..*stringParts that come after the name
This repeating element order: Suffixes appear in the correct order for presenting the name
... period Σ0..1PeriodTime period when name was/is in use

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. HumanName I0..*CHCoreHumanNameName of a human - parts and usage
... use ?!Σ0..1codeusual | official | temp | nickname | anonymous | old | maiden
Binding: NameUse (required): The use of a human name.

... text Σ0..1stringIn case the name could not be divided in firstname, lastname, this field could be used to contain a non structured name value
... family Σ0..1stringFamily name (often called 'Surname')
... prefix Σ0..*stringFor a salutation use a prefix without the iso21090-EN-qualifier extension. For academical titles and legal status use the http://hl7.org/fhir/ExtensionDefinition/iso21090-EN-qualifier with the codes AC, LS.
This repeating element order: Prefixes appear in the correct order for presenting the name
... suffix Σ0..*stringParts that come after the name
This repeating element order: Suffixes appear in the correct order for presenting the name

doco Documentation for this format

This structure is derived from CHCoreHumanName

Summary

Must-Support: 6 elements

Differential View

This structure is derived from CHCoreHumanName

NameFlagsCard.TypeDescription & Constraintsdoco
.. HumanName 0..*CHCoreHumanNameName of a human - parts and usage
... use S0..1codeusual | official | temp | nickname | anonymous | old | maiden
... text S0..1stringIn case the name could not be divided in firstname, lastname, this field could be used to contain a non structured name value
... family S0..1stringFamily name (often called 'Surname')
... prefix S0..*stringFor a salutation use a prefix without the iso21090-EN-qualifier extension. For academical titles and legal status use the http://hl7.org/fhir/ExtensionDefinition/iso21090-EN-qualifier with the codes AC, LS.
... suffix S0..*stringParts that come after the name

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. HumanName I0..*CHCoreHumanNameName of a human - parts and usage
... id 0..1stringUnique id for inter-element referencing
... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
... use ?!SΣ0..1codeusual | official | temp | nickname | anonymous | old | maiden
Binding: NameUse (required): The use of a human name.

... family SΣ0..1stringFamily name (often called 'Surname')
.... id 0..1stringxml:id (or equivalent in JSON)
.... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... ch-ext-ech-11-name 0..1codeExtension
URL: http://fhir.ch/ig/ch-core/StructureDefinition/ch-ext-ech-11-name
Binding: eCH-011 NameDataTypes (required): A set of codes advising a system or user which name in a set of names to select for a given purpose.


.... value 0..1stringPrimitive value for string
Max Length: 1048576
... given SΣ0..*stringGiven names (not always 'first'). Includes middle names
This repeating element order: Given Names appear in the correct order for presenting the name
.... id 0..1stringxml:id (or equivalent in JSON)
.... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... ch-ext-ech-11-firstname 0..1codeExtension
URL: http://fhir.ch/ig/ch-core/StructureDefinition/ch-ext-ech-11-firstname
Binding: eCH-011 FirstNameDataTypes (required): A set of codes advising a system or user which name in a set of names to select for a given purpose.


.... value 0..1stringPrimitive value for string
Max Length: 1048576
... prefix SΣ0..*stringFor a salutation use a prefix without the iso21090-EN-qualifier extension. For academical titles and legal status use the http://hl7.org/fhir/ExtensionDefinition/iso21090-EN-qualifier with the codes AC, LS.
This repeating element order: Prefixes appear in the correct order for presenting the name
.... id 0..1stringxml:id (or equivalent in JSON)
.... Slices for extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... iso21090-EN-qualifier 0..*codeFor academical titles and legal status use the http://hl7.org/fhir/ExtensionDefinition/iso21090-EN-qualifier with the codes AC, LS.
URL: http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier
Binding: EntityNamePartQualifier (required): A set of codes each of which specifies a certain subcategory of the name part in addition to the main name part type.


.... value 0..1stringPrimitive value for string
Max Length: 1048576
... suffix SΣ0..*stringParts that come after the name
This repeating element order: Suffixes appear in the correct order for presenting the name
... period Σ0..1PeriodTime period when name was/is in use

doco Documentation for this format

 

Other representations of profile: CSV, Excel, Schematron

Terminology Bindings

PathConformanceValueSet
HumanName.userequiredNameUse

Constraints

IdGradePathDetailsRequirements
ele-1errorHumanNameAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ch-core-hm-1errorHumanNameif officalName with eCH-011 Extension is specified, it can only be put on a name where use attribute is official
: family.extension.where(url='http://fhir.ch/ig/ch-core/StructureDefinition/ch-ext-ech-11-name' and valueCode='officialName').empty() or (family.extension.where(url='http://fhir.ch/ig/ch-core/StructureDefinition/ch-ext-ech-11-name' and valueCode='officialName').exists() and use='official')
ch-core-hm-2errorHumanNameif orginalName with eCH-011 Extension is specified, it can only be put on a name where use attribute is maiden
: family.extension.where(url='http://fhir.ch/ig/ch-core/StructureDefinition/ch-ext-ech-11-name' and valueCode='originalName').empty() or ((family.extension.where(url='http://fhir.ch/ig/ch-core/StructureDefinition/ch-ext-ech-11-name' and valueCode='originalName').exists() and use='maiden'))
ch-core-hm-3errorHumanNamech-ext-ech-11-name can only be put on a family name
: descendants().extension.where(url='http://fhir.ch/ig/ch-core/StructureDefinition/ch-ext-ech-11-name').count()=family.extension.where(url='http://fhir.ch/ig/ch-core/StructureDefinition/ch-ext-ech-11-name').count()
ch-core-hm-4errorHumanNamech-ext-ech-11-firstname can only be put on a given name
: descendants().extension.where(url='http://fhir.ch/ig/ch-core/StructureDefinition/ch-ext-ech-11-firstname').count()=given.extension.where(url='http://fhir.ch/ig/ch-core/StructureDefinition/ch-ext-ech-11-firstname').count()
ele-1errorHumanName.extensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1errorHumanName.extensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1errorHumanName.useAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1errorHumanName.textAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1errorHumanName.familyAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1errorHumanName.family.extensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1errorHumanName.family.extensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1errorHumanName.family.extension:ech11nameAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1errorHumanName.family.extension:ech11nameMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1errorHumanName.givenAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1errorHumanName.given.extensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1errorHumanName.given.extensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1errorHumanName.given.extension:ech11firstnameAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1errorHumanName.given.extension:ech11firstnameMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1errorHumanName.prefixAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1errorHumanName.prefix.extensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1errorHumanName.prefix.extensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1errorHumanName.prefix.extension:salutationandtitleAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1errorHumanName.prefix.extension:salutationandtitleMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1errorHumanName.suffixAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1errorHumanName.periodAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())