HTTP сервер, HTTP асинхронный клиент, клиент ГИС МТ "Честный знак" внешние компоненты для 1С 7.7

Свойства объекта AddIn. HTTPSrv7 (сервера):

ДлинаОчереди – максимальное количество одновременно обрабатываемых запросов.

ФайлСерт – имя файла сертификата HTTPS-сервера.

ФайлКлюча – имя файла секретного ключа HTTPS-сервера

ФайлИндекс – имя файла, который будет передаваться компонентой (без обработки в 1С) в ответ на запрос без дополнительных атрибутов (URL = «\»).

КаталогОтправки – корневой каталог для передачи запрашиваемых файлов компонентой без обработки в 1С.

ФайлТипов – имя файла Mime – типов. Файл служит для автоматического формирования заголовков «Content-Type» при автоматической передаче файлов.

ЛогФайл – имя лог-файла..

Активен – число, 1 – сервер активен (запущен), 0 – сервер не активен

HTTPS – протокол сервера: 1 - HTTPS, 0 – HTTP

Порт – порт сервера

Ошибка  – последняя ошибка

Свойства объекта AddIn. HTTPSrv7 (текущего запроса-ответа):

ИД   – ИД текущего запроса

HTTP – версия HTTP запроса

Метод   – метод запроса (GET, POST и т.п.)

Хост   – часть строки запроса формата «Адрес:Порт».

.URL   – url запроса

Путь   – левая часть url, путь к запрашиваемому ресурсу

Параметры   – правая часть url, параметры и их значения

АдресКлиента   – IP-адрес HTTP-клиента, от которого поступил запрос

ЗаголовкиЗапроса   – названия и содержания всех заголовков запроса

КукиЗапроса   – имена и значения всех Cookie запроса

ПоляФормыЗапроса   – имена и значения данных формы клиента, переданных в теле запроса

ЗагруженныеФайлы   –информация о файлах (файле), прикрепленных к полям (полю) формы клиента

ДлинаЗапроса  – размер тела текущего запроса в байтах

ТелоЗапроса  – тело текущего запроса

ТелоОтвета  – содержание ответа на текущий запрос

ВебСокет – признак запроса о переходе на протокол WebSocket

Методы объекта AddIn. HTTPSrv7 (для работы с сервером):

Старт() – запускает работу сервера

Стоп() – прекращает работу сервера.

СтартЛог() – запускает запись в лог-файл

СтопЛог() – прекращает запись в лог-файл

Запрос () – устанавливает запрос с указанным ИД в качестве «текущего». Все команды работы с запросом, чтение и изменение его свойств, работа с ответом выполняются по отношению к «текущему» запросу.

Utf8ToAnsi ()  – конвертирует строку из кодировки Utf8 в ANSI.

AnsiToUtf8 ()  – конвертирует строку из кодировки ANSI в Utf8. 

Методы объекта AddIn. HTTPSrv7 (для работы с текущим запросом-ответом):

ЗапросВФайл ()  – сохраняет содержание (тело) запроса в файл.

УстановитьЗаголовок ()  – устанавливает HTTP-заголовок ответа на текущий запрос.

ДобавитьКуки ()  – добавляет в ответ HTTP-заголовок «Set-Cookie» с содержанием Имя=Значение.

Передать ()  – передает ответ с установленными ранее заголовками.

ПередатьФайл ()  – передает в качестве тела ответа  содержимое файла.

Методы объекта AddIn. HTTPSrv7 (для настройки фоновой работы сервера):

ЗагрузитьФайлДоступаКРесурсам() – загружает в качестве настроек сервера файл соответствия путей запроса и имен файлов и ограничений доступа к ним

ВыгрузитьФайлДоступаКРесурсам() – выгружает текущие настройки сервера в файл

УстановитьРесурс() – устанавливает соответствие между запрашиваемым путем и файлом, который будет выгружен сервером в ответ в фоновом режиме.

УдалитьРесурс() – удаляет из настроек сервера указанный путь 

УстановитьДоступ() – устанавливает право доступа к указанному ресурсу для указанного внешнего адреса

Методы объекта AddIn. HTTPSrv7 (для перехода на протокол WebSocket):

ВебСокетЗапрос() – ищет запрос на подключение по протоколу WebSocket с указанным ИД и устанавливает его в качестве «текущего»

ВебСокетЗапросПринять() – принимает запрос по переходу на протокол WebSocket

ВебСокетЗапросОтклонить() – отклоняет запрос по переходу на протокол WebSocket.

ВебСокетОбъект() – ищет в массиве и возвращает объект ВебСокет с указанным ИД 

