Руководство разработчика

Объектный тип ОПЦИИ_ПОЛУЧЕНИЯ_ФАЙЛА

Тип ОПЦИИ_ПОЛУЧЕНИЯ_ФАЙЛА используется для задания дополнительных параметров получения файла с удаленного сервера функцией ПОЛУЧИТЬ_ФАЙЛ.

Поля

Тип Поле Описание Значение по умолчанию
ЛОГИКА исп_юникодЗадает кодирование параметров POST-запроса (поля_формы) в UTF-8. По умолчанию кодирование выполняется в ANSI cp 1251.
ЦЕЛОЕ таймаут_ соединенияТаймаут на установление соединения в миллисекундах. 20000
ЦЕЛОЕ таймаут_ полученияТаймаут на загрузку порции данных в миллисекундах. 20000
ЛОГИКА формаОпределяет необходимость выполнения метода POST протокола http для передачи полей формы.
СТРОКА: @[СТРОКА] поля_формыПары имя-значение параметров формы для POST-запроса без специальной подготовки.
И_СТАТУС_ СЕТЕВОЙ_ ОПЕРАЦИИ статусИнтерфейс для получения информации о процессе выполнения операции и ее прерывания.
СТРОКА файлПуть к файлу для включения в тело POST-запроса протокола http. Если указан файл и поле форма равно НЕТ, то формируется POST-запрос, содержащий данные указанного файла и заголовок, указанный в поле заголовок.
СТРОКА заголовокЗаголовок POST-запроса. Используется для отправки содержимого файла в теле http-запроса или при заполнении формы. Для формы может не задаваться, в таком случае используется заголовок по умолчанию: "Content-Type: application/x-www-form-urlencoded".
ЛОГИКА отладкаЗадайте ДА для отображения отладочных сообщений в соответствующем окне (аналогично curl --verbose).
СТРОКА лог_файлЗадает имя log файла для записи отладочных сообщений. Может указываться как вместе с полем отладка=ДА, так и отдельно.
СТРОКА тип_трасс Позволяет указать режим вывода отладочной информации (трассировки).
  • Значение "bin" применяется для трассировки двоичных данных (аналогично curl --trace). Двоичные данные выводятся столбиками шестнадцатеричных значений байтов (как в hex-редакторах файлов).
  • Значение "ascii" применяется для трассировки текстовых данных (аналогично curl --trace-ascii). Не ASCII символы при выводе заменяются точкой.
  • По умолчанию используется режим диагностики и вывод заголовков (аналогично curl --verbose). Для входных и выходных данных в этом режиме выводится только размер в байтах.
Эти три режима являются взаимоисключающими.
ЛОГИКА трасс_времяВывод времени в начале строк отладочных сообщений (аналогично curl --trace-time).
ПАРАМ_ПРОКСИ проксиПараметры прокси-сервера.

При передаче файла заголовок должен соответствовать его типу. например, для передачи XML-файла заголовок будет "Content-Type: text/xml", а для передачи изображения в формате jpg: "Content-Type: image/jpeg". Кроме поля "Content-Type", заголовок может включать множество других полей, определенных для протокола http.

Замечание: POST-запрос выполняется, если поле форма равно ДА или поле файл не равно пустой строке. В противном случае выполняется GET-запрос.

См. также: