Глобальный контекст.ПоместитьФайлыНаСерверАсинх (Global context.PutFilesToServerAsync)

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

ПоместитьФайлыНаСерверАсинх (PutFilesToServerAsync)

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

Вариант синтаксиса: По описанию передаваемых файлов

Синтаксис:

ПоместитьФайлыНаСерверАсинх(<ОписаниеОповещенияОХодеВыполнения>, <ОписаниеОповещенияПередНачалом>, <ОписанияПередаваемыхФайлов>, <УникальныйИдентификаторФормы>)

Параметры:

<ОписаниеОповещенияОХодеВыполнения> (необязательный)

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

<ПомещаемыйФайл> - тип: СсылкаНаФайл. Ссылка на файл, помещаемый во временное хранилище.
<Помещено> - тип: Число. Процент помещенной части текущего файла.
<ОтказОтПомещенияФайла> - тип: Булево. Признак отказа от дальнейшего помещения файла. Если в теле процедуры-обработчика установить данному параметру значение Истина, то помещение файла будет отменено. Значение по умолчанию: Ложь. Возвращаемый параметр.
<ПомещеноВсего> - тип: Число. Процент помещенной части всех файлов.
<ОтказОтПомещенияВсехФайлов> - тип: Булево. Признак отказа от дальнейшего помещения всех файлов. Если в теле процедуры-обработчика установить данному параметру значение Истина, то помещение всех файлов будет отменено. Значение по умолчанию: Ложь. Возвращаемый параметр.
<ДополнительныеПараметры> - Значение, которое было указано при создании объекта ОписаниеОповещения.

<ОписаниеОповещенияПередНачалом> (необязательный)

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

<ПомещаемыеФайлы> - тип: Массив. Массив элементов типа СсылкаНаФайл, готовых к помещению во временное хранилище.
<ОтказОтПомещенияВсехФайлов> - тип: Булево. Признак отказа от дальнейшего помещения всех файлов. Если в теле процедуры-обработчика установить данному параметру значение Истина, то помещение всех файлов будет отменено (в этом случае никакие другие оповещения вызваны не будут). Значение по умолчанию: Ложь. Возвращаемый параметр.
<ДополнительныеПараметры> - Значение, которое было указано при создании объекта ОписаниеОповещения.

<ОписанияПередаваемыхФайлов> (обязательный)

Тип: Массив.
Массив объектов типа ОписаниеПередаваемогоФайла. Каждый элемент массива должен содержать непустой путь к файлу на диске. Адрес временного хранилища, куда должен быть помещен файл, может быть не задан – в таком случае будет создан новый файл.

<УникальныйИдентификаторФормы> (необязательный)

Тип: УникальныйИдентификатор.
Уникальный идентификатор формы, который можно получить с помощью свойства УникальныйИдентификатор формы клиентского приложения.
Файл помещается во временное хранилище и автоматически удаляется после удаления объекта формы.
Если параметр не указан, помещенное значение будет удалено после очередного запроса сервера из общего модуля, при контекстном и неконтекстном серверном вызове из формы, при серверном вызове из модуля команды или при получении формы.

Описание варианта метода:

Помещает файлы, заданные путями на диске, из локальной файловой системы во временное хранилище.
В веб-клиенте необходимо расширение работы с файлами.
Обработчик <ОписаниеОповещенияОХодеВыполнения> в веб-клиенте будет вызван только дважды: когда общее количество помещенных во временное хранилище байт равно 0 и полному размеру помещаемых файлов.

Вариант синтаксиса: По строке поиска

Синтаксис:

ПоместитьФайлыНаСерверАсинх(<ОписаниеОповещенияОХодеВыполнения>, <ОписаниеОповещенияПередНачалом>, <СтрокаПоиска>, <УникальныйИдентификаторФормы>)

Параметры:

<ОписаниеОповещенияОХодеВыполнения> (необязательный)

