5. Пути к файлам в сценариях
Файл, загруженный через приложение, обычно нужен не сам по себе, а по ссылке: из сценария, из внешней системы или со страницы сайта. У каждой из этих ссылок свой вид, и все они собраны в панели сведений о файле.
Где их взять
Блок Копировать в панели сведений; тот же блок есть и у выбранной папки. Кнопка справа от строки копирует значение целиком, даже если на экране оно не поместилось.
Строка появляется только у того, что у раздела есть: без макро-префикса не будет пути для сценариев, без публикации — публичной ссылки.
Путь для сценариев
Начинается с макро-префикса — :SYNC_COMMON, :GS_PUB, :SS_PUB и других.
Макро-префикс указывает не на каталог конкретного сервера, а на его роль:
нужный каталог подставляется на том сервере, где сценарий исполняется. Подробно
о видах каталогов и о том, почему прямые пути в сценариях запрещены, — в статье
Локальные пути.
Именно это значение подставляется в компоненты сценариев, работающие с файлами: воспроизведение, запись, чтение шаблонов.
URL API
Адрес файла в REST API. По нему работает и само приложение, и вы, если
обращаетесь к файлам curl или другим средством.
Доступ к этому адресу определяется ролью учётной записи: у администратора домена он есть, остальным его открывает роль, в которой разрешён нужный эндпойнт и нужный метод — отдельно на чтение, отдельно на запись. Поэтому внешняя система, которой действительно нужно ходить к файлам, работает под своей учётной записью с такой ролью; доступ к этим адресам без настройки прав — не то, к чему следует стремиться.
Описание методов, параметров и ответов — в разделе API файловых разделов.
Публичная ссылка
Есть у разделов, содержимое которых публикуется наружу, — например у файлов домена для публикации. Ссылка собирается по шаблону раздела и содержит домен, поэтому в разных доменах она разная.
Публичная ссылка открывается без входа в систему: всё, что вы положили в такой раздел, доступно в том числе анонимным посетителям.