fr-human-name-document
type: StructureDefinition
node role: treeRoot
resource.id:
  value: fr-human-name-document
resource.language:
  value: en
domain resource.text:
  narrative.status:
    value: extensions
  narrative.div: English Generated Narrative: StructureDefinition fr-human-name-document Name Flags Card. Type Description & Constraints HumanName FRCoreHumanNameProfile(2.1.0) #xD; family 1..1 string Family name (often called 'Surname') #xD; prefix 0..1 string Civilité Binding: JDV_J245_Civilite_CISIS (20230331120000) (required) #xD; suffix 0..* string Titre Binding: JDV_J246_Titre_CISIS (20240126120000) (required) #xD; Documentation for this format
structure definition.url:
  value: https://interop.esante.gouv.fr/ig/fhir/document-core/StructureDefinition/fr-human-name-document
structure definition.version:
  value: 0.1.0
structure definition.name:
  value: FRHumanNameDocument
structure definition.title:
  value: FR Human Name Document
structure definition.status:
  value: draft
structure definition.date:
  value: 2026-08-07T12:54:27+00:00
structure definition.publisher:
  value: Agence du Numérique en Santé (ANS) - 2-10 Rue d'Oradour-sur-Glane, 75015 Paris
structure definition.contact:
  index: -1
  contact detail.name:
    value: Agence du Numérique en Santé (ANS) - 2-10 Rue d'Oradour-sur-Glane, 75015 Paris
  contact detail.telecom:
    index: -1
    contact point.system:
      value: url
    contact point.value:
      value: https://esante.gouv.fr
structure definition.description:
  value: Ce profil correspond au type de données HumanName utilisé dans le document.
structure definition.jurisdiction:
  index: -1
  codeable concept.coding:
    index: -1
    coding.system:
      value: urn:iso:std:iso:3166
    coding.code:
      value: FR
    coding.display:
      value: France (la)
structure definition.fhir version:
  value: 4.0.1
structure definition.mapping:
  index: -1
  structure definition.mapping.identity:
    value: v2
  structure definition.mapping.uri:
    value: http://hl7.org/v2
  structure definition.mapping.name:
    value: HL7 v2 Mapping
structure definition.mapping:
  index: -1
  structure definition.mapping.identity:
    value: rim
  structure definition.mapping.uri:
    value: http://hl7.org/v3
  structure definition.mapping.name:
    value: RIM Mapping
structure definition.mapping:
  index: -1
  structure definition.mapping.identity:
    value: servd
  structure definition.mapping.uri:
    value: http://www.omg.org/spec/ServD/1.0/
  structure definition.mapping.name:
    value: ServD
structure definition.kind:
  value: complex-type
structure definition.abstract:
  value: false
structure definition.type:
  value: HumanName
structure definition.base definition:
  value: https://hl7.fr/ig/fhir/core/StructureDefinition/fr-core-human-name|2.1.0
  link: 2.1
  link: .0
structure definition.derivation:
  value: constraint
