d9e5a92d

Свойства и методы объекта V7HttpReader. Атрибуты объекта V7SysInfo

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

объекта OLE-Automation, имплементирующего интерфейс  IStream. После того, как получен ответ на запрос от сервера, объект компоненты позволяет разобрать заголовки ответа и сохраняет  полученные данные в виде файла, переменной типа строка или объект  OLE-Automation, имплементирующий интерфейс IStream.

Для работы компоненты необходимо, чтобы в системе была установлена  динамически загружаемая библиотека доступа к Internet -  WinInet.dll.

Для осуществления доступа методам и свойствам объекта V7HttpReader  необходимо вызвать функцию  СоздатьОбъект, передав ей строку  AddIn.V7HttpReader в качестве параметра, и получить ссылку на  объект, которая присваивается переменной, через которую и будет  осуществляться доступ.

Например:

Соединение =  СоздатьОбъект(AddIn.V7HttpReader);

 Описание атрибутов и методов объекта V7HttpReader  Атрибуты  КоличествоПопытокАвторизации Синтаксис:

КоличествоПопытокАвторизации

Англоязычный синоним:

AuthAttemptsNum

Описание:

 При помощи атрибута можно задавать значение числа попыток  авторизации. Если данный атрибут установлен в ноль, вывод диалога задания параметров соединения запрещен, т.е. все параметры соединения должны быть установлены методами Ошибка! Источник ссылки не найден. и Пользователь.

Пример:

Соединение.КоличествоПопытокАвторизации = 0;

 СтрокаСостоянияОтвета Синтаксис:

 СтрокаСостоянияОтвета

Англоязычный синоним:

ResponseStatusLine

Описание:

По окончании обмена с сервером данное свойство содержит  возвращенную сервером строку статуса, которая состоит их 3-х  частей : использовавшийся при обмене протокол, код статуса,  вербальное описание кода статуса.

Примеры строки состояния ответа:

 HTTP/1.1 200 OK

 HTTP/1.1 404 Object Not Found

Пример:

см. пример из описания метода Получить.

Методы  Пользователь Устанавливает имя и пароль пользователя.

Синтаксис:

Пользователь(Имя,Пароль)

Англоязычный синоним:

 User

Параметры:

 Имя - Имя пользователя, которое   будет использоваться для  доступа к Web-серверу

 Пароль - Пароль пользователя,   который будет   использоваться для   доступа к Web-серверу

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

 Нет

Описание:

Применение этого метода позволяет подключаться к защищенным  паролем Web-серверам автоматически, без ввода пароля вручную.

Пример:

// Установка пароля

Соединение.Пользователь(Guest, Password);



 Получить Помещает содержимое указанного ресурса в файл или  указанную переменную, в зависимости от указанного типа  приемника.

Синтаксис:

Получить(URL, Приемник, ТипПриемника)

Англоязычный синоним:

Receive

Параметры:

 URL Строковая переменная, Uniform Resource Locator, адрес ресурса в  Internet

 Приемник Переменная, в которую следует поместить содержимое Internet-ресурса ТипПриемника Числовое выражение, определяет   способ сохранения содержимого   Internet-ресурса. Допустимые   значения приведены в таблице:

 ТипПриемника Способ сохранения
1 Переменная Приемник должна иметь тип строки, ее содержимое  интерпретируется как путь к файлу, в

который следует записать содержимое  ответа сервера
2 Ответ сервера запоминается в переменной Приемник в виде строки
3 Переменная Приемник должна иметь тип объекта OLE-Automation,

имплементирующего интерфейс IStream. Cодержимое ответа будет передано

этому интерфейсу, способ обработки этих данных будет зависеть от реализации OLE-объекта.
 









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

 Нет

Описание:

