/ws-soap-rails-1c

Simple Ruby on Rails SOAP webservice for integration with 1C:Enterprise 8.x client

Primary LanguageRuby

Code Climate

NOTE FOR ENGLISH-SPEAKING

This project was developed mainly for integration Ruby on Rails with 1C Enterprise 8 system. The writing of code in 1C is fully in Russian and 99% for Russian-speaking customers. That is why I don't see the reason to develope this project in English.

If you have questions, please feel free ask me by writing on my email: login.hedin@gmail.com.

Another my contacts and info about me, you can find out at alexkalinin.pro

Ruby on Rails SOAP Server + 1C:Предприятие 8 SOAP Client

Задачи проекта

  • Реализовать SOAP веб-сервис на Ruby on Rails
  • Реализовать SOAP-клиента с помощью 1C:Предприятие 8
  • Проверить возможность передавать/получать строки, числа, небольшие файлы (до 100Мб)

SOAP веб-сервис на Ruby on Rails

Задачу реализации SOAP-сервиса удалось решить благодаря gem-у wash_out (rubygems, github)

SOAP-клиент с помощью 1C:Предприятие 8

У 1С8 есть возможность подключаться к SOAP-веб-сервисам и к REST-веб-сервисам. Я выбрал SOAP, т.к. он удобнее реализован в 1С + он удобнее в разрезе передачи разных примитивных данных (строки, числа...), а также благодаря возможности передачи довольно больших строк (до 100Мб) - можно передавать / получать также любые файлы, закодированные в base64.

Примечание: если Вам все-же нужно научить 1С выполнять прием/передачу данных по REST (например, если есть необходимость передавать файлы больше 100Мб), то можно посмотреть пример обработки _vendors/OnesSendReceiveFileWithREST.epf которая была загружена отсюда: http://forum.aeroion.ru/topic446.html

Как развернуть локально

RoR-часть запускается стандартно, командами:

cd rails/
bundle install
rails s -b 0.0.0.0 -p 3000

После сообщений:

rails_server.png

можно запустить браузер и проверить, доступен ли WSDL SOAP-сервиса:

chrome_wsdl_url.png

Для развертывания 1С-части достаточно в пустой 1С-базе (режим "Обычное приложение") запустить обработку 1c8/OnecSoapClient.epf.

Исходя из WSDL-схемы нужно прописать настройки:

onec_settings.png

Затем можно попробовать отправить по SOAP файл в виде base64-строки:

onec_file_upload.png

и принять его обратно:

onec_file_download.png

Также можно убедиться что файл не был поврежден при приеме/передаче

md5sum original.png uploaded.png downloaded.png
87f7b976523270929007e4583e05919a original.png 
87f7b976523270929007e4583e05919a uploaded.png 
87f7b976523270929007e4583e05919a downloaded.png

Список использованной литературы (ресурсов)