<ПомещаемыйФайл> - тип: СсылкаНаФайл. Ссылка на файл, помещаемый во временное хранилище.
<Помещено> - тип: Число. Процент помещенной части текущего файла.
<ОтказОтПомещенияФайла> - тип: Булево. Признак отказа от дальнейшего помещения файла. Если в теле процедуры-обработчика установить данному параметру значение Истина, то помещение файла будет отменено. Значение по умолчанию: Ложь. Возвращаемый параметр.
<ПомещеноВсего> - тип: Число. Процент помещенной части всех файлов.
<ОтказОтПомещенияВсехФайлов> - тип: Булево. Признак отказа от дальнейшего помещения всех файлов. Если в теле процедуры-обработчика установить данному параметру значение Истина, то помещение всех файлов будет отменено. Значение по умолчанию: Ложь. Возвращаемый параметр.
<ДополнительныеПараметры> - Значение, которое было указано при создании объекта ОписаниеОповещения.

<ОписаниеОповещенияПередНачалом> (необязательный)

<ПомещаемыеФайлы> - тип: Массив. Массив элементов типа СсылкаНаФайл, готовых к помещению во временное хранилище.
<ОтказОтПомещенияВсехФайлов> - тип: Булево. Признак отказа от дальнейшего помещения всех файлов. Если в теле процедуры-обработчика установить данному параметру значение Истина, то помещение всех файлов будет отменено (в этом случае никакие другие оповещения вызваны не будут). Значение по умолчанию: Ложь. Возвращаемый параметр.
<ДополнительныеПараметры> - Значение, которое было указано при создании объекта ОписаниеОповещения.

<СтрокаПоиска> (обязательный)

Тип: Строка.
Строка должна иметь вид пути к каталогу, в котором производится поиск. Каталог может быть как на локальной сети, так и на ftp-сервере. При использовании этой схемы в адресах необходимо указывать прямые слеши '/', а не обратные '\'.
Допускается указание полного имени файла (путь + имя).

<УникальныйИдентификаторФормы> (необязательный)

Тип: УникальныйИдентификатор.
Уникальный идентификатор формы, который можно получить с помощью свойства УникальныйИдентификатор формы клиентского приложения.
Файл помещается во временное хранилище и автоматически удаляется после удаления объекта формы клиентского приложения.
Если параметр не указан, помещенное значение будет удалено после очередного запроса сервера из общего модуля, при контекстном и неконтекстном серверном вызове из формы, при серверном вызове из модуля команды или при получении формы.

Описание варианта метода:

Помещает файлы, найденные по строке поиска, из локальной файловой системы во временное хранилище.
В веб-клиенте необходимо расширение работы с файлами.
Обработчик <ОписаниеОповещенияОХодеВыполнения> в веб-клиенте вызовется только дважды: когда общее количество помещенных во временное хранилище байт равно 0 и полному размеру помещаемых файлов.

Вариант синтаксиса: По ссылкам на файлы

Синтаксис:

ПоместитьФайлыНаСерверАсинх(<ОписаниеОповещенияОХодеВыполнения>, <ОписаниеОповещенияПередНачалом>, <СсылкиНаФайлы>, <УникальныйИдентификаторФормы>)

Параметры:

<ОписаниеОповещенияОХодеВыполнения> (необязательный)

<ПомещаемыйФайл> - тип: СсылкаНаФайл. Ссылка на файл, помещаемый во временное хранилище.
<Помещено> - тип: Число. Процент помещенной части текущего файла.
<ОтказОтПомещенияФайла> - тип: Булево. Признак отказа от дальнейшего помещения файла. Если в теле процедуры-обработчика установить данному параметру значение Истина, то помещение файла будет отменено. Значение по умолчанию: Ложь. Возвращаемый параметр.
<ПомещеноВсего> - тип: Число. Процент помещенной части всех файлов.
<ОтказОтПомещенияВсехФайлов> - тип: Булево. Признак отказа от дальнейшего помещения всех файлов. Если в теле процедуры-обработчика установить данному параметру значение Истина, то помещение всех файлов будет отменено. Значение по умолчанию: Ложь. Возвращаемый параметр.
<ДополнительныеПараметры> - Значение, которое было указано при создании объекта ОписаниеОповещения.