Свойства объекта ВебСокет:

ИД   – ИД объекта ВебСокет

URL   – URL входящего HTTP-запроса на соединение

АдресКлиента   – IP-адрес клиента

Имя– имя клиента

ИмяЧата   – имя чата, к которому присоединен клиент

Состояние   – состояние соединения 

ПоследняяОшибка   – ошибка при выполнении последней команды

Методы объекта ВебСокет:

Пинг() – посылает сообщение c кодом Ping другой стороне

Передать() – посылает текстовое сообщение другой стороне.

ПередатьФайл() – посылает содержимое файла как бинарные данные другой стороне

КоличествоВходящих() – количество входящих сообщений текущего объекта ВебСокет

ВходящееТип() – тип входящего сообщения.

ВходящееРазмер()  – размер входящего сообщения.

Входящее()  – входящее сообщение. 

ВходящееВФайл() – выгружает входящее сообщение в файл.

ВходящееУдалить()  – удаляет указанное сообщение из массива входящих.

Закрыть()  – закрывает соединение, связанное с текущим объектом ВебСокет. 

Методы объекта AddIn. HTTPSrv7 (работа с чатами):

СоздатьЧат() – создает чат с указанным именем

ДобавитьУчастника() – добавляет в чат с указанным именем WebSocket-соединение с указанным ИД.

УчастникиЧата()  – возвращает список имен участников чата, WebSocket-соединения которых на данный момент активны.

Чаты()  – возвращает список имен чатов. 

ЗакрытьЧат() – закрывает чат с указанным именем, разрывает в нем все активные соединения.

Свойства AddIn. HTTP_Async:

КоличествоЗапросов– размер массива активных запросов.

ПоследняяОшибка – текст ошибки без привязки к ИД запроса.

Свойства AddIn. HTTP_Async (текущего запроса-ответа):

ИД – ИД текущего запроса

URL– URL текущего запроса.

ФайлПриемник – имя файла, указанное ранее в методе Новый().

Состояние– состояние запроса.

Принято – общее количество принятых байт по текущему запросу.

ВремяМСек – количество миллисекунд с начала передачи запроса.

СтрокаСостоянияОтвета– код и текст ответа сервера по HTTP-протоколу.

ДлинаОтвета– размер «тела» ответа в байтах.

Ответ– строка, «тело» ответа.

Ошибка – строка, текст ошибки в случае состояния запроса -1.

Методы AddIn. HTTP_Async :

Новый ()  – создание нового запроса.

Запрос () – ищет в массиве и устанавливает в качестве текущего запрос с указанным ИД.

ПолучитьОтвет () – проверяет массив и возвращает список ИД запросов, завершивших работу.

СтартЛог () – старт вывода сообщений в лог-файл.

СтопЛог () – прекращение вывода сообщений в лог-файл.

Utf8ToAnsi () – конвертирует строку из кодировки Utf8 в ANSI.

AnsiToUtf8 () – конвертирует строку из кодировки ANSI в Utf8.

FromJson () – парсит строку JSON, преобразуя структуру объектов и массивов JSON в структуру из вложенных «СписковЗначений» - объектов 1С 7.7

Методы AddIn. HTTP_Async (текущего запроса-ответа):

УстановитьЗаголовокЗапроса () – устанавливает HTTP-заголовок нового запроса.

Обработать() – отправляет новый запрос на обработку, присваивает ему ИД и помещает его в массив.

ОбработатьФайл() – отправляет новый запрос на обработку, присваивает ему ИД и помещает его в массив.

КоличествоЗаголовковОтвета () – количество заголовков в ответе на текущий запрос.

ПолучитьЗаголовокОтвета() – получает один из заголовков ответа.

ОтветВФайл () – сохраняет «тело» ответа в указанный фай.

Завершить () – завершает работу и удаляет из массива запросы с указанными ИД.

Методы объекта AddIn. HTTP_Async (для перехода на протокол WebSocket):

ВебСокетПодключить () – формирует и отправляет созданный ранее методом Новый() запрос на подключение по протоколу WebSocket

ВебСокетОбъект () – ищет в массиве и возвращает объект ВебСокет с указанным ИД

Свойства объекта ВебСокет:

ИД   – ИД объекта ВебСокет

URL   – URL отправленного HTTP-запроса на соединение

АдресСервера   – IP-адрес сервера

Состояние   – состояние соединения 

ПоследняяОшибка   – ошибка при выполнении последней команды

Методы объекта ВебСокет:

Пинг() – посылает сообщение c кодом Ping другой стороне

Передать() – посылает текстовое сообщение другой стороне.

