O-Bridges: простой обмен данными между базами 1С и приложениями

O-Bridges lite

Работа пользователей в lite версии максимально упрощена.

Отправка данных

1. Открываете обработку обмена данными
2. Выбираете файл с данными
3. Нажимаете кнопку «Отправить»
4. Сообщаете код получателю данных

Получение данных

1. Открываете обработку обмена данными
2. Выбираете каталог, куда файл будет сохранен
3. Вводите полученный от отправителя код
4. Нажимаете кнопку «Получить»

Установка

O-Bridges lite устанавливается в три шага.

1. Устанавливаете серверное ПО

В качестве сервера может подойти интернет сервер, например, ваш web-сайт. Тогда ничего устанавливать не надо. Либо web-сервер, развернутый в локальной сети. Это Apache (2.4) + PHP (от 5.5). Рекомендуем использовать свободно распространяемый OpenServer из-за простоты установки и настройки. Его можно легко скачать по запросу в поисковиках. Инструкция, как его развернуть, есть в сети. По сути, нужно запустить исполняемый файл и просто нажать «Далее» пару раз. Работа API на IIS не тестировалась и не гарантируется.

2. Поместите в localhost сервера папку files из архива. Это серверное API обмена.

3. Интегрируете в вашу конфигурацию 1С расширение из архива. Безопасный режим должен быть отключен для работы http-соединения.

Возможно, придется донастроить права пользователей, добавив роль OBridges. Проверьте также установленный путь к API в форме настройки.

Для программистов

Вы можете интегрировать O-Bridges lite в свою конфигурацию и использовать функции из общих модулей OBr_ОбменКлиент и OBr_ОбменСервер для отправки и получения любых ваших данных, не обязательно размещенных в файлах. Серверное API можно использовать для обмена данными с мобильными, десктопными приложениями или сайтом. 

OBr_ОбменСервер

Функция ОтправитьФайл(АдресВХ, Расширение) Экспорт

АдресВХ – адрес временного хранилища, куда помещены отправляемые данные

Расширение – расширение отправляемого файла

Возвращает истину, если отправка удалась или ложь в противном случае

Функция ПрочитатьФайл (КодФайла) Экспорт

КодФайла – код для получения файла, сообщенный отправителем данных

Возвращает Ложь, если не удалось получить файл или Соответствие с полями Адрес, Расширение.

Адрес – адрес временного хранилища, куда помещены полученные данные

Расширение – расширение полученного файла

Функция УдалитьФайл(КодФайла) Экспорт

КодФайла – код для получения файла, сообщенный отправителем данных

Возвращает Истина или Ложь в зависимости, удалось ли выполнить удаление файла на сервере

OBr_ОбменСервер

Функция ОтправитьФайл(ИмяФайла) Экспорт

ИмяФайла – полное имя отправляемого файла

Функция ПрочитатьФайл(Каталог, КодФайла) Экспорт

Каталог – каталог, куда будет сохранен полученный файл

КодФайла - код для получения файла, сообщенный отправителем данных

Передача больших файлов

В API реализован механизм докачки данных. Большие файлы делятся на куски. Размер куска определяется переменной buflen в файле o-bridges.php. По умолчанию данные делятся на куски по 20кб. Также размер передаваемых данных лимитируется объемом данных, который позволяет хранить типы ДвоичныеДанные и Строка. При некоторой доработке можно исключить необходимость использования этих типов данных и тем самым снять накладываемые ими ограничения.

Функции API

Данные передаются POST-запросами с параметрами к скрипту o-bridges.php

Тестирование доступа

Без параметров

Возвращает ok

Начать передачу нового файла

reg=new            

Возвращает ok:КОД

КОД – числовой код открытого для записи файла

no – если сессия завершилась неудачей

Передать очередной пул данных

reg=add

point=НОМЕР

file=КОД

content – передаваемый пул данных, прикрепленный в теле POST запроса как «Content-Type: application/x-zip-compressed» с параметрами: «name="content"; filename="content"»

КОД – числовой код открытого для записи файла

НОМЕР – номер пула передаваемых данных длиной buflen, начиная с 1. Доступна повторная передача данных, если на клиенте каким-то образом не зафиксировался ответ об успешной отправке. Реализована защита от задваивания пулов.

Возвращает ok, если данные успешно записаны или no:ОШИБКА. Здесь ОШИБКА – это описание возникшей ошибки

Завершить передачу файла

reg=close

file=КОД

КОД – числовой код открытого для записи файла

Возвращает ok:ИД

ИД – идентификатор для скачивания файла

no – если сессия завершилась неудачей

Получить очередной пул данных файла

reg=get

point=НОМЕР

file=ИД

ИД – идентификатор получаемого файла

НОМЕР – номер пула данных длиной buflen, начиная с 1.

Возвращает ok:ДАННЫЕ, или no:ОШИБКА. Здесь ДАННЫЕ – сохраненные тестовые данные файла, ОШИБКА – это описание возникшей ошибки

Удалить файл

reg=del

file=КОД

КОД – код удаляемого файла

Возвращает ok, если операция выполнена успешно и no в противном случае

Распространение и авторские права

Вы можете использовать O-Bridges lite по своему усмотрению в том числе в коммерческих целях.

Преимущества

http-обмен, организованный не средствами http-сервисов, встроенных в 1С, имеет свои преимущества. Он более гибок, у него выше скорость, он не загружает ресурсы 1С, не требует серверной публикации 1С и не зависит от присутствия 1С в сети. Но тут дело вкуса.