> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/knowledge-base/obmen/file-uploads.md).

# Загрузка файлов в дополнительных полях

Настройка загрузки изображений, PDF, Excel и CSV через поля валют и направлений

Дополнительное поле может принимать обычное значение или один либо несколько файлов. Этот режим подходит для чека, фотографии карты по утверждённому регламенту, заявления, таблицы и другого документа, который клиент должен передать вместе с заявкой.

Файловое поле не относится к медиатеке. Клиент прикрепляет файл в форме обмена, система связывает его с созданной заявкой, а оператор открывает изображение или скачивает документ из карточки этой заявки.

## Где настраивается и какие права нужны

Поле валюты настраивается по пути **«Основное» — «Валюты» — «Доп. поля валют»**. Требуется право «Разрешить управление валютами в админпанели» из блока «Базовое управление».

Поле направления настраивается по пути **«Основное» — «Направление обмена» — «Доп. поля»**. Требуется право «Разрешить доступ к направлениям в админпанели» из блока «Базовое управление».

Результат открывается по пути **«Заявки» — «Список заявок»**. Найдите и откройте заявку. Требуется право «Разрешить управление заявками в админпанели» из блока «Админпанель».

Права находятся по пути **«Пользователи» — «Список групп пользователей»**. Откройте нужную группу.

В обоих справочниках столбец «Способ заполнения» позволяет быстро отличить «Загрузка файлов» от «Стандартное поле» до открытия редактора.

{% hint style="warning" %}
Право «Разрешить управление дополнительными полями в админпанели» из блока «Базовое управление» сохраняется в списке как историческое, но само по себе не открывает актуальные справочники полей валют и направлений. Выдайте право конкретного раздела, указанное выше.
{% endhint %}

## Главное различие режимов

В поле «Способ заполнения поля» доступны:

* «Стандартное поле» — клиент вводит текст или выбирает обычное значение;
* «Загрузка файлов» — клиент прикрепляет один или несколько файлов вместо текста.

Способ заполнения выбирается при создании и затем не меняется. В редакторе существующей записи список будет заблокирован, а под ним появится пояснение «Способ заполнения зафиксирован при создании и не может быть изменён».

Если выбран неверный способ, создайте новое поле, настройте и проверьте его, замените привязки и только затем отключите прежнее. Не удаляйте используемое поле до проверки уже созданных заявок.

## Создание файлового поля

{% stepper %}
{% step %}

### Откройте нужный справочник

Для реквизита, который зависит от стороны валюты, откройте «Доп. поля валют». Для сведений, относящихся только к конкретной паре, откройте «Доп. поля» направления.
{% endstep %}

{% step %}

### Нажмите «Добавить поле»

Заполните «Название поля» на всех рабочих языках. Включите «Показывать название над полем», если подпись должна быть видна непосредственно над областью загрузки.
{% endstep %}

{% step %}

### Выберите «Загрузка файлов»

В поле «Способ заполнения поля» выберите «Загрузка файлов». Для поля валюты также укажите сторону «Отдаю» или «Получаю». Сохраните новую запись.
{% endstep %}

{% step %}

### Откройте созданное поле для редактирования

После первого сохранения становятся доступны полные параметры файла, описание, обязательность, статус, постоянный ключ и связи с валютами либо направлениями.
{% endstep %}

{% step %}

### Выберите допустимые форматы

В «Разрешённые типы файлов» оставьте хотя бы один вариант:

* PNG;
* JPEG;
* PDF;
* Excel (XLS, XLSX);
* CSV.

Разрешайте только те форматы, которые сотрудник действительно умеет безопасно проверить.
{% endstep %}

{% step %}

### Задайте ограничения

«Максимальный размер одного файла, МБ» ограничивает каждый файл отдельно. «Максимальное количество файлов» ограничивает их число в одном поле. Значение `0` означает, что это поле не добавляет собственного ограничения; общие ограничения сайта и сервера всё равно продолжают действовать. Для нового файлового поля исходно разрешён один файл.
{% endstep %}

{% step %}

### Завершите общие настройки

Заполните «ID Ключа», локализованное «Описание», «Обязательное поле», «Статус» и связи. Для поля валюты выберите «Привязанные валюты», для поля направления — нужные направления. Сохраните форму и повторно откройте её, чтобы убедиться, что форматы, лимиты и связи записаны.
{% endstep %}
{% endstepper %}

## Что увидит клиент

Вместо текстового ввода клиент увидит область загрузки с допустимыми форматами и ограничениями. Он может выбрать файл, перетащить его в область загрузки, а для изображения — вставить его из буфера обмена. Интерфейс показывает ход загрузки, готовые вложения и ошибку конкретного файла.

Обязательное файловое поле не позволяет завершить создание заявки, пока нет успешно загруженного вложения. Файл, который ещё загружается, завершился ошибкой или был удалён из списка, не считается заполненным значением.

## Что увидит оператор в заявке

Откройте **«Заявки» — «Список заявок»**, найдите заявку и проверьте стороны «Отдаю» и «Получаю» и дополнительные поля направления.

* PNG и JPEG можно открыть как изображение прямо из карточки;
* PDF, XLS, XLSX и CSV скачиваются для просмотра в подходящей программе;
* несколько файлов отображаются в сохранённом порядке;
* рядом показываются исходное имя, формат и размер.

Проверяйте, к какому полю и стороне относится вложение. Не считайте файл подтверждением оплаты, личности или права на выплату, если ваш регламент требует отдельной проверки.

## Хранение и безопасность

Вложения хранятся в закрытом хранилище и не публикуются как материалы сайта. Ссылка открытия выдаётся только через разрешённое действие и имеет ограниченный срок. Не переносите такие файлы в медиатеку и не отправляйте ссылку из панели третьим лицам.

Система проверяет заявленный тип файла и не принимает произвольные исполняемые форматы. Это снижает риск, но не отменяет осторожность: не включайте макросы в офисных документах, не вводите полученные данные на посторонних сайтах и не загружайте вложения в личные облака сотрудников.

Файл, загруженный во время заполнения формы, становится постоянным только после успешного создания заявки. Непривязанные временные загрузки удаляются фоновым обслуживанием. Поэтому исправная работа планировщика обязательна.

## Сквозная проверка

1. Создайте отдельное тестовое файловое поле и оставьте рабочие направления выключенными либо используйте безопасную тестовую пару.
2. Привяжите поле к одной валюте или одному направлению.
3. Откройте клиентскую форму в приватном окне.
4. Проверьте выбор, перетаскивание и вставку изображения.
5. Проверьте допустимый документ, запрещённый формат, превышение размера и количества.
6. Удалите один файл до создания заявки и убедитесь, что он исчез из списка.
7. Создайте тестовую заявку.
8. Откройте её в панели и проверьте предпросмотр изображения и скачивание документа.
9. Убедитесь, что другой клиент не может открыть вложение по скопированной ссылке.
10. После проверки отключите тестовое поле или удалите его связи.

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/knowledge-base/obmen/file-uploads.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.