structure definition.snapshot:
  element.extension:
    index: -1
    extension.url:
      value: http://hl7.org/fhir/tools/StructureDefinition/snapshot-base-version
    extension.value string:
      value: 2.1.0
  structure definition.snapshot.element:
    index: -1
    element.id:
      value: HumanName
    element definition.path:
      value: HumanName
    element definition.short:
      value: Name of a human - parts and usage
    element definition.definition:
      value: A human's name with the ability to identify parts and usage.
    element definition.comment:
      value: Names may be changed, or repudiated, or people may have different names in different contexts. Names may be divided into parts of different type that have variable significance depending on context, though the division into parts does not always matter. With personal names, the different parts might or might not be imbued with some implicit meaning; various cultures associate different importance with the name parts and the degree to which systems must care about name parts around the world varies widely.
    element definition.min:
      value: 0
    element definition.max:
      value: *
    element definition.base:
      element definition.base.path:
        value: HumanName
      element definition.base.min:
        value: 0
      element definition.base.max:
        value: *
    element definition.condition:
      value: ele-1
      index: -1
    element definition.constraint:
      index: -1
      element definition.constraint.key:
        value: ele-1
      element definition.constraint.severity:
        value: error
      element definition.constraint.human:
        value: All FHIR elements must have a @value or children
      element definition.constraint.expression:
        value: hasValue() or (children().count() > id.count())
      element definition.constraint.xpath:
        value: @value|f:*|h:div
      element definition.constraint.source:
        value: http://hl7.org/fhir/StructureDefinition/Element|4.0.1
        link: 4.0
        link: .1
    element definition.is modifier:
      value: false
    element definition.mapping:
      index: -1
      element definition.mapping.identity:
        value: rim
      element definition.mapping.map:
        value: n/a
    element definition.mapping:
      index: -1
      element definition.mapping.identity:
        value: v2
      element definition.mapping.map:
        value: XPN
    element definition.mapping:
      index: -1
      element definition.mapping.identity:
        value: rim
      element definition.mapping.map:
        value: EN (actually, PN)
    element definition.mapping:
      index: -1
      element definition.mapping.identity:
        value: servd
      element definition.mapping.map:
        value: ProviderName
  structure definition.snapshot.element:
    index: -1
    element.id:
      value: HumanName.id
    element definition.path:
      value: HumanName.id
    element definition.representation:
      value: xmlAttr
      index: -1
    element definition.short:
      value: Unique id for inter-element referencing
    element definition.definition:
      value: Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
    element definition.min:
      value: 0
    element definition.max:
      value: 1
    element definition.base:
      element definition.base.path:
        value: Element.id
      element definition.base.min:
        value: 0
      element definition.base.max:
        value: 1
    element definition.type:
      index: -1
      element.extension:
        index: -1
      element definition.type.code:
        value: http://hl7.org/fhirpath/System.String
    element definition.is modifier:
      value: false
    element definition.is summary:
      value: false
    element definition.mapping:
      index: -1
      element definition.mapping.identity:
        value: rim
      element definition.mapping.map:
        value: n/a
  structure definition.snapshot.element:
    index: -1
    element.id:
      value: HumanName.extension

value: string

value: HumanName.extension

element definition.slicing.discriminator:
  index: -1
  element definition.slicing.discriminator.type:
    value: value
  element definition.slicing.discriminator.path:
    value: url
element definition.slicing.description:
  value: Extensions are always sliced by (at least) url
element definition.slicing.rules:
  value: open

value: Additional content defined by implementations

value: May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

value: There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

value: extensions
index: -1

value: user content
index: -1

value: 0

value: *

element definition.base.path:
  value: Element.extension
element definition.base.min:
  value: 0
element definition.base.max:
  value: *

index: -1
element definition.type.code:
  value: Extension

index: -1
element definition.constraint.key:
  value: ele-1
element definition.constraint.severity:
  value: error
element definition.constraint.human:
  value: All FHIR elements must have a @value or children
element definition.constraint.expression:
  value: hasValue() or (children().count() > id.count())
element definition.constraint.xpath:
  value: @value|f:*|h:div
element definition.constraint.source:
  value: http://hl7.org/fhir/StructureDefinition/Element|4.0.1
  link: 4.0
  link: .1

index: -1
element definition.constraint.key:
  value: ext-1
element definition.constraint.severity:
  value: error
element definition.constraint.human:
  value: Must have either extensions or value[x], not both
element definition.constraint.expression:
  value: extension.exists() != value.exists()
element definition.constraint.xpath:
  value: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")])
element definition.constraint.source:
  value: http://hl7.org/fhir/StructureDefinition/Extension|4.0.1
  link: 4.0
  link: .1

value: false

value: false

index: -1
element definition.mapping.identity:
  value: rim
element definition.mapping.map:
  value: n/a

index: -1
element.id:
  value: HumanName.extension:assemblyOrder