URL записывается в форме протокол://хост/путь. Протокол может  быть не указан или указан, как http://. В обоих случаях будет  использован протокол передачи гипертекста (HTTP). Хост  определяет имя Web-сервера, на котором расположен требуемый  ресурс, а путь указывает на расположение ресурса на сервере. Если в процессе обработки возникает ошибка, генерируется  исключительная ситуация.

Пример:

 //

 Попытка

 HTTPСоединение.Получить (

,

c:\dnld\price.xml, 1);

 Исключение

Сообщить(HTTPСоединение.СтрокаСостоянияОтвета) ;

 . . . . . .

КонецПопытки ;



 ПолучитьКакФайл Помещает содержимое указанного ресурса в файл.

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

Синтаксис:

ПолучитьКакФайл(URL, ИмяФайла)

Англоязычный синоним:

 ReceiveAsFile

Параметры:

 URL - Строковая переменная,  Uniform Resource Locator,  адрес ресурса в Internet

 ИмяФайла Строковое выражение, имя  файла, в который следует   поместить содержимое 

 Internet-ресурса

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

 Нет

Описание:

URL записывается в форме протокол://хост/путь. Протокол может  быть не указан или указан, как http://. В обоих случаях будет  использован протокол передачи гипертекста (HTTP). Хост  определяет имя Web-сервера, на котором расположен требуемый  ресурс, а путь указывает на расположение ресурса на сервере. Если в процессе обработки возникает ошибка, генерируется  исключительная ситуация.

Пример:

 //

 Попытка

 HTTPСоединение.ПолучитьКакФайл(

,

c:\dnld\price.xml);

 Исключение

Сообщить(HTTPСоединение.

СтрокаСостоянияОтвета) ;

. . . . . .

КонецПопытки ;

 ПолучитьКакСтроку Помещает содержимое указанного ресурса в строковую  переменную.

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

Синтаксис:

ПолучитьКакСтроку(URL, СтрокаДляПриема)

Англоязычный синоним:

 ReceiveAsString

Параметры:

 URL - Строковая переменная,  Uniform Resource Locator,  адрес ресурса в Internet

 СтрокаДляПриема Строковая переменная, в   которую следует поместить  содержимое   Internet-ресурса

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

 Нет

Описание:

URL записывается в форме протокол://хост/путь. Протокол может  быть не указан или указан, как http://. В обоих случаях будет  использован протокол передачи гипертекста (HTTP). Хост  определяет имя Web-сервера, на котором расположен требуемый  ресурс, а путь указывает на расположение ресурса на сервере.

 Если в процессе обработки возникает ошибка, генерируется  исключительная ситуация.

Пример:

 //

1С_ПрайсЛист = ;

Адрес = http://www.ResourceServer.ru/resources/price.txt;

Соединение.ПолучитьКакСтроку(Адрес, ПрайсЛист);



 ПолучитьКакОбъект Помещает содержимое указанного ресурса в файл.

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

Синтаксис:

ПолучитьКакОбъект(URL, Объект)

Англоязычный синоним:

 ReceiveAsObject

Параметры:

 URL - Строковая переменная,  Uniform Resource Locator,  адрес ресурса в Internet

 Объект Объект, который следует   загрузить из содержимого   Internet-ресурса

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

 Нет

Описание:

URL записывается в форме протокол://хост/путь. Протокол может  быть не указан или указан, как http://. В обоих случаях будет  использован протокол передачи гипертекста (HTTP). Хост  определяет имя Web-сервера, на котором расположен требуемый  ресурс, а путь указывает на расположение ресурса на сервере.

Объектом может быть любой OLE-объект, имплементирующий  интерфейс IStream.

Если в процессе обработки возникает ошибка, генерируется  исключительная ситуация.

Пример:

 //

 HTTPСоединение.ПолучитьКакОбъект(,XMLДокумент);



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

Синтаксис:

ОтправитьДляОбработки(URL, Источник, ТипИсточника [, Приемник, ТипПриемника])

Англоязычный синоним:

 SendAndProcess

