Общая информация
Компонент AddressMunicipalInput предназначен для ввода или подтверждения адреса с муниципальным делением с возможностью указания дополнительных помещений вручную
Поддерживаемые экраны
Компонент может быть задействован на экране типа:
Внешний вид компонента
В услуге


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




|
ВКУ |
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К" } } |
Варианты использования
Данный компонент может использоваться в сценариях услуги для указания адреса: фактического, регистрации, проживания, детей текущего пользователя, а также юридического получателя услуги. Функции компонента:
- Ввод адреса с муниципальным делением
- Предзаполнение одного из адресов с муниципальным делением из ЛК пользователя
- Указание даты или периода регистрации вместе с адресом
- Ввод вручную значений для дополнительных помещений указанного адреса
- Пропуск шага с заполнением адреса и переход на следующий экран услуги согласно сценарию
Пример настроенного компонента для указания постоянного адреса регистрации с возможностью пропуска шага с заполнением адреса

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

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