element definition.path:
  value: HumanName.extension
element definition.slice name:
  value: assemblyOrder
element definition.short:
  value: Preferred display order of name parts
element definition.definition:
  value: A code that represents the preferred display order of the components of this human name.
element definition.min:
  value: 0
element definition.max:
  value: 1
element definition.base:
  element definition.base.path:
    value: Element.extension
  element definition.base.min:
    value: 0
  element definition.base.max:
    value: *
element definition.type:
  index: -1
  element definition.type.code:
    value: Extension
  element definition.type.profile:
    value: http://hl7.org/fhir/StructureDefinition/humanname-assembly-order|5.3.0
    index: -1
    link: 5.3
    link: .0
element definition.constraint:
  index: -1
  element definition.constraint.key:
    value: ele-1
  element definition.constraint.severity:
    value: error
  element definition.constraint.human:
    value: All FHIR elements must have a @value or children
  element definition.constraint.expression:
    value: hasValue() or (children().count() > id.count())
  element definition.constraint.xpath:
    value: @value|f:*|h:div
  element definition.constraint.source:
    value: http://hl7.org/fhir/StructureDefinition/Element|4.0.1
    link: 4.0
    link: .1
element definition.constraint:
  index: -1
  element definition.constraint.key:
    value: ext-1
  element definition.constraint.severity:
    value: error
  element definition.constraint.human:
    value: Must have either extensions or value[x], not both
  element definition.constraint.expression:
    value: extension.exists() != value.exists()
  element definition.constraint.xpath:
    value: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")])
  element definition.constraint.source:
    value: http://hl7.org/fhir/StructureDefinition/Extension|4.0.1
    link: 4.0
    link: .1
element definition.is modifier:
  value: false
element definition.is summary:
  value: false

index: -1
element.id:
  value: HumanName.use
element definition.path:
  value: HumanName.use
element definition.short:
  value: usual | official | temp | nickname | anonymous | old | maiden
element definition.definition:
  value: Identifies the purpose for this name.
element definition.comment:
  value: Applications can assume that a name is current unless it explicitly says that it is temporary or old.
element definition.requirements:
  value: Allows the appropriate name for a particular context of use to be selected from among a set of names.
element definition.min:
  value: 0
element definition.max:
  value: 1
element definition.base:
  element definition.base.path:
    value: HumanName.use
  element definition.base.min:
    value: 0
  element definition.base.max:
    value: 1
element definition.type:
  index: -1
  element definition.type.code:
    value: code
element definition.constraint:
  index: -1
  element definition.constraint.key:
    value: ele-1
  element definition.constraint.severity:
    value: error
  element definition.constraint.human:
    value: All FHIR elements must have a @value or children
  element definition.constraint.expression:
    value: hasValue() or (children().count() > id.count())
  element definition.constraint.xpath:
    value: @value|f:*|h:div
  element definition.constraint.source:
    value: http://hl7.org/fhir/StructureDefinition/Element|4.0.1
    link: 4.0
    link: .1
element definition.is modifier:
  value: true
element definition.is modifier reason:
  value: This is labeled as "Is Modifier" because applications should not mistake a temporary or old name etc.for a current/permanent one
element definition.is summary:
  value: true
element definition.binding:
  element definition.binding.strength:
    value: required
  element definition.binding.value set:
    value: http://hl7.org/fhir/ValueSet/name-use|4.0.1
    link: 4.0
    link: .1
element definition.mapping:
  index: -1
  element definition.mapping.identity:
    value: v2
  element definition.mapping.map:
    value: XPN.7, but often indicated by which field contains the name
element definition.mapping:
  index: -1
  element definition.mapping.identity:
    value: rim
  element definition.mapping.map:
    value: unique(./use)
element definition.mapping:
  index: -1
  element definition.mapping.identity:
    value: servd
  element definition.mapping.map:
    value: ./NamePurpose

index: -1
element.id:
  value: HumanName.text