Параметры:

 URL -Строковая переменная, Uniform  Resource Locator, адрес ресурса в   Internet

 Источник Переменная, содержимое которой   следует передать для обработки   Internet-ресурсу

 ТипИсточника Числовое выражение, определяет тип  переменной Источник и,   соответственно, способ передачи ее   содержимого Internet-ресурсу.

 Допустимые значения приведены в  таблице:

 ТипИсточника  Способ передачи
1 Переменная Источник должна иметь тип  строки, ее содержимое  интерпретируется как путь к файлу,  содержимое которого следует  присоединить к запросу

 
2  Переменная Источник должна иметь тип  строки, к запросу будет присоединено  ее содержимое
3 Переменная Источник должна иметь тип объекта OLE-Automation,  имплементирующего интерфейс IStream.  К запросу будут присоединены данные, полученные через этот интерфейс.
 Приемник Переменная, в которую следует  поместить содержимое Internet-ресурса

 ТипПриемника Числовое выражение, определяет   способ сохранения содержимого  Internet-ресурса. Допустимые    значения приведены в таблице:

ТипПриемника Способ сохранения
1 Переменная Приемник должна иметь тип  строки, ее содержимое  интерпретируется как путь к файлу, в  который следует записать содержимое  ответа сервера
2 Ответ сервера запоминается в  переменной Приемник в виде строки
3 Переменная Приемник должна иметь тип объекта OLE-Automation,  имплементирующего интерфейс IStream.  Cодержимое ответа будет передано  этому интерфейсу, способ обработки  этих данных будет зависеть от  реализации OLE-объекта.
 

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

 Нет

Описание:

URL записывается в форме протокол://хост/путь. Протокол может  быть не указан или указан, как http://. В обоих случаях будет  использован протокол передачи гипертекста (HTTP). Хост  определяет имя Web-сервера, на котором расположен требуемый  ресурс, а путь указывает на расположение ресурса на сервере.

 Если в процессе обработки возникает ошибка, генерируется  исключительная ситуация.

Пример:

 //

 HTTPСоединение.ОтправитьДляОбработки(

http://www.ResourceServer.ru/res/Active_page.asp,

XMLДокументОтпр, 3, XMLДокументПолуч, 3);

 УдалитьЗаголовкиЗапроса Метод удаляет из запроса все ранее определенные заголовки.

Синтаксис:

УдалитьЗаголовкиЗапроса()

Англоязычный синоним:

removeRequestHeaders

Параметры:

 Нет

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

 Нет

Описание:

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

Пример:

 //

HTTPСоединение.УдалитьЗаголовкиЗапроса();

 

 УстановитьЗаголовокЗапроса Устанавливает значение заголовка запроса.

Синтаксис:

УстановитьЗаголовокЗапроса(ИмяЗаголовка, Содержимое)

Англоязычный синоним:

setRequestHeader

Параметры:

 ИмяЗаголовка Строковое выражение,   наименование   устанавливаемого заголовка

Содержимое Строковое выражение,   устанавливаемое значение   заголовка

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

 Нет

Описание:

 Если заголовок с таким именем уже существовал, изменяет его  содержимое, если такого заголовка не было, новый заголовок

будет добавлен.

Пример:

 //

HTTPСоединение.УстановитьЗаголовокЗапроса(MyAction,Upload);

 ПолучитьЗаголовокОтвета Возвращает наименование заголовка ответа по номеру.

Синтаксис:

 ПолучитьЗаголовокОтвета(НомерЗаголовка)

Англоязычный синоним:

getResponseHeader

Параметры:

 НомерЗаголовка Число, порядковый номер   заголовка в ответе   сервера. Нумерация   начинается с 1.

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

Строка, наименование заголовка ответа.

Пример:

 //

Заголовок = HTTPСоединение.ПолучитьЗаголовокОтвета(1) ;

 ПолучитьСодержаниеЗаголовкаОтвета Возвращает содержание заголовка.