ПередатьФайл() – посылает содержимое файла как бинарные данные другой стороне

КоличествоВходящих() – количество входящих сообщений текущего объекта ВебСокет

ВходящееТип() – тип входящего сообщения.

ВходящееРазмер()  – размер входящего сообщения.

Входящее()  – входящее сообщение. 

ВходящееВФайл() – выгружает входящее сообщение в файл.

ВходящееУдалить()  – удаляет указанное сообщение из массива входящих.

Закрыть()  – закрывает соединение, связанное с текущим объектом ВебСокет. 

Свойства AddIn. GISMT:

КоличествоСерт – количество сертификатов ключей цифровой подписи, в личном хранилище сертификатов текущего пользователя ОС Windows.

ПоследняяОшибка – текст последней ошибки при выполнении методов компоненты.

КлючСессии – токен, полученный в результате успешного выполнение метода "ПолучитьКлючСессии".

Методы AddIn. GISMT:

Сертификат () – получение сведений о сертификате ключа цифровой подписи, хранящемся в личном хранилище сертификатов текущего пользователя ОС Windows.

Подписать () – создает цифровую подпись в формате Base64.

ПолучитьКлючСессии () – отправляет необходимые запросы с использованием цифровой подписи к серверу ГИС МТ для получения ключа сессии.

ПолучитьДокументы ( ) – получает список загруженных документов в ГИС МТ в виде строки формата JSON.

После распаковки каталога "Demo HTTPSrv7_1" и запуска конфигурации 1С 7.7 нажимаем для запуска демо-обработки меню командной панели "HTTPSrv7".

В демо-обработке для запуска HTTP-сервера нажимаем «Старт» - «HTTP порт 3000»:

Пример обработки запроса компонентой (без обработки в 1С):

Набираем в браузере http://localhost:3000/, компонента передает в браузер файл demo.html

Пример обработки запроса в 1С:

Кликаем в браузере по кнопке «Отправить», обработка формирует ответ из элементов запроса и передает его в браузер:

Пример обработки запроса в OLE- экземпляре 1С:

Подключаем OLE-экземпляр текущей конфигурации. Нажимаем кнопку «Подключить» - «Демо»

Нажимаем в браузере «Обновить»

Пример «ручной» обработки запроса в 1С:

Нажимаем кнопку «Отключить» - отключаем OLE-экземпляр 1С.

Устанавливаем в обработке флажок «Ручная обработка запросов».

Нажимаем в браузере «Обновить».

В обработке кликаем по ИД запроса, появившегося в списке «Запросы в очереди».

В окне «Ввод значения» набираем «Привет!»:

Нажимаем «ОК».

Видим в браузере результат:

Проверим работу асинхронного клиента, а заодно и производительность HTTP-сервера 1С. Для этого отправим сразу 50 запросов и проверим время получения ответов.

Запускаем 2 демо-конфигурации. В одной запускаем обработку-сервер (HTTPSrv7) в другой – обработку-клиент (HTTP_Async):

В клиенте нажимаем кнопку «Старт запросов», дожидаемся окончания обработки запросов. Результат в таблице клиента:

Итог: 50 запросов обработано в течении 9 секунд.

Обработка демонстрирует процедуры:

- выбор сертификата из личного хранилища для получения токена ГИС МТ;

- получение ключа сессии (токена) ГИС МТ;

- получение и просмотр списка документов организации, загруженных в ГИС МТ.

Для выбора сертификата нажмите "Сертификат" и выберите нужный из списка.

Для получения ключа сессии нажмите "Ключ сессии".

Для просмотра документов установите период для отбора документов по их дате, выберите товарную группу и нажмите "Получить список документов".

Основные реквизиты документов из полученного списка будут показаны в следующем виде:

Обработка работает с типовой конфигурацией 1С 7.7 "Торговля + Склад", редакция 9.2.

Она демонстрирует простой вариант формирования отчетов по остаткам ТМЦ на складах и передачу их в ответ на запросы из браузера.

Для ее работы необходимы:

- информационная база 1С 7.7 "Торговля + Склад" (в поставку не входит),

- внешняя компонента demo_HTTPSrv7.dll или HTTPSrv7.dll (для ее регистрации необходимы права администратора компьютера),

каталоги и файлы (относительно каталога информационной базы):

- \ExtFiles\web\DemoSklad.html

- \ExtFiles\web\favicon.ico

- \ExtFiles\mime.txt

- \ExtForms\Demo_HTTPSrv7_2.ert.

Запускаем 1С 7.7 "Торговля + Склад", запускаем внешнюю обработку Demo_HTTPSrv7_2.ert, в ней запускаем HTTP- сервер порт 3000.