element definition.path:
  value: HumanName.text
element definition.short:
  value: Text representation of the full name
element definition.definition:
  value: Specifies the entire name as it should be displayed e.g. on an application UI. This may be provided instead of or as well as the specific parts.
element definition.comment:
  value: Can provide both a text representation and parts. Applications updating a name SHALL ensure that when both text and parts are present, no content is included in the text that isn't found in a part.
element definition.requirements:
  value: A renderable, unencoded form.
element definition.min:
  value: 0
element definition.max:
  value: 1
element definition.base:
  element definition.base.path:
    value: HumanName.text
  element definition.base.min:
    value: 0
  element definition.base.max:
    value: 1
element definition.type:
  index: -1
  element definition.type.code:
    value: string
element definition.constraint:
  index: -1
  element definition.constraint.key:
    value: ele-1
  element definition.constraint.severity:
    value: error
  element definition.constraint.human:
    value: All FHIR elements must have a @value or children
  element definition.constraint.expression:
    value: hasValue() or (children().count() > id.count())
  element definition.constraint.xpath:
    value: @value|f:*|h:div
  element definition.constraint.source:
    value: http://hl7.org/fhir/StructureDefinition/Element|4.0.1
    link: 4.0
    link: .1
element definition.is modifier:
  value: false
element definition.is summary:
  value: true
element definition.mapping:
  index: -1
  element definition.mapping.identity:
    value: v2
  element definition.mapping.map:
    value: implied by XPN.11
element definition.mapping:
  index: -1
  element definition.mapping.identity:
    value: rim
  element definition.mapping.map:
    value: ./formatted

index: -1
element.id:
  value: HumanName.family
element definition.path:
  value: HumanName.family
element definition.short:
  value: Family name (often called 'Surname')
element definition.definition:
  value: The part of a name that links to the genealogy. In some cultures (e.g. Eritrea) the family name of a son is the first name of his father.
element definition.comment:
  value: Family Name may be decomposed into specific parts using extensions (de, nl, es related cultures).
element definition.alias:
  value: surname
  index: -1
element definition.min:
  value: 1
element definition.max:
  value: 1
element definition.base:
  element definition.base.path:
    value: HumanName.family
  element definition.base.min:
    value: 0
  element definition.base.max:
    value: 1
element definition.type:
  index: -1
  element definition.type.code:
    value: string
element definition.constraint:
  index: -1
  element definition.constraint.key:
    value: ele-1
  element definition.constraint.severity:
    value: error
  element definition.constraint.human:
    value: All FHIR elements must have a @value or children
  element definition.constraint.expression:
    value: hasValue() or (children().count() > id.count())
  element definition.constraint.xpath:
    value: @value|f:*|h:div
  element definition.constraint.source:
    value: http://hl7.org/fhir/StructureDefinition/Element|4.0.1
    link: 4.0
    link: .1
element definition.is modifier:
  value: false
element definition.is summary:
  value: true
element definition.mapping:
  index: -1
  element definition.mapping.identity:
    value: v2
  element definition.mapping.map:
    value: XPN.1/FN.1
element definition.mapping:
  index: -1
  element definition.mapping.identity:
    value: rim
  element definition.mapping.map:
    value: ./part[partType = FAM]
element definition.mapping:
  index: -1
  element definition.mapping.identity:
    value: servd
  element definition.mapping.map:
    value: ./FamilyName

index: -1
element.id:
  value: HumanName.given
element definition.path:
  value: HumanName.given
element definition.short:
  value: Given names (not always 'first'). Includes middle names
element definition.definition:
  value: Given name.
element definition.comment:
  value: If only initials are recorded, they may be used in place of the full name parts. Initials may be separated into multiple given names but often aren't due to paractical limitations. This element is not called "first name" since given names do not always come first.
element definition.alias:
  value: first name
  index: -1
element definition.alias:
  value: middle name
  index: -1
element definition.min:
  value: 0
