Глобальный контекст (Global context)

ПолучитьФайлы (GetFiles)

Не рекомендуется использовать, начиная с версии 8.3.13.

Рекомендуется использовать:

• НачатьПолучениеФайловССервера

Доступен, начиная с версии 8.2.

Синтаксис:

ПолучитьФайлы(<ПолучаемыеФайлы>, <ПолученныеФайлы>, <РасположениеФайлов>, <Интерактивно>)

Параметры:

<ПолучаемыеФайлы> (обязательный)

Тип: Массив.
Массив объектов типа ОписаниеПередаваемогоФайла.
Каждый объект описывает получаемый файл:

• Хранение - расположение данных во временном хранилище или в информационной базе;
• Имя - это локальный путь, по которому должен быть расположен получаемый файл. Это может быть либо полный путь, либо часть пути, которая будет объединена со значением параметра <РасположениеФайлов>. Это также может быть имя файла или имя каталога (каталогов) + имя файла.

<ПолученныеФайлы> (необязательный)

Тип: Массив.
Массив объектов типа ОписаниеПереданногоФайла.
Каждый объект описывает получаемый файл:

• Хранение - расположение данных во временном хранилище или в информационной базе;
• Имя - это локальный путь, по которому должен быть расположен получаемый файл.

<РасположениеФайлов> (необязательный)

Тип: ДиалогВыбораФайла, Строка.
Определяет общее расположение помещаемых файлов в локальной файловой системе.
Может быть задан строкой либо заранее подготовленным диалогом выбора файлов в режиме выбора каталога или сохранения файлов.

<Интерактивно> (необязательный)

Тип: Булево.
Истина - задан интерактивный режим, в котором пользователю показывается диалог, в котором он может выбрать локальное расположение файлов.
Ложь - на сервер передается список файлов, описанный в параметре <ПолучаемыеФайлы>.
В интерактивном режиме строка, переданная в параметре <РасположениеФайлов>, рассматривается как начальное значение для выбора пути.
Значение по умолчанию: Истина.

Возвращаемое значение:

Тип: Булево.
Истина - получен хотя бы один файл; Ложь - получение всех файлов отменено пользователем.

Описание:

Получает набор файлов и сохраняет их в локальную файловую систему пользователя.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).

Примечание:

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

См. также:

Глобальный контекст, метод НачатьПолучениеФайлов
Глобальный контекст, метод ПолучитьФайлыССервераАсинх
Глобальный контекст, метод ПолучитьФайл

Использование в версии:

Доступен, начиная с версии 8.2.

Не рекомендуется использовать, начиная с версии 8.3.13.

Описание изменено в версии 8.3.18.

     Методическая информация