Войти

Компонент ввода или подтверждения адреса с поддержкой муниципального деления (AddressMunicipalInput)

Общая информация

Компонент AddressMunicipalInput предназначен для ввода или подтверждения адреса с муниципальным делением с возможностью указания дополнительных помещений вручную

Поддерживаемые экраны

Компонент может быть задействован на экране типа:

Внешний вид компонента

В услуге

мун1.png

мун2.png

В конструкторе

мун3.png

мун4.png

мун5.png

мун6.png

ВКУ

JSON

 

В конструкторе

Атрибут

Тип

Описание

1

Идентификатор компонента

id

string

Уникальный идентификатор компонента в JSON

2

Имя компонента

name

string

Допускается ввод любых данных для отображения в конструкторе, однако классическим видом является s1_с1, где номера — сгенерированные идентификаторы, s — экран, c — компонент

3

Заголовок компонента

label

string

Название поля. Описывает, что пользователю необходимо ввести в отображаемое ему поле

4

Предустановка значения в поле

presetAddress

object

Предустановка значения адреса из ЛК или из другого компонента

5

Тип адреса для предустановки

type

string

Обозначает тип адреса для подстановки. Возможные типы адресов для подстановки:

  • предустановка значения ранее заполненным адресом на форме
  • адрес места проживания; адрес места регистрации
  • адрес временной регистрации
  • адрес юридический для ЮЛ
  • адрес фактический для ЮЛ
  • адрес постоянной регистрации ребенка
  • адрес фактического проживания ребенка
  • адрес временной регистрации ребенка

6

Проверка наличия адреса в ГАР

verifyInGar

boolean

При активации производится проверка на наличие введённого адреса в государственном адресном реестре. По умолчанию выключено

7

Скрыть чекбокс для указания дополнительных помещений

hideRoomCheckbox

boolean

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

8

Текст чекбокса

roomCheckboxName

string

Позволяет указать текст чекбокса, который отображается пользователю и позволяет указать дополнительные помещения
Если значение не задано, то по умолчанию отображается «Уточнить квартиру или комнату»

9

Скрыть отображение дополнительного помещения

vkuHideMainRoom

boolean

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

10

Заголовок

label

string

Позволяет выбрать заголовок поля для указания дополнительного помещения

11

Поле обязательно для заполнения

required

boolean

Позволяет сделать поле для указания дополнительного помещения обязательным для заполнения. По умолчанию необязательно для заполнения

12

Нормализовать адрес с дополнительным помещением

needNormalize

boolean

Позволяет включить нормализацию адреса с дополнительным помещением

13

Регулярное выражение

value

string

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

14

Сообщение об ошибке

errorMsg

string

Позволяет указать текст ошибки, который отображается пользователю в случае, если значение не соответствует правилу валидации

15

Скрыть отображение помещения внутри дополнительного помещения

vkuHideAdditionalRoom

boolean

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

16

Заголовок

label

string

Позволяет выбрать заголовок поля для указания помещения внутри дополнительного помещения

17

Поле обязательно для заполнения

required

boolean

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

18

Нормализовать адрес с помещением внутри дополнительного помещения

needNormalize

boolean

Позволяет включить нормализацию адреса с дополнительным помещением

19

Регулярное выражение

value

string

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

20

Сообщение об ошибке

errorMsg

string

Позволяет указать текст ошибки, который отображается пользователю в случае, если значение не соответствует правилу валидации

21

Показывать дату под адресом

vkuRegData

boolean

Позволяет отобразить поле ввода даты или периода регистрации. По умолчанию выключено

22

Тип отображаемой даты

type

string

Позволяет выбрать тип отображаемой даты. Если тип не задан, то дата отображаться не будет

23

Заголовок

label

string

Название поля для ввода даты

24

Поле обязательно для заполнения

required

boolean

Позволяет сделать поле для указания даты обязательным для заполнения. По умолчанию необязательно для заполнения

25

Ограничение на выбор даты в календаре

dateRestrictions

array

Позволяет ограничить выбор даты в календаре

26

Правила валидации

validation

object

Позволяет настроить валидацию даты и текст сообщения об ошибке, отображаемый, если правило валидации не выполняется

27

Отобразить кнопку

allowSkipButton

boolean

Позволяет отобразить кнопку для пропуска заполнения адреса. По умолчанию выключено

28

Текст кнопки

skipButtonName

string

Позволяет указать текст кнопки, предназначенной для пропуска заполнения адреса

29

Идентификатор подсказки suggest

suggestionId

string

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

30

Вычисляемые аргументы компонента (linkedValues)

linkedValues

array

Атрибуты компонента, позволяющие реализовать сложный функционал

31

Идентификаторы компонентов, для которых чистить кэш

clearCacheForComponentIds

array

При переходе на следующий экран cachedValues всех указанных компонентов будут удалены


Пример JSON структуры компонента передаваемой в DTO