element definition.max:
  value: *
element definition.base:
  element definition.base.path:
    value: HumanName.given
  element definition.base.min:
    value: 0
  element definition.base.max:
    value: *
element definition.type:
  index: -1
  element definition.type.code:
    value: string
element definition.order meaning:
  value: Given Names appear in the correct order for presenting the name
element definition.constraint:
  index: -1
  element definition.constraint.key:
    value: ele-1
  element definition.constraint.severity:
    value: error
  element definition.constraint.human:
    value: All FHIR elements must have a @value or children
  element definition.constraint.expression:
    value: hasValue() or (children().count() > id.count())
  element definition.constraint.xpath:
    value: @value|f:*|h:div
  element definition.constraint.source:
    value: http://hl7.org/fhir/StructureDefinition/Element|4.0.1
    link: 4.0
    link: .1
element definition.is modifier:
  value: false
element definition.is summary:
  value: true
element definition.mapping:
  index: -1
  element definition.mapping.identity:
    value: v2
  element definition.mapping.map:
    value: XPN.2 + XPN.3
element definition.mapping:
  index: -1
  element definition.mapping.identity:
    value: rim
  element definition.mapping.map:
    value: ./part[partType = GIV]
element definition.mapping:
  index: -1
  element definition.mapping.identity:
    value: servd
  element definition.mapping.map:
    value: ./GivenNames

index: -1
element.id:
  value: HumanName.prefix
element definition.path:
  value: HumanName.prefix
element definition.short:
  value: Civilité
element definition.definition:
  value: Part of the name that is acquired as a title due to academic, legal, employment or nobility status, etc. and that appears at the start of the name.
element definition.min:
  value: 0
element definition.max:
  value: 1
element definition.base:
  element definition.base.path:
    value: HumanName.prefix
  element definition.base.min:
    value: 0
  element definition.base.max:
    value: *
element definition.type:
  index: -1
  element definition.type.code:
    value: string
element definition.order meaning:
  value: Prefixes appear in the correct order for presenting the name
element definition.constraint:
  index: -1
  element definition.constraint.key:
    value: ele-1
  element definition.constraint.severity:
    value: error
  element definition.constraint.human:
    value: All FHIR elements must have a @value or children
  element definition.constraint.expression:
    value: hasValue() or (children().count() > id.count())
  element definition.constraint.xpath:
    value: @value|f:*|h:div
  element definition.constraint.source:
    value: http://hl7.org/fhir/StructureDefinition/Element|4.0.1
    link: 4.0
    link: .1
element definition.is modifier:
  value: false
element definition.is summary:
  value: true
element definition.binding:
  element definition.binding.strength:
    value: required
  element definition.binding.value set:
    value: https://mos.esante.gouv.fr/NOS/JDV_J245-Civilite-CISIS/FHIR/JDV-J245-Civilite-CISIS|20230331120000
    link: 20230331120000
element definition.mapping:
  index: -1
  element definition.mapping.identity:
    value: v2
  element definition.mapping.map:
    value: XPN.5
element definition.mapping:
  index: -1
  element definition.mapping.identity:
    value: rim
  element definition.mapping.map:
    value: ./part[partType = PFX]
element definition.mapping:
  index: -1
  element definition.mapping.identity:
    value: servd
  element definition.mapping.map:
    value: ./TitleCode

index: -1
element.id:
  value: HumanName.suffix
element definition.path:
  value: HumanName.suffix
element definition.short:
  value: Titre
element definition.definition:
  value: Part of the name that is acquired as a title due to academic, legal, employment or nobility status, etc. and that appears at the end of the name.
element definition.min:
  value: 0
element definition.max:
  value: *
element definition.base:
  element definition.base.path:
    value: HumanName.suffix
  element definition.base.min:
    value: 0
  element definition.base.max:
    value: *
element definition.type:
  index: -1
  element definition.type.code:
    value: string
element definition.order meaning:
  value: Suffixes appear in the correct order for presenting the name