В браузере набираем http://localhost:3000 и получаем ответ от сервера:

Кликаем по ссылке "Запросы к 1С 7.7 "Торговля и склад"". Получаем от сервера страницу для получения отчетов "Остатки ТМЦ":

Эта страница создается в процедуре 1С из готового шаблона \ExtFiles\web\DemoSklad.html добавлением в него содержимого справочников Склады и Номенклатура.

Выбираем склад, и номенклатуру. При этом автоматически формируется строка запроса:

Кликаем по строке запроса, получаем от сервера отчет:

Процедура формирования отчета в 1С:

Процедура СоздатьФайлОтчета(ИмяФ,Склад,Номенкл)      
	Сп = СоздатьОбъект("СписокЗначений");
	Сп.Установить("ДатаКонца",ПолучитьДатуТА());
	Сп.Установить("ВидРазделителя",1);
	Сп.Установить("ВыбТМЦ",Номенкл);
	Сп.Установить("ВыбСклад",Склад);
	Сп.Установить("ВидЕдиницы",1);
	Сп.Установить("ПоказатьКомиссию",0);
	Сп.Установить("ИтогиПоКоличеству",0);
	Сп.Установить("ВыводитьЗаказанный",0);   
	глРасшифровка = Сп;
	глФлагРасшифровки = 1;
	глОбновить = 1;
	ГлТаблица = СоздатьОбъект("Таблица"); 
	
	ОткрытьФорму("Отчет.ОстаткиТМЦ");  
	ГлТаблица.Показать(,, -1);
	ГлТаблица.Записать(ИмяФ,2);
	
КонецПроцедуры

В процедуре используются встроенные возможности объекта конфигурации "Отчет.ОстаткиТМЦ", а также возможность выгрузки объекта "Таблица" в файл формата HTML.

Для демонстрации запустим чат на сервере HTTPSvr7 и подключим к нему 3 клиента: HTTP_Async, ws_jscript и WebSocket на платформе 1С 8.3

Запустим конфигурацию "Demo HTTPSrv7_1", в ней выберем пункт меню "HTTPServ7 WebSockets", и далее нажимаем «Старт» - «HTTP порт 3000». Сервер запущен. Ставим флажки "Соединения WebSocket Подключать автоматически" и "Включать в чат автоматически".

Запустим конфигурацию "Demo HTTP_Async", в ней выберем пункт меню "HTTP_Async WebSocket.

Для запуска jscript-клиента открываем в браузере файл ws_jscript.html.

Запускаем на платформе 1С 8 (не ниже 8.3.27)  любую конфигурацию, и в ней откроем внешнюю обработку "Demo_WebSocket.epf".

В конфигурации "Demo HTTP_Async" нажимаем кнопку "Новый WS":

В браузере нажимаем "Connect":

В конфигурации 1C 8 нажимаем кнопку "Новый WS":

В браузере набираем текст сообщения и нажимаем "Send":

В результате видим это сообщение у всех клиентов:

Чтобы закрыть чат в конфигурации "Demo HTTPSrv7_1" кликаем по кнопке "-" и "ОК":

Все соединения с клиентами разрываются:

Версия 0.1.0.0
- Отменена блокировка файла при передаче его клиенту. Возможна передача файла параллельно нескольким клиентам.
- Устранен сбой сервера при получении запроса с неправильным заголовком "Content-length".

Версия 0.2.0.0
- Добавлен метод "ДобавитьКуки" и свойство "КукиЗапроса".

Версия 0.2.1.0
- Добавлено свойство "ПоляФормыЗапроса".

Версия 0.2.2.0
- Добавлено свойство "ЗагруженныеФайлы".

Версия 0.3.0.0
- Добавлены методы для работы в фоновом режиме:
    ЗагрузитьФайлДоступаКРесурсам()
    ВыгрузитьФайлДоступаКРесурсам()
    УстановитьРесурс()
    УдалитьРесурс()
    УстановитьДоступ()

Версия 0.4.0.0
- Добавлена работа по протоколу WebSocket, работа с чатами.

 Версия 0.1.0.0
- Добавлен метод "ПолучитьОтвет" и свойство "URL".

 Версия 0.1.1.0
- Добавлен параметр "ОжиданиеСек" в метод "ПолучитьОтвет".

 Версия 0.2.0.0
- Оптимизировано использование оперативной памяти.

 Версия 0.2.1.0
- Исправлена ошибка дублирования заголовков запроса.

Версия 0.3.0.0
- Добавлена работа по протоколу WebSocket.

  Версия 0.1.0.0
- Включает HTTP_Async версии 0.2.1.0.