Компонент блока ввода или проверки данных по детям (ChildrenList)

Скопировать прямую ссылку на статью

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

Компонент ChildrenList позволяет выбрать одного или нескольких детей из выпадающего списка при наличии у пользователя заполненных данных о детях в ЛК ЕПГУ, а также добавить одного или нескольких детей без сохранения в ЛК. Является компонентом-контейнером, все компоненты внутри будут вложенными

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

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

Экран со сложным компонентом (UNIQUE)

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

В услуге

Рисунок1.png
Рисунок2.png

Содержимое вложенных компонентов ChildrenList

Рисунок3.png

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

Рисунок8.png

Структура компонента ChildrenList

ВКУ		JSON
№	В конструкторе	Атрибут	Тип	Описание
1	Идентификатор компонента	id	string	Уникальный идентификатор компонента в JSON
2	Имя компонента	name	string	Допускается ввод любых данных для отображения в конструкторе, однако классическим видом является s1_с1, где номера — сгенерированные идентификаторы, s — экран, c — компонент
3	Название кнопки добавления ребёнка	label	string	Название для кнопки клонирования блока «Добавить ребёнка»
4	Компонент предназначен для выбора только одного ребёнка	singleChild	boolean	Позволяет ввести только одного ребёнка на экране, блокируя клон-панель
5	Минимальное количество добавляемых детей	minOccures	Integer, string	Позволяет ввести минимальное количество клонируемых блоков. Используется, когда нужно запрещать переход на следующий экран, пока пользователь не добавит нужное количество детей
6	Максимальное количество добавляемых детей	repeatAmount	Integer, string	Позволяет ввести максимальное количество клонируемых блоков
7	Выбрать по умолчанию всех детей из ЛК	expandAllChildrenBlocks	boolean	Позволяет автоматически выбрать всех детей, добавленных в ЛК
8	Минимальный возраст ребёнка, лет	minAge	integer	Позволяет задать ограничение на минимальный возраст ребёнка
9	Максимальный возраст ребёнка, лет	maxAge	integer	Позволяет задать ограничение на максимальный возраст ребёнка
10	Минимальная дата рождения	bornAfterDate	string	Позволяет настроить минимальную дату рождения детей
11	Максимальная дата рождения	bornbeforeDate	string	Позволяет настроить максимальную дату рождения детей
12	Пол ребёнка	VKUgender	string	Возможно выбрать пол ребёнка: женский мужской любой ссылка на переменную
13	Исключение раннее выбранного ребёнка из списка	childListRef	string	Указываются компоненты, в которых были заполнены данные о детях. При следующем выборе ребёнка по сценарию услуги, раннее выбранный ребёнок не будет предложен
14	Название атрибута	attributeName	string	Позволяет настроить дополнительные условия фильтрации детей, например: Фамилия Имя Отчество СНИЛС
15	Путь до атрибута	attributePath	string	Путь до параметра из ЛК, по которому будут фильтроваться дети
16	Значение	value	string	Определение значения фильтра
17	Выражение для расчёта значения	expr	string	Если значение, с которым необходимо сравнивать параметр нужно предварительно вычислить, то выражение записывается в этом атрибуте
18	Тип значения для фильтра	valueType	string	Тип значения, который указан в value
19	Тип данных атрибута	attributeType	string	Определение типа данных атрибута
20	Логические операторы для составления сложных выражений	after	string	С помощью логических операторов можно составить сложные выражения. Для определения значения всего фильтра используется бесскобочное построение выражения
21	Подсказка под компонентом	hint	string	Текст, который отображается под компонентом
22	Отображать имя и фамилию в выпадающем списке	fullNameInList	boolean	Позволяет настроить отображение информации в выпадающем списке. Если не указано, отобразится только имя
23	Дополнительная информация	fullNameListAge	string	Позволяет настроить дополнительное отображение информации о детях: Дата рождения Возраст
24	Отображать заголовок блока «Ребёнок X»	chooseChildLabel	string	Название лейбла «Выберите или укажите вручную»
25	Название выпадающего списка	fullNameListAge	string	Позволяет настроить дополнительное отображение информации о детях: Дата рождения Возраст
26	Текст, отображаемый вместо прочерка, если не выбран ни один ребёнок из списка	defaultLabelList	string	Переопределение вида выбранного значения. По умолчанию «—»
27	Наименование элемента в выпадающем списке для добавления нового ребёнка	defaultNewList	string	Текст кнопки из выпадающего списка «Указать вручную»
28	Скрыть кнопку добавления ребёнка вручную	hideAddNewChildButton	boolean	Позволяет скрыть кнопку добавления ребёнка вручную в выпадающем списке
29	Название поля	description	array	Отображается на форме в тексте ошибки при нарушении уникальности данных. Должно начинаться со строчной буквы. Пример: серия свидетельства о рождении
30	Идентификатор компонента, уникальность которого проверяется	fieldId	string	Указывается идентификатор компонента, для которого необходима проверка на уникальность
31	Наименование поля, уникальность которого проверяется	properties	array	Если нужно проверить уникальность данных, которые пользователь заполняет не в компоненте-контейнере, а в компонентах, расположенных на следующих экранах внутри цикла, то таким компонентам необходимо присвоить наименование в атрибуте «Название поля, в которое записать ответ пользователя» и указать его же в данном атрибуте
32	Сообщите об ошибке	errorMsg	string	Текст ошибки, который выводится при нарушении уникальности значения
33	Заголовок	title	string	Заголовок дисклеймера, который будет отображаться при нарушении уникальности детей
34	Текст	description	string	Текст дисклеймера, который будет отображаться при нарушении уникальности детей
35	Цвет	type	string	Позволяет задать цвет дисклеймера, который будет отображаться при нарушении уникальности детей
36	Модальное окно с пояснением	clarifications	array, objects	Позволяет раскрыть блок «Настроить модальное окно с пояснением вручную» или сделать список ссылок на пояснительные переходы
37	Настроить модальное окно с пояснением вручную	acceptableTypes	additionalProperties	Позволяет настроить модальные окна
38	Отображать элемент очистки поля	isClearable	boolean	Если не указано, то после выбора ребёнка нельзя очистить поле, можно только выбрать другого
39	Принудительный ввод данных ребёнка, если в ЛК нет детей, или принудительный выбор ребёнка, если он один	obliged	boolean	Позволяет выбрать обязательный ввод данных ребёнка, если в ЛК нет детей или он один
40	Ссылка на предыдущий компонент ChildrenList	childListRef	string	Если ранее был использован компонент ChildrenList, то список детей будет сформирован на основе него
41	Компонент инициирует цикл	isCycled	boolean	Позволяет инициировать цикл из повторяющегося набора экранов для выбранных элементов списка
42	Отключение проверки значения на backend для исключения подмены	validateOff	boolean	Отключает валидацию на backend. Данная валидация проверяет, соответствуют ли данные по выбранному ребёнку ошибке
43	Заголовок	title	string	Заголовок дисклеймера при нарушении валидации персональных данных детей
44	Текст	description	string	Текст дисклеймера при нарушении валидации персональных данных детей
45	Цвет	type	string	Цвет дисклеймера при нарушении валидации персональных данных детей
46	Модальные окна с пояснениями	clarifications	object, array	Позволяет раскрыть блок «Настроить модальное окно с пояснением вручную» или сделать список ссылок на пояснительные переходы при нарушении валидации персональных данных детей
47	Настроить модальное окно с пояснением вручную	acceptableTypes	additionalProperties	Позволяет настроить модальные окна при нарушении валидации персональных данных детей
48	Настройка формирования health-метрик	healthList	array	Задаётся список событий компонента, по которым будут формироваться health-запросы
49	Отображаемые поля	visibleComponents	string	Компоненты из контейнера, которые будут отображаться вместе со списком для выбора ребёнка
50	Редактируемые поля	writableComponents	string	Компоненты из атрибута «Отображаемые поля», которые будут доступны для редактирования
51	Идентификатор подсказки suggest	suggestionId	string	Механизм отображения пользователю набора подходящих для ввода данных и автоматическое заполнение полей формы этими данными
52	Идентификаторы компонентов, для которых чистить кэш	clearCacheForComponentIds	array	Если ответ на текущий компонент отличается от того, что указан в cachedAnswers, при наличии, то будут удалены все cachedValues, указанные в этом поле
53	Вычисляемые аргументы компонента (linkedValues)	linkedValues	array, object	Атрибуты компонента, позволяющие реализовать сложный функционал

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

{

"visited": true,

"value": [

{

"isNew": "true",

"firstName": "Василий",

"gender": "F",

"id": "f192476b-3026-40ad-924c-f2c4ebba07fb",

"middleName": "Васильевич",

"lastName": "Васильев",

"birthDate": "2021-01-04T00:00:00.000+03:00",

"snils": "000-000-000 00"

}

]

}

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

С помощью компонента ChildrenList можно реализовать выбор определённого ребёнка. Например, в одном ChildrenList пользователь выбрал детей и добавил новых вручную, а в другом ChildrenList ему нужно выбрать одного из ранее выбранных или введённых детей. В настройках компонента необходимо указать ссылку на предыдущий компонент ChildrenList

Рисунок5.png

Рисунок6.png

Рисунок7.png

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