# Загрузить файл

Используется для загрузки в Бипиум файлов из интернета или сгенерированных в сценарии. Файлы из интернета могут быть также прикреплены к записям [без загрузки в хранилище](https://docs.bpium.ru/bpium-setup/processes/components/editrecord#sintaksis-ukazaniya-znacheniya-polei). При этом файл будет ссылаться на внешний источник (сайт). Данный компонент позволяет копировать файлы в файловое хранилище, это бывает нужно для генерируемых временных файлов сторонними сервисами.

## Свойства

### Секция **«**&#x424;ай&#x43B;**»**

**Файл**\
Способ выбора источника файла. Доступные варианты: `загрузить по URL` и `сгенерировать файл`. Вариант «загрузить по URL» загрузит файл из интернета в файловое хранилище Бипиума. Такой вариант полезен чтобы скачать и сохранить сгенерированный файл внешним сервисом. Вариант «сгенерировать файл» загрузит в файловое хранилище файл, созданный в сценарии, например текстовый или html.

**URL**\
Свойство доступно при выбранном значении `Файл = Загрузить по URL`. Адрес файла в интернете. Формат: значение/выражение.

**Содержание файла**\
Свойство доступно при выбранном значении `Файл = Сгенерировать файл`. Содержимое созданного файла. Формат: значение/выражение.

**Имя файла**\
Название файла, включая расширение. Например, `"document.pdf"` или `"Отчет.htm"`. Если имя не задано, то система попробует использовать имя файла из URL, если это будет возможно. Формат: значение/выражение.

### Секция **«Результат»**

**Сохранить как**\
Способ выбора результата действия компонента. Доступные варианты: `файл в запись` и `вернуть ID файла`. Вариант «файл в запись» сохранит скаченный или сгенерированный файл в указанное поле, указанной записи в указанном каталоге. Если в этом поле уже сохранен файл, то он будет заменен новым. Вариант «вернуть ID файла» не сохраняет файл в запись, а возвращает идентификатор файла, чтобы сохранить его в нужную запись вручную. Это бывает нужно, если требуется скачать/сгенерировать несколько файлов и сохранить их в одно поле.

**Каталог**\
Свойство доступно при выбранном значении `Сохранить как = Файл в запись`. Каталог из числа доступных  в системе, в который требуется сохранить файл. Формат: список каталогов.

**ID записи**\
Свойство доступно при выбранном значении `Сохранить как = Файл в запись`. Идентификатор записи (ID), в которую требуется сохранить файл. Формат: значение/выражение.

**Поле**\
Свойство доступно при выбранном значении `Сохранить как = Файл в запись`. Идентификатор поля (API ID), в которое требуется сохранить файл. Формат: список полей выбранного каталога.

**ID файла**\
Свойство доступно при выбранном значении `Сохранить как = Вернуть ID файла`. Выходной параметр. Сохраняет в указанную переменную идентификатор загруженного в хранилище файла (ID). Формат: имя переменной.

**Сохранить URL файла в**\
Выходной параметр. Переменная, в которую будет сохранен URL файла в файловом хранилище. Формат: имя переменной.

## Пограничные события

![](https://1283378397-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LACZmmM2xUWbZxyRr4s%2F-LACZnWTX_UP3XcilXPc%2F-LACZrbVA6jR_bxpiWZd%2Fboundary_any.png?generation=1523867418661747\&alt=media)

Компонент поддерживает 2 типа пограничных событий:

* Ошибка — выход из компонента, если произошла какая-либо ошибка
* Таймаут — выход из компонента, спустя заданное ограничение по времени

Если компонент завершился с ошибкой, но на нем не было пограничного события, то процесс завершается. Сообщение ошибки возвращается в результатах процесса.
