Войти

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

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

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

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

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

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

В услуге 

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

PhotoUploadComponent.jpg

Структура компонента 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, экран «Фото».

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