Руководство к использованию стандарта FHIR в ЦИСЗ
0.2.6803 - ci-build

Extension: AddressExtension - Детальное описание

Draft as of 2026-06-25

Определения AddressExtension extension.

Рекомендации по толкованию содержимого этой таблицы можно найтиздесь-- no content: do not translate #97 --

0. Extension
Определение

Расширение для указания адресов

КороткийАдрес
2. Extension.extension
Контроль0..0
4. Extension.url
Фиксированное значениеhttps://fhir.by/StructureDefinition/AddressExtension
6. Extension.value[x]
ТипAddress, date, Meta, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, RatioRange, Coding, SampledData, id, positiveInt, Distance, Availability, integer64, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, decimal, ExtendedContactDetail, CodeableConcept, ParameterDefinition, dateTime, code, string, oid, instant, ContactPoint, HumanName, Money, markdown, Ratio, Age, Reference, TriggerDefinition, Quantity, uri, url, Annotation, ContactDetail, boolean, Expression, CodeableReference, Signature, unsignedInt, time
[x] ЗаметкаСмотретьВыбор типов данныхдля дополнительной информации о том, как использовать [x]
8. Extension.value[x].id
Контроль0..0
10. Extension.value[x].extension
Контроль0..3
SlicingЭтот элемент представляет набор разрезов на Extension.value[x].extension. Разрезы бываютНе упорядочено и Closed, и могут быть дифференцированы с помощью следующих дискриминаторов:
  • value @ url
  • 12. Extension.value[x].extension:country
    Название разрезаcountry
    Контроль0..1
    ТипExtension(Код государства) (Тип расширения: CodeableConcept)
    Требуется поддержкаtrue
    14. Extension.value[x].extension:address
    Название разрезаaddress
    Контроль0..1
    ТипExtension(Адрес в соответствии со справочником населенных пунктов и административно-территориальных единиц Республики Беларусь) (Тип расширения: CodeableConcept)
    Требуется поддержкаtrue
    16. Extension.value[x].extension:apartment
    Название разрезаapartment
    Контроль0..1
    ТипExtension(Номер квартиры (комнаты)) (Тип расширения: string)
    Требуется поддержкаtrue
    18. Extension.value[x].use
    КороткийИспользование адреса: home | temp
    20. Extension.value[x].type
    Контроль0..0
    22. Extension.value[x].text
    КороткийТекстовое представление адреса: значение поля 'Полное наименование' справочника 'Справочник населенных пунктов и административно-территориальных единиц'
    Контроль1..?
    24. Extension.value[x].line
    КороткийСтрочное значение в котором указывается: улица, номер дома, номер квартиры
    Контроль0..1
    26. Extension.value[x].city
    КороткийНаименование населенного пункта
    28. Extension.value[x].district
    КороткийНаименование района (не городского!). Возможно дополнительно указание наименование сельского совета
    30. Extension.value[x].state
    КороткийНаименование области
    32. Extension.value[x].postalCode
    КороткийПочтовый индекс: значение поля 'Почтовый индекс' справочника 'Справочник населенных пунктов и административно-территориальных единиц'
    34. Extension.value[x].country
    КороткийНаименование страны
    36. Extension.value[x].period
    КороткийПериод когда данный адрес был действительным. Если не указана дата окончания периода, то можно считать данный адрес действительным.
    38. Extension.value[x].period.id
    Контроль0..0
    40. Extension.value[x].period.extension
    Контроль0..0
    42. Extension.value[x].period.start
    Контроль1..?

    Рекомендации по толкованию содержимого этой таблицы можно найтиздесь-- no content: do not translate #97 --

    0. Extension
    Определение

    Расширение для указания адресов

    КороткийАдрес
    Контроль0..*
    Модификаторfalse
    Инвариантыele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
    2. Extension.id
    Определение

    Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

    КороткийУникальный идентификатор для межэлементных ссылок
    Контроль0..1
    На этот элемент влияют следующие инварианты: ele-1
    Типid
    Модификаторfalse
    Формат XMLВ формате XML это свойство представлено в качестве атрибута.
    Summaryfalse
    4. Extension.extension
    Определение

    An Extension

    КороткийExtension
    Контроль0..0
    ТипExtension
    Модификаторfalse
    Summaryfalse
    Инвариантыele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
    SlicingЭтот элемент представляет набор разрезов на Extension.extension. Разрезы бываютНе упорядочено и Open, и могут быть дифференцированы с помощью следующих дискриминаторов:
    • value @ url
    • 6. Extension.url
      Определение

      Source of the definition for the extension code - a logical name or a URL.

      Короткийопределяет значение расширения
      Комментарии

      The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

      Контроль1..1
      Типuri
      Модификаторfalse
      Формат XMLВ формате XML это свойство представлено в качестве атрибута.
      Summaryfalse
      Фиксированное значениеhttps://fhir.by/StructureDefinition/AddressExtension
      8. Extension.value[x]
      Определение

      Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).

      КороткийValue of extension
      Контроль0..1
      На этот элемент влияют следующие инварианты: ext-1
      ТипAddress
      [x] ЗаметкаСмотретьВыбор типов данныхдля дополнительной информации о том, как использовать [x]
      Модификаторfalse
      Summaryfalse
      Инвариантыele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
      10. Extension.value[x].id
      Определение

      Уникальный идентификатор элемента внутри ресурса (для внутренних ссылок). Может быть любым строковым значением, не содержащее пробелов.

      КороткийУникальный идентификатор для межэлементных ссылок
      Контроль0..0
      На этот элемент влияют следующие инварианты: ele-1
      Типid
      Модификаторfalse
      Формат XMLВ формате XML это свойство представлено в качестве атрибута.
      Summaryfalse
      12. Extension.value[x].extension
      Определение

      An Extension

      КороткийExtension
      Контроль0..3
      ТипExtension
      Модификаторfalse
      Summaryfalse
      Инвариантыele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
      ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
      SlicingЭтот элемент представляет набор разрезов на Extension.value[x].extension. Разрезы бываютНе упорядочено и Closed, и могут быть дифференцированы с помощью следующих дискриминаторов:
      • value @ url
      • 14. Extension.value[x].extension:country
        Название разрезаcountry
        Определение

        Коды государств (ISO 3166-1) используются в адресах медицинских работников, пациентов, организаций, структурных подразделений и т.д.

        КороткийКод государства
        Контроль0..1
        ТипExtension(Код государства) (Тип расширения: CodeableConcept)
        Модификаторfalse
        Требуется поддержкаtrue
        Summaryfalse
        Инвариантыele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
        16. Extension.value[x].extension:address
        Название разрезаaddress
        Определение

        Адрес в соответствии со справочником населенных пунктов и административно-территориальных единиц, который содержит коды СОАТО и ардеса от названия области до дома включительно.

        КороткийАдрес в соответствии со справочником населенных пунктов и административно-территориальных единиц Республики Беларусь
        Контроль0..1
        ТипExtension(Адрес в соответствии со справочником населенных пунктов и административно-территориальных единиц Республики Беларусь) (Тип расширения: CodeableConcept)
        Модификаторfalse
        Требуется поддержкаtrue
        Summaryfalse
        Инвариантыele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
        18. Extension.value[x].extension:apartment
        Название разрезаapartment
        Определение

        Номера квартир (комнат) используются для дополнения адресов, полученных из справочника StreetGeoRegistry

        КороткийНомер квартиры (комнаты)
        Контроль0..1
        ТипExtension(Номер квартиры (комнаты)) (Тип расширения: string)
        Модификаторfalse
        Требуется поддержкаtrue
        Summaryfalse
        Инвариантыele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
        20. Extension.value[x].use
        Определение

        Назначение этого адреса.

        КороткийИспользование адреса: home | temp
        Комментарии

        Приложения могут предполагать, что адрес является текущим, если в нем явно не указано, что он временный или старый.

        Контроль0..1
        ПривязкаКоды ДОЛЖНЫ быть взяты из AddressUse
        (required to http://hl7.org/fhir/ValueSet/address-use|5.0.0)

        Использование адреса (home / work / etc.).

        Типcode
        Модификаторtrue потому что Помечено как «Является модификатором», потому что приложения не должны путать временный или старый адрес и т. д. с текущим/постоянным.
        Примитивное значениеЭтот примитивный элемент может присутствовать или отсутствовать, или быть замененным расширением
        Summarytrue
        Требования

        Позволяет выбрать подходящий адрес из списка.

        ПримерGeneral: home
        Инвариантыele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        22. Extension.value[x].type
        Определение

        Различает физические адреса (те, которые вы можете посетить) и почтовые адреса (например, почтовые ящики и адреса временного хранения). В большинстве случаев используется оба типа (both).

        Короткийpostal | physical | both
        Комментарии

        ???Определение адреса гласит, что «адрес предназначен для описания почтовых адресов, а не физического местоположения». Однако многие приложения отслеживают, имеет ли адрес двойную цель: быть местом, которое можно посетить, а также действительным пунктом назначения доставки, а почтовые адреса часто используются в качестве прокси для физических местоположений (см. также файл [Location](http://hl7.org/fhir/R5/location. html#) ресурс).

        Контроль0..0
        ПривязкаКоды ДОЛЖНЫ быть взяты из AddressType
        (required to http://hl7.org/fhir/ValueSet/address-type|5.0.0)

        Тип адреса (физический / почтовый).

        Типcode
        Модификаторfalse
        Примитивное значениеЭтот примитивный элемент может присутствовать или отсутствовать, или быть замененным расширением
        Summarytrue
        ПримерGeneral: both
        Инвариантыele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        24. Extension.value[x].text
        Определение

        Указывает весь адрес в том виде, в котором он должен отображаться.

        КороткийТекстовое представление адреса: значение поля 'Полное наименование' справочника 'Справочник населенных пунктов и административно-территориальных единиц'
        Комментарии

        ???Can provide both a text representation and parts. Applications updating an address SHALL ensure that when both text and parts are present, no content is included in the text that isn't found in a part.

        Контроль1..1
        Типstring
        Модификаторfalse
        Примитивное значениеЭтот примитивный элемент может присутствовать или отсутствовать, или быть замененным расширением
        Summarytrue
        Требования

        Отображаемая, незакодированная форма.

        ПримерGeneral: 220099, Минск, пр-т Победителей, 2, корп. 3, кв. 40
        Инвариантыele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        26. Extension.value[x].line
        Определение

        Название улицы, номер дома/строения, корпус, номер квартиры/помещения, номер абонентского ящика, советы по доставке и аналогичная адресная информация.

        КороткийСтрочное значение в котором указывается: улица, номер дома, номер квартиры
        Контроль0..1
        Типstring
        Модификаторfalse
        Примитивное значениеЭтот примитивный элемент может присутствовать или отсутствовать, или быть замененным расширением
        Summarytrue
        ПримерGeneral: пр-т Победителей, 2, корп. 3, кв. 40
        Инвариантыele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        28. Extension.value[x].city
        Определение

        Название населенного пункта: города, городского поселка, деревни и др.

        КороткийНаименование населенного пункта
        Контроль0..1
        Типstring
        Модификаторfalse
        Примитивное значениеЭтот примитивный элемент может присутствовать или отсутствовать, или быть замененным расширением
        Summarytrue
        Альтернативные именаMunicpality
        ПримерGeneral: Минск
        Инвариантыele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        30. Extension.value[x].district
        Определение

        Название района.

        КороткийНаименование района (не городского!). Возможно дополнительно указание наименование сельского совета
        Комментарии

        Название района (не район города). Для сельской местности также дополнительно будут использованы обозначения сельсоветов (т.е. единицы административно-территориального деления).

        Контроль0..1
        Типstring
        Модификаторfalse
        Примитивное значениеЭтот примитивный элемент может присутствовать или отсутствовать, или быть замененным расширением
        Summarytrue
        Альтернативные именаCounty
        ПримерGeneral: Минский район
        Инвариантыele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        32. Extension.value[x].state
        Определение

        Название области.

        КороткийНаименование области
        Контроль0..1
        Типstring
        Модификаторfalse
        Примитивное значениеЭтот примитивный элемент может присутствовать или отсутствовать, или быть замененным расширением
        Summarytrue
        Альтернативные именаProvince, Territory
        Инвариантыele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        34. Extension.value[x].postalCode
        Определение

        Почтовый индекс.

        КороткийПочтовый индекс: значение поля 'Почтовый индекс' справочника 'Справочник населенных пунктов и административно-территориальных единиц'
        Контроль0..1
        Типstring
        Модификаторfalse
        Примитивное значениеЭтот примитивный элемент может присутствовать или отсутствовать, или быть замененным расширением
        Summarytrue
        Альтернативные именаZip
        ПримерGeneral: 220099
        Инвариантыele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        36. Extension.value[x].country
        Определение

        Страна (например, это может быть двух- или трехбуквенный код ISO 3166).

        КороткийНаименование страны
        Комментарии

        Вместо удобочитаемого названия страны МОГУТ использоваться двух- или трехбуквенные коды ISO 3166.

        Контроль0..1
        Типstring
        Модификаторfalse
        Примитивное значениеЭтот примитивный элемент может присутствовать или отсутствовать, или быть замененным расширением
        Summarytrue
        Инвариантыele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        38. Extension.value[x].period
        Определение

        Период времени, когда адрес использовался/используется.

        КороткийПериод когда данный адрес был действительным. Если не указана дата окончания периода, то можно считать данный адрес действительным.
        Контроль0..1
        ТипPeriod
        Модификаторfalse
        Summarytrue
        Требования

        Позволит разместить историю изменения адресов.

        ПримерGeneral: { "start" : "2010-03-23", "end" : "2010-07-01" }
        Инвариантыele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        40. Extension.value[x].period.id
        Определение

        Уникальный идентификатор элемента в ресурсе (для внутренних ссылок). Это может быть любое строковое значение, не содержащее пробелов.

        КороткийУникальный идентификатор для межэлементных ссылок
        Контроль0..0
        На этот элемент влияют следующие инварианты: ele-1
        Типid
        Модификаторfalse
        Формат XMLВ формате XML это свойство представлено в качестве атрибута.
        Summaryfalse
        42. Extension.value[x].period.extension
        Определение

        An Extension

        КороткийExtension
        Контроль0..0
        ТипExtension
        Модификаторfalse
        Summaryfalse
        Инвариантыele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
        SlicingЭтот элемент представляет набор разрезов на Extension.value[x].period.extension. Разрезы бываютНе упорядочено и Open, и могут быть дифференцированы с помощью следующих дискриминаторов:
        • value @ url
        • 44. Extension.value[x].period.start
          Определение

          Начало периода действия.

          КороткийНачало периода действия
          Комментарии

          Если нижний элемент отсутствует, это означает, что нижняя граница неизвестна.

          Контроль1..1
          На этот элемент влияют следующие инварианты: per-1
          ТипdateTime
          Модификаторfalse
          Примитивное значениеЭтот примитивный элемент может присутствовать или отсутствовать, или быть замененным расширением
          Summarytrue
          Инвариантыele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
          46. Extension.value[x].period.end
          Определение

          Конец периода. Если дата окончания периода отсутствует, это означает, что на момент создания экземпляра не было известно или запланировано его окончание. Начало может быть в прошлом, а дата окончания - в будущем, что означает, что ожидается/планируется окончание периода в это время.

          КороткийКонец периода действия
          Комментарии

          Конечное значение включает любую соответствующую дату/время. т.е. 2012-02-03T10:00:00 относится к периоду, конечное значение которого равно 2012-02-03.

          Контроль0..1
          На этот элемент влияют следующие инварианты: per-1
          ТипdateTime
          Модификаторfalse
          Примитивное значениеЭтот примитивный элемент может присутствовать или отсутствовать, или быть замененным расширением
          Summarytrue
          Значение при отсутствииЕсли окончание периода отсутствует, это означает, что период продолжается
          Инвариантыele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))