Общая информация
Логический компонент AttachmentContent позволяет прикреплять к заявлению файлы, хранящиеся в сервисе Террабайт
Поддерживаемые экраны
Компонент может быть задействован на экране типа:
- Экран отображения информации (INFO)
- Экран со сложным компонентом (UNIQUE)
- Составной экран (CUSTOM)
- Экран для повторяющегося набора компонентов (REPEATABLE)
- Специальный экран, содержащий компонент Redirect (EMPTY)
Внешний вид компонента
В конструкторе

Если включен чекбокс «Задать названия прикрепляемых файлов вручную», то отобразится блок «Настройки прикрепляемых файлов»

Структура компонента AttachmentContent
| ВКУ | JSON |
|
||
| № | В конструкторе | Атрибут | Тип | Описание |
| 1 | Идентификатор компонента | id | string | Уникальный идентификатор компонента в JSON |
| 2 | Имя компонента | name | string | Допускается ввод любых данных для отображения в конструкторе, однако классическим видом является s1_с1, где номера — сгенерированные идентификаторы, s — экран, c — компонент |
| 3 | Очищать ранее прикреплённые к заявлению файлы | cleanUp | boolean | Позволяет удалять ранее прикреплённые к заявлению файлы при повторном прохождении экрана, на котором расположен компонент |
| 4 | Максимальный объём файлов, байт | maxSize | integer | Позволяет задать максимальный разрешённый объём прикрепляемого файла в байтах |
| 5 | Упаковывать файлы в zip-архив | vkuToZip | boolean | Позволяет упаковать прикреплённый файл в zip-архив |
| 6 | Наименование zip-архива | fileName | string | Позволяет указать название zip-архива |
| 7 | Задать названия прикрепляемых файлов вручную | vkuChoice | boolean | Позволяет задать настройки каждого прикрепляемого файла |
| 8 | Мнемоника файлов, загружаемых в сервис Террабайт | mnemonic | string | Позволяет задать мнемонику, которая будет присвоена всем прикреплённым к заявлению файлам |
| 9 | Ссылка на исходный файл | fileList | string |
Позволяет задать ссылку на исходный файл, размещённый в сервисе Террабайт, в виде строки Пример: «{"objectId": "${w6}","objectTypeId": "2","mnemonic": "ZayavIP","fileExt":"pdf"}» |
| 10 | Настройки прикрепляемых файлов | fileSettings | array |
Позволяет настроить список файлов, прикладываемых из сервиса Террабайт, и присвоить каждому из них собственные мнемонику и название Настройки отображаются при включении чекбокса «Задать названия прикрепляемых файлов вручную» |
| 10.1 | Задать ссылку на исходный файл строкой | vkuStrOrObj | boolean | Позволяет задать ссылку на прикрепляемый файл в виде строки или объекта |
| 10.2 | Ссылка на исходный файл | fileLinkProperties | object | Позволяет задать ссылку на прикрепляемый файл в виде объекта |
| 10.2.1 | Идентификатор файла | objectId | string | Идентификатор файла, размещённого в сервисе Террабайт |
| 10.2.2 | Тип файла в сервисе Террабайт | objectTypeId | string | Тип файла, размещённого в сервисе Террабайт |
| 10.2.3 | Мнемоника файла | mnemonic | string | Мнемоника файла, размещённого в сервисе Террабайт |
| 10.2.4 | Расширение файла | fileExt | string | Позволяет выбрать расширение файла, размещённого в сервисе Террабайт. Возможные значения: xml, pdf, sig |
| 10.3 | Настройки загружаемого файла | fileProperties | object | Позволяет задать мнемонику и наименование файла, который будет прикреплён к заявлению |
| 10.3.1 | Мнемоника файла | mnemonic | string | Мнемоника прикрепляемого файла |
| 10.3.2 | Название файла | fileName | string | Наименование прикрепляемого файла |
| 11 | Вычисляемые аргументы компонента (linkedValues) | linkedValues | array of objects | Атрибуты компонента, позволяющие реализовать сложный функционал |
| 12 | Не использовать значение компонента при автогенерации VM шаблона | notUseInVm | boolean | Атрибут функционала автоматического создания VM шаблонов для услуг на ПГС 3.0 |
Пример JSON структуры компонента передаваемой в DTO
|
{ "value": "[{"objectId":764316489,"objectTypeId":2,"mnemonic":"af1.AttachmentContent.medicalbirthcertificates.764316489","fileName":"71100-000193.xml","fileUid":1896148629,"fileExt":"xml","fileSize":10},{"objectId":764316489,"objectTypeId":2,"mnemonic":"af1.AttachmentContent.medicalbirthcertificates.764316489","fileName":"71100-000193.sig","fileUid":1896148629,"fileExt":"sig","fileSize":10}]" "visited": true } |
Варианты использования
Компонент AttachmentContent используется для прикрепления к заявлению файлов, загруженных в сервис Террабайт. Прикрепление файла происходит путём его копирования к текущему заявлению пользователя. Исходный копируемый файл может быть сохранён в сервисе Террабайт под любым objectId. К заявлению можно приложить только файлы текущего пользователя – прикрепление файлов сторонних пользователей ограничено
После прикрепления файла через компонент AttachmentContent в черновике появятся данные о прикреплённом файле в scenarioDto.attachmentInfo и scenarioDto.applicantAnswers. Далее файл будет обработан как обычный, приложенный через файловый загрузчик, отобразится при подписании и будет отправлен в ведомство
Если исходный копируемый файл загружен в Террабайт в рамках текущего заявления из запроса к сторонней системе, например с помощью компонента BackRestCall, вызывающего генерацию файла, то для корректного прикрепления файла к заявлению необходимо также использовать компонент AttachmentContent на последующих экранах
Важно: при переходе к подписанию файлы в сервисе Террабайт, в том числе файлы, загруженные из запроса к сторонней системе, прикреплённые к заявлению, но отсутствующие в scenarioDto.attachmentInfo, будут удалены. Поэтому при возврате к заявлению с экрана подписания пользователю нужно обеспечить наличие файлов для копирования, сделав повторный запрос к сторонним системам для их генерации. Иначе компонент выдаст ошибку об отсутствии файла для копирования