<ОписаниеОповещенияПередНачалом> (необязательный)

<ПомещаемыеФайлы> - тип: Массив. Массив элементов типа СсылкаНаФайл, готовых к помещению во временное хранилище.
<ОтказОтПомещенияВсехФайлов> - тип: Булево. Признак отказа от дальнейшего помещения всех файлов. Если в теле процедуры-обработчика установить данному параметру значение Истина, то помещение всех файлов будет отменено (в этом случае никакие другие оповещения вызваны не будут). Значение по умолчанию: Ложь. Возвращаемый параметр.
<ДополнительныеПараметры> - Значение, которое было указано при создании объекта ОписаниеОповещения.

<СсылкиНаФайлы> (обязательный)

Тип: Массив.
Содержит массив объектов типа СсылкаНаФайл.

<УникальныйИдентификаторФормы> (необязательный)

Описание варианта метода:

Помещает файлы, заданные ссылками на файл, из локальной файловой системы во временное хранилище.
В веб-клиенте расширение работы с файлами не требуется.

Вариант синтаксиса: С диалогом выбора файлов

Синтаксис:

ПоместитьФайлыНаСерверАсинх(<ОписаниеОповещенияОХодеВыполнения>, <ОписаниеОповещенияПередНачалом>, <ПараметрыДиалога>, <УникальныйИдентификаторФормы>)

Параметры:

<ОписаниеОповещенияОХодеВыполнения> (необязательный)

<ПомещаемыйФайл> - тип: СсылкаНаФайл. Ссылка на файл, помещаемый во временное хранилище.
<Помещено> - тип: Число. Процент помещенной части текущего файла.
<ОтказОтПомещенияФайла> - тип: Булево. Признак отказа от дальнейшего помещения файла. Если в теле процедуры-обработчика установить данному параметру значение Истина, то помещение файла будет отменено. Значение по умолчанию: Ложь. Возвращаемый параметр.
<ПомещеноВсего> - тип: Число. Процент помещенной части всех файлов.
<ОтказОтПомещенияВсехФайлов> - тип: Булево. Признак отказа от дальнейшего помещения всех файлов. Если в теле процедуры-обработчика установить данному параметру значение Истина, то помещение всех файлов будет отменено. Значение по умолчанию: Ложь. Возвращаемый параметр.
<ДополнительныеПараметры> - Значение, которое было указано при создании объекта ОписаниеОповещения.

<ОписаниеОповещенияПередНачалом> (необязательный)

<ПомещаемыеФайлы> - тип: Массив. Массив элементов типа СсылкаНаФайл, готовых к помещению во временное хранилище.
<ОтказОтПомещенияВсехФайлов> - тип: Булево. Признак отказа от дальнейшего помещения всех файлов. Если в теле процедуры-обработчика установить данному параметру значение Истина, то помещение всех файлов будет отменено (в этом случае никакие другие оповещения вызваны не будут). Значение по умолчанию: Ложь. Возвращаемый параметр.
<ДополнительныеПараметры> - Значение, которое было указано при создании объекта ОписаниеОповещения.

<ПараметрыДиалога> (необязательный)

Тип: ПараметрыДиалогаПомещенияФайлов.
Структура, содержащая параметры диалога, который будет показан пользователю.

<УникальныйИдентификаторФормы> (необязательный)

Тип: УникальныйИдентификатор.
Уникальный идентификатор формы, который можно получить с помощью свойства УникальныйИдентификатор формы клиентского приложения.
Файл помещается во временное хранилище и автоматически удаляется после удаления объекта формы.
Если параметр не указан, помещенное значение будет удалено, после очередного запроса сервера из общего модуля, при контекстном и неконтекстном серверном вызове из формы, при серверном вызове из модуля команды или при получении формы.

Описание варианта метода:

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

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

Тип: Обещание.
Результат выполнения обещания - массив объектов типа ОписаниеПомещенногоФайла, либо Неопределено, если помещение файлов было отменено.

Описание:

Асинхронная функция. Помещает файлы во временное хранилище.

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

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

См. также:

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

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

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

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