element definition.constraint:
  index: -1
  element definition.constraint.key:
    value: ele-1
  element definition.constraint.severity:
    value: error
  element definition.constraint.human:
    value: All FHIR elements must have a @value or children
  element definition.constraint.expression:
    value: hasValue() or (children().count() > id.count())
  element definition.constraint.xpath:
    value: @value|f:*|h:div
  element definition.constraint.source:
    value: http://hl7.org/fhir/StructureDefinition/Element|4.0.1
    link: 4.0
    link: .1
element definition.is modifier:
  value: false
element definition.is summary:
  value: true
element definition.binding:
  element definition.binding.strength:
    value: required
  element definition.binding.value set:
    value: https://mos.esante.gouv.fr/NOS/JDV_J246-Titre-CISIS/FHIR/JDV-J246-Titre-CISIS|20240126120000
    link: 20240126120000
element definition.mapping:
  index: -1
  element definition.mapping.identity:
    value: v2
  element definition.mapping.map:
    value: XPN/4
element definition.mapping:
  index: -1
  element definition.mapping.identity:
    value: rim
  element definition.mapping.map:
    value: ./part[partType = SFX]

index: -1
element.id:
  value: HumanName.period
element definition.path:
  value: HumanName.period
element definition.short:
  value: Time period when name was/is in use
element definition.definition:
  value: Indicates the period of time when this name was valid for the named person.
element definition.requirements:
  value: Allows names to be placed in historical context.
element definition.min:
  value: 0
element definition.max:
  value: 1
element definition.base:
  element definition.base.path:
    value: HumanName.period
  element definition.base.min:
    value: 0
  element definition.base.max:
    value: 1
element definition.type:
  index: -1
  element definition.type.code:
    value: Period
element definition.constraint:
  index: -1
  element definition.constraint.key:
    value: ele-1
  element definition.constraint.severity:
    value: error
  element definition.constraint.human:
    value: All FHIR elements must have a @value or children
  element definition.constraint.expression:
    value: hasValue() or (children().count() > id.count())
  element definition.constraint.xpath:
    value: @value|f:*|h:div
  element definition.constraint.source:
    value: http://hl7.org/fhir/StructureDefinition/Element|4.0.1
    link: 4.0
    link: .1
element definition.is modifier:
  value: false
element definition.is summary:
  value: true
element definition.mapping:
  index: -1
  element definition.mapping.identity:
    value: v2
  element definition.mapping.map:
    value: XPN.13 + XPN.14
element definition.mapping:
  index: -1
  element definition.mapping.identity:
    value: rim
  element definition.mapping.map:
    value: ./usablePeriod[type="IVL<TS>"]
element definition.mapping:
  index: -1
  element definition.mapping.identity:
    value: servd
  element definition.mapping.map:
    value: ./StartDate and ./EndDate

structure definition.differential.element:
  index: -1
  element.id:
    value: HumanName.family
  element definition.path:
    value: HumanName.family
  element definition.min:
    value: 1
structure definition.differential.element:
  index: -1
  element.id:
    value: HumanName.prefix
  element definition.path:
    value: HumanName.prefix
  element definition.short:
    value: Civilité
  element definition.binding:
    element definition.binding.strength:
      value: required
    element definition.binding.value set:
      value: https://mos.esante.gouv.fr/NOS/JDV_J245-Civilite-CISIS/FHIR/JDV-J245-Civilite-CISIS|20230331120000
      link: 20230331120000
structure definition.differential.element:
  index: -1
  element.id:
    value: HumanName.suffix
  element definition.path:
    value: HumanName.suffix
  element definition.short:
    value: Titre
  element definition.binding:
    element definition.binding.strength:
      value: required
    element definition.binding.value set:
      value: https://mos.esante.gouv.fr/NOS/JDV_J246-Titre-CISIS/FHIR/JDV-J246-Titre-CISIS|20240126120000
      link: 20240126120000