{

    "visited": true,

    "value": {

        "fullAddress": "188677, Ленинградская обл, р-н Всеволожский, г.п. Муринское, г Мурино, ул Екатерининская, д 19, кв 429, ком 2",

        "data": {

            "value": "Ленинградская обл, р-н Всеволожский, г Мурино, ул Екатерининская, д 19, кв 429",

            "unrestricted_value": "188677, Ленинградская обл, р-н Всеволожский, г.п. Муринское, г Мурино, ул Екатерининская, д 19, кв 429",

            "unparsed_parts": "",

            "source": "",

            "postal_code": "188677",

            "country": "Россия",

            "country_iso_code": "RU",

            "okato": "41212504000",

            "federal_district": "Северо-Западный",

            "region_fias_id": "6d1ebb35-70c6-4129-bd55-da3969658f5d",

            "region_kladr_id": "4700000000000",

            "region_iso_code": "RU-LEN",

            "region_with_type": "Ленинградская обл",

            "region_type": "обл",

            "region_type_full": "область",

            "region": "Ленинградская",

            "area_fias_id": "3696361c-b253-4e74-b690-f7087d95c2a3",

            "area_with_type": "м.р-н Всеволожский",

            "area_type": "м.р-н",

            "area_type_full": "муниципальный район",

            "area": "Всеволожский",

            "area_kladr_id": "",

            "sub_area_fias_id": "5a90abfa-faf1-4a8e-8163-19030518ac61",

            "sub_area_with_type": "г.п. Муринское",

            "sub_area_type": "г.п.",

            "sub_area_type_full": "городское поселение",

            "sub_area": "Муринское",

            "sub_area_kladr_id": "",

            "city_fias_id": "d73506c5-015c-4c39-929a-696ea8144e16",

            "city_kladr_id": "4700511700000",

            "city_with_type": "г Мурино",

            "city_type": "г",

            "city_type_full": "город",

            "city": "Мурино",

            "settlement_fias_id": "",

            "settlement_kladr_id": "",

            "settlement_with_type": "",

            "settlement_type": "",

            "settlement_type_full": "",

            "settlement": "",

            "stead_fias_id": "",

            "stead_cadnum": "",

            "stead_kladr_id": "",

            "stead_type": "",

            "stead_type_full": "",

            "stead": "",

            "street_fias_id": "0b63edaf-f9e6-4edf-906a-d26139af9e0a",

            "street_kladr_id": "47005117000001900",

            "street_with_type": "ул Екатерининская",

            "street_type": "ул",

            "street_type_full": "улица",

            "street": "Екатерининская",

            "house_fias_id": "c8ff7dc3-3da6-47f8-93e3-aec96e689d01",

            "house_cadnum": "",

            "house_kladr_id": "4700511700000190026",

            "house_type": "д",

            "house_type_full": "дом",

            "house": "19",

            "block_type": "",

            "block_type_full": "",

            "block": "",

            "flat_fias_id": "6fb78200-98a0-4fdf-bd2f-0dfa5f588c01",

            "flat_cadnum": "",

            "flat_type": "кв",

            "flat_type_full": "квартира",

            "flat": "429",

            "flat_area": "",

            "room_fias_id": "",

            "room_cadnum": "",

            "room_type": "",

            "room_type_full": "",

            "room": "",

            "fias_id": "6fb78200-98a0-4fdf-bd2f-0dfa5f588c01",

            "fias_level": "9",

            "fias_actuality_state": "0",

            "kladr_id": "4700511700000190026",

            "geoname_id": "524311",

            "capital_marker": "0",

            "oktmo": "41612103001",

            "tax_office": "4706",

            "tax_office_legal": "4706",

            "timezone": "UTC+3",

            "geo_lat": "60.068026",

            "geo_lon": "30.442935",

            "qc_geo": "0",

            "qc_complete": "0",

            "qc_house": "2",

            "qc": "0"

        },

        "roomCheckboxActivate": true,

        "garVerified": "true",

        "regDataFrom": "2016-07-07T00:00:00.000+03:00",

        "mainRoom":"2",

        "additionalRoom":"1К"

    }

}

Варианты использования

Данный компонент может использоваться в сценариях услуги для указания адреса: фактического, регистрации, проживания, детей текущего пользователя, а также юридического получателя услуги. Функции компонента:

  • Ввод адреса с муниципальным делением
  • Предзаполнение одного из адресов с муниципальным делением из ЛК пользователя
  • Указание даты или периода регистрации вместе с адресом
  • Ввод вручную значений для дополнительных помещений указанного адреса
  • Пропуск шага с заполнением адреса и переход на следующий экран услуги согласно сценарию

Пример настроенного компонента для указания постоянного адреса регистрации с возможностью пропуска шага с заполнением адреса

мун7.png

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

мун8.png

Пример настроенного компонента для ввода юридического адреса

мун9.png

Авторизуйтесь, чтобы оставить комментарий к статье