Компонент для загрузки фото (PhotoUploadComponent)

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

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

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

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

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

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

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

В услуге

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

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

ВКУ		JSON
№	В конструкторе	Атрибут	Тип	Описание
1	Идентификатор компонента	id	string	Уникальный идентификатор компонента в JSON
2	Имя компонента	name	string	Допускается ввод любых данных для отображения в конструкторе, однако классическим видом является s1_с1, где номера — сгенерированные идентификаторы, s — экран, c — компонент
3	Описание требований к фото	label	string	Текст, отображающийся справа от окна загрузки фото. Должен содержать требования к загружаемому документу
	Атрибуты компонента	attrs	object
	Описание загрузчика	uploadedFile	object
4	Идентификатор загрузчика	uploadId	string	Уникальный идентификатор загрузчика
5	Допустимые типы файлов	filetype	array	Выпадающий список с возможностью выбрать форматы, доступные пользователю для загрузки фото
6	Максимальный объём фала, байт	maxSize	integer	Максимальный объём загружаемого файла
7	Компонент используется на циклических экранах	isCycledComponent	boolean	Необходимо включить настройку, если компонент содержится внутри цикла
8	Валидация имени файла	validation	array	Позволяет добавить регулярные выражения для наименования файлов и текст ошибки в случае ошибки валидации
	Ошибка недостаточного разрешения	dpi	object
9	Заголовок модального окна	title	string	Заголовок окна ошибки при недостаточном разрешении загруженного файла По умолчанию: «Недостаточное разрешение (DPI)»
10	Сообщение об ошибке	text	string	Текст окна ошибки при недостаточном разрешении загруженного файла По умолчанию: «DPI — это количество точек (пикселей), из которых состоит изображение, на один дюйм изображения. Чем больше пикселей на дюйм, тем лучше считывается изображение)»
	Ошибка недостаточного размера файла в пикселях	size	object
11	Заголовок модального окна	title	string	Заголовок окна ошибки при недостаточном размере загруженного файла
12	Сообщение об ошибке	text	string	Текст окна ошибки при недостаточном размере загруженного файла. Тексты ошибок разрешения и размера чаще всего будут появляться одновременно
	Ошибка неверного типа файла	filetype	object
13	Заголовок модального окна	title	string	Заголовок окна ошибки при попытке загрузки файла формата, отличного от заданных атрибутом «Допустимые типы файлов»
14	Сообщение об ошибке	text	string	Текст окна ошибки при попытке загрузки файла формата, отличного от заданных атрибутом «Допустимые типы файлов»
	Ошибка несоответствия названия файла регулярному выражению	filename	object
15	Заголовок модального окна	title	string	Заголовок окна ошибки при несоответствии названия загружаемого файла регулярному выражению
	Cистемная ошибка	common	object
16	Заголовок модального окна	title	string	Заголовок окна системной ошибки
17	Сообщение об ошибке	text	string	Текст окна системной ошибки
18	Проверять фото в сервисе «Айтеко»	isValidatePhotoIteco	boolean	При включении после перехода с экрана выполняется запрос к сервису проверки фото «Айтеко». Если от сервиса приходят ошибки валидации — они сохраняются в ApplicantAnswers
	Кадрирование фото	cropOptions	object
19	Формат	cropType	string	Атрибут для задания способа обрезки фото. Разные способы соответствуют различным требованиям: овал лица, соотношения сторон. При значении fanID применяется также специальная маска для fanID
20	Отменить кадрирование изображения	isCropDisabled	boolean	Отключает механизм обрезки. Используется для услуг, связанных с системой идентификации болельщиков
21	Отменить сжатие изображения	isCompressedDisabled	boolean	Отключает сжатие изображения. Используется для услуг, связанных с системой идентификации болельщиков
	Параметры изображения для печати	printOptions	object
22	Минимальное значение DPI	recommendedDPI	integer	По умолчанию 300 DPI. Если DPI изображения будет ниже указанного значения, то отобразится ошибка недостаточного разрешения
23	Ширина изображения, мм	printGuideWidth	integer	По умолчанию 35 мм
24	Высота изображения, мм	printGuideHeight	integer	По умолчанию 45 мм
25	Модальные окна с пояснениями	clarifications	array of objects	Позволяет раскрыть блок «Настроить модальное окно с пояснением вручную» или сделать список ссылок на пояснительные переходы
26	Настроить модальное окно с пояснением вручную	acceptableTypes	additionalProperties	Позволяет настроить модальные окна
27	Идентификатор подсказки suggest	suggestionId	string	Механизм отображения пользователю набора подходящих для ввода данных и автоматическое заполнение полей формы этими данными
28	Вычисляемые аргументы компонента (LinkedValues)	linkedValues	array of objects	Атрибуты компонента, позволяющие реализовать сложный функционал
29	Не использовать значение компонента при автогенерации VM шаблона	notUseInVm	boolean	Указывается, если услуга не работает по ВС ПГС и для неё не планируется использовать автогенерацию VM шаблонов

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

{

"visited":

{"mnemonic":"a1.PhotoUploadComponent.employee_photo.0",

"name":"24c1fb02c7568dcbf086e945f432d30a.jpg",

"objectType":2,

"objectId":764408056,

"mimeType":"image/jpeg",

"fileUid":1899493332,

"metaId":1888819093,

"objectTypeId":2,

"fileName":"24c1fb02c7568dcbf086e945f432d30a.jpg",

"fileExt":"jpg",

"fileSize":23325,

"hasSign":false,

"created":"2022-05-31",

"updated":"2022-05-31",

"realPath":"17/0/0/0/0/0/3798/Q0S5v28AIXOo",

"deleted":false,

"bucket":"epgu202205",

"nodeId":"f_dc",

"userId":1078941289,

"alternativeMimeTypes":[],

"s3EndpointCode":"epgu4"},

"value": "Международное"

}

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

Компонент используется для прикрепления к заявлению фото с необходимыми форматами обрезки. Чаще всего применяется для загрузки фотографии физического лица. Имеет особые настройки, используемые для услуг, связанных с системой идентификации болельщиков

В большинстве случаев используется эталонное оформление поп-апов, с ним можно ознакомиться в шаблоне «Загрузчик фото»

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