Общая информация
Компонент позволяет прикладывать к заявлению фотографии, соответствующие заданным ограничениям.
Поддерживаемые экраны
Компонент может быть задействован на экране типа:
Внешний вид компонента
В услуге
В конструкторе
Структура компонента PhotoUploadComponent
ВКУ |
JSON |
|
||
№ |
В конструкторе |
Атрибут |
Тип |
Описание |
1 |
Идентификатор компонента |
id |
string |
Уникальный идентификатор компонента в JSON |
2 |
Удобочитаемое имя компонента |
name |
string |
Допускается ввод любых данных для отображения в конструкторе, однако классическим видом является s1_с1, где номера – сгенерированные идентификаторы, s – экран, c – компонент |
3 |
Описание требований к фото |
label |
string |
Текст, отображающийся справа от окна загрузки фото. Должен содержать требования к загружаемому документу |
4 |
Идентификатор подсказки/саджеста/suggest |
suggestionId |
string |
Смотри статью |
|
Дополнительные атрибуты |
attrs |
object |
|
|
Описание загрузчика |
uploadedFile |
object |
|
5 |
Уникальный идентификатор загрузчика |
uploadId |
string |
Уникальный идентификатор загрузчика |
6 |
Допустимые типы файлов |
filetype |
array |
Выпадающий список с возможностью выбрать форматы, доступные пользователю для загрузки фото |
7 |
Максимально возможный объём файла после компрессии, в байтах |
maxSize |
integer |
Максимальный объём загружаемого файла |
|
Обработка ошибок валидации файла |
customImageErrorText |
object |
|
Обработка ошибки недостаточного разрешения |
dpi |
object |
||
8 |
Заголовок модального окна |
title |
string |
Заголовок окна ошибки при недостаточном разрешении загруженного файла |
9 |
Сообщение об ошибке |
text |
string |
Текст окна ошибки при недостаточном разрешении загруженного файла |
Обработка ошибки недостаточного размера файла в пикселях |
size |
object |
||
10 |
Заголовок модального окна
|
title |
string |
Заголовок окна ошибки при недостаточном размере загруженного файла |
11 | Сообщение об ошибке | text | string | Текст окна ошибки при недостаточном размере загруженного файла. Тексты ошибок разрешения и размера чаще всего будут появляться одновременно |
Обработка ошибки неверного типа файла | filetype | object | ||
12 | Заголовок модального окна | title | string | Заголовок окна ошибки при попытке загрузки файла формата, отличного от заданных атрибутом «Допустимые типы файлов» |
13 | Сообщение об ошибке | text | string | Текст окна ошибки при попытке загрузки файла формата, отличного от заданных атрибутом «Допустимые типы файлов» |
Обработка ошибки несоответствия названия файла регулярному выражению | filename | object | ||
14 | Заголовок модального окна | title | string | Заголовок окна ошибки при несоответствии названия загружаемого файла регулярному выражению |
Обработка системной ошибки | common | object | ||
15 |
Заголовок модального окна |
title | string | Заголовок окна системной ошибки |
16 | Сообщение об ошибке | text | string |
Текст окна системной ошибки |
17 | Включить проверку фото в сервисе «Айтеко»? | isValidatePhotoIteco | boolean | Если true, то после перехода с экрана выполняется запрос к сервису проверки фото «Айтеко». Если от сервиса приходят ошибки валидации – они сохраняются в ApplicantAnswers |
18 | Способ обрезки изображения | cropOptions | object | Атрибут для задания способа обрезки фото. Разные способы соответствуют различным требованиям: овал лица, соотношения сторон. При значении fanID применяется также специальная маска для fanID |
19 | Отменить кадрирование изображения? | isCropDisabled | boolean | Если true, отключает механизм обрезки. Используется для услуг, связанных с системой идентификации болельщиков |
20 | Отменить сжатие изображения? | isCompressedDisabled | boolean | Если true, отключает сжатие изображения. Используется для услуг, связанных с системой идентификации болельщиков |
21 | Тип валидации | validation | array | Позволяет добавить регулярные выражения для наименования файлов и текст ошибки в случае ошибки валидации |
22 | Пояснительные переходы | clarifications | object, array | Выпадающий список, позволяющий указать пояснительные переходы или список ссылок на пояснительные переходы |
23 | Настройка пояснительных переходов в компоненте | additionalProperties |
|
Создание модального окна (поп-ап) |
24 | Вычисляемые аргументы компонента (LinkedValues) | linkedValues | array | Атрибуты компонента, позволяющие реализовать сложный функционал |
Пример 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": "Международное" } |
Варианты использования
Компонент используется для прикрепления к заявлению фото с необходимыми форматами обрезки. Чаще всего применяется для загрузки фотографии физического лица. Имеет особые настройки, используемые для услуг, связанных с системой идентификации болельщиков.
В большинстве случаев используется эталонное оформление поп-апов, с ним можно ознакомиться в шаблоне услуги 9900, экран «Фото».