Синтаксис:

 ПолучитьСодержаниеЗаголовкаОтвета(Заголовок)

Англоязычный синоним:

getResponseContents

Параметры:

 //

Для Сч = 1 По HTTPСоединение.КоличествоЗаголовковОтвета() Цикл

Заголовок = HTTPСоединение.ПолучитьЗаголовокОтвета(Сч);

Содержимое = HTTPСоединение.ПолучитьСодержимоеЗаголовкаОтвета(Заголовок);

Сообщить(Заголовок + = + Содержимое;

КонецЦикла;

 

 Атрибуты объекта V7SysInfo.  Назначение объекта компоненты V7SysInfo. Объект компоненты V7SysInfo предназначена для получения информации  о системе, на которой работает 1С:Предприятие. Объект позволяет  определить версию операционной системы, тип процессора, объем оперативной памяти компьютера и номер релиза 1С:Предприятия.  Для осуществления доступа к атрибутам объекта V7Mail необходимо  вызвать функцию СоздатьОбъект, передав ей строку  AddIn.V7SysInfo в качестве параметра, и получить ссылку на  объект, которая присваивается переменной, через которую и будет  осуществляться доступ к  методам и свойствам полученного объекта.

Например:

Инфо = СоздатьОбъект(AddIn.V7SysInfo );

 Описание атрибутов объекта V7SysInfo Атрибуты  ВерсияОС Синтаксис:

 ВерсияОС

Англоязычный синоним:

OSVersion

Описание:

Атрибут ВерсияОС содержит наименование версии операционной  системы (строковое выражение).

 Процессор Синтаксис:

 Процессор

Англоязычный синоним:

 Processor

Описание:

Атрибут Процессор (строковое выражение) содержит наименование тип  процессора, установленного на компьютере.

 ОперативнаяПамять Синтаксис:

 ОперативнаяПамять

Англоязычный синоним:

 Memory

Описание:

Атрибут ОперативнаяПамять (число) содержит информацию об  объеме оперативной памяти, установленный на компьютере, в  мегабайтах.

 РелизПрограммы Синтаксис:

 РелизПрограммы

Англоязычный синоним:

 ProgrammRelease

Описание:

 Атрибут РелизПрограммы (строковое выражение) содержит  информацию о номере релиза 1С:Предприятия.



 ИмяФайлаПрограммы Синтаксис:

 ИмяФайлаПрограммы

Англоязычный синоним:

 ProgrammFileName

Описание:

 Атрибут ИмяФайлаПрограммы (строковое выражение) содержит  информацию об имени файла программы (1С:Предприятия).

 Методы  ПроверитьИмяФайла Синтаксис:

ПроверитьИмяФайла(Адрес)

Англоязычный синоним:

 CheckFileName

Параметры:

 Адрес Строковое значение  Адрес ключевого слова

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

Строковое выражение - ключевое слово.

Описание:

Метод ПроверитьИмяФайла предназначен для получения ключевого  слова по указанному адресу на диске ИТС.

Пример:

Инфо = СоздатьОбъект(AddIn.V7SysInfo);

ВерсияОперационнойСистемы = Инфо.ВерсияОС;

ТипПроцессора = Инфо.Процессор;

ОперативнаяПамятьКомпьютера = Инфо.ОперативнаяПамять;

НомерРелизаПрограммы = Инфо.РелизПрограммы;

НаименованиеФайлаПрограммы = Инфо.ИмяФайлаПрограммы;



 СоздатьGUID Синтаксис:

СоздатьGUID()

Англоязычный синоним:

CreateGUID

Параметры:

нет

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

Строковое выражение - новый GUID.

Описание:

Метод СоздатьGUID генерирует новый GUID (Globally Unique Identifier).

Пример:

Инфо = СоздатьОбъект(AddIn.V7SysInfo);

ГлобальноУникальныйИдентификатор = Инфо.СоздатьGUID();

 

Содержание раздела