Комплекс предназначен для управления содержимым интернет-магазина opencart из 1С 8.x

Без использования PHP.

Текст обработки 1С специально написан и прокомментирован таким образом, чтобы даже новичок в программировании 1С легко в нём разобрался.

Таким образом можно подгонять задачи под себя, делать задачи по расписанию, остатки в режиме реального времени и т.д.

Например, автоматическую выгрузку товара при его сохранении или коррекцию остатков по товару в случае его продажи/перемещения/поступления,

изменение цены при переоценке и т.п.


Важной особенностью технологии является прямые чтение/запись в базу данных MySQL сайта, без использования PHP.

Никаких файлов на сайт закачивать, и, тем более, заменять не нужно.

Обмен данными 1С с сайтом можно производить в любое время, вне зависимости от количества посетителей и их активности,

без потери производительности сайта.

Кроме того, реализована работа по расписанию, так что комплекс может работать "постепенно", закачивая только изменения.


ВНИМАНИЕ! Обработка 1С пока что работает исключительно в режиме обычного приложения.

Рекомендуем завести отдельного пользователя 1С для работы с сайтом.

В режиме Конфигуратора в меню "Администрирование" - пункт "Пользователи", выбираете нужного, вкладка "Прочие" и в нижней части выбор режима запуска

заменить "Авто" на "Обычное приложение".


Можно работать с оптовыми ценами.

Если создать группу покупателей с id = 3, то покупатели этой группы увидят оптовую и перечёркнутую розничную цену.

Выполнено в виде бессрочной акции для группы покупателей с id = 3.

id группы оптовых покупателей можно посмотреть в БД сайта (например, с помощью PHPMyAdmin) в таблице customer_group_description

в поле customer_group_id. Там же можно скорректировать id.


Комплекс вносит в БД сайта данные (наименование, описание и т.п.) на двух языках (id = 1 и id = 2, обычно это русский и английский).

Для двуязычных сайтов нужно понимать, где 1С должна брать тексты на втором языке.

##########################################################################################################################################################


Работа с картинками


##########################################################################################################################################################

Для корректного отображения картинок товара на сайте необходимо и достаточно выполнение двух условий:

1. Картинка должна лежать в определённой папке (например: 'image/catalog/kartinki') и называться КодТовара.jpg для основной картинки и КодТовара_1.jpg, КодТовара_2.jpg и т.п. для дополнительных. 

2. В базе данных MySQL сайта должны содержаться корректные пути относительно папки image из корня сайта. Например: 'catalog/kartinki/КодТовара.jpg'.
Информация об основных картинках хранится в таблице product, о дополнительных - в таблице product_image.
Нужно в настройках обработки указывать путь без имён файлов и крайних слэшей. Например: 'catalog/kartinki'.

Необходимо создать специального пользователя FTP (это делается в панели управления хостингом) для работы с 1С и назначить ему папку с картинками в качестве домашней директории, а также проследить, чтобы он обладал всеми необходимыми правами для работы в этой папке.


Если Вы получили сообщение об ошибке типа:

"Не удалось установить соединение FTP с заданными параметрами: {ВнешняяОбработка.oc1c.Форма.Форма.Форма(***)}: Ошибка при вызове метода контекста (УстановитьТекущийКаталог): Ошибка аутентификации при доступе к ресурсу:  **************** Access denied to remote resource"

то либо скачайте обновлённую версию обработки для Вашей конфигурации, либо проследите, что в коде обработки переменной "ПутьФТП" присваивается пустое значение, а строки, содержащие текст "УстановитьТекущийКаталог" закомментированы или отсутствуют.


 ##########################################################################################################################################################


Дополнительная информация


##########################################################################################################################################################

При вызове метода "oc1c.Category" посмотрите на код:


ЧислоСтолбцов = 1;

meta_title = "";

meta_descr = "";

meta_description = "";

meta_keyword = "";

seo_title =  "";

seo_h1 =  "";


Число столбцов - это количество столбцов в выводе категорий в главном меню.

Остальное - мета-теги.

Все любят по-разному их заполнять, и здесь Вы можете проставить значения, как Вам нравится.

В том числе можно подставлять вышеприведённые переменные (наименование и проч.).


Если Вы используете префиксы в кодах справочника "Номенклатура", обратите внимание на

функцию "ЗаменитьПрефиксы". Там типизированные префиксы заменяются на соответствующие цифры

для обеспечения гарантированной уникальности товара при экспорте.


##########################################################################################################################################################


Совместимость


##########################################################################################################################################################


Обработка 1С написана на платформе 8.3.

Внешняя компонента совместима с любыми версиями opencart, начиная с 1.5.4.1


##########################################################################################################################################################


Порядок установки


##########################################################################################################################################################


1. Разархивируйте файл в локальную директорию на сервере 1С, например: C:\oc1c\


2. Запустите командную строку (cmd.exe) от имени Администратора.

   Наберите: "regsvr32 БукваДиска:\ПутьКудаСкачали\oc1с.dll" и нажмите enter.

   После сообщения об успешной регистрации внешней компоненты cmd можно закрыть.


3. Запустите 1С.


4. Откройте обработку управления интернет-магазином (файл oc1с_***.epf).


5. Следуйте инструкциям системы для активации лицензии.


6. Перейдите на вкладку "Параметры подключения к БД".

   Заполните поля хост, пользователь, пароль, имя Вашей базы данных и её префикс.

   Всё это смотрите в файле config.php в корне сайта (только поле "хост" может отличаться,

   в зависимости от Вашего случая подключения к базе данных сайта).

   Там же введите реквизиты FTP-доступа для экспорта картинок.

   Указанный пользователь должен обладать правами на запись в директорию с картинками на сервере магазина.

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


7. Если у Вас веб-сервер на одной машине с 1С, то Вы уже можете управлять своим магазином.


##########################################################################################################################################################


Настройка доступа к базе данных сайта


##########################################################################################################################################################


Вариант 1: сайт находится на хостинге.


Некоторые хостинг-провайдеры разрешают прямое чтение и запись в БД MySQL сразу (например, 1gb.ru, reg.ru и большинство заграничных),

некоторые по запросу (например, masterhost.ru), некоторые не разрешают вовсе (например, nic.ru).

Если Ваш провайдер разрешает, настройте в панели управления хостингом доступ к Вашей БД.

Если Ваш сервер 1С имеет статический IP, то в целях безопасности желательно разрешить внешний доступ к БД только с этого адреса.

Если хостинг-провайдер не открывает прямой доступ на порт MySQL, то можно воспользоваться технологий SSH-туннелинга.

Вам следует уточнить реквизиты SSH-доступа к Вашему сайту и установить туннель с помощью SSH-клиента, например PuTTY (putty.org.ru).

Недостатком этого способа является то, что при проблемах с интернет-соединением сеанс обравается и его часто приходится восстанавливать вручную.


Вариант 2: сайт находится на VDS/VPS. Этот вариант может быть быстрым, если на том же или "соседнем" VDS будет работать Ваша 1С.


Здесь у Вас свой собственный сервер Веб и СУБД, поэтому Вы можете множеством способов организовать доступ к базе данных,

в зависимости от Вашей операционной системы, требований к надёжности и скорости передачи данных.

Лучше всего открывать порт только для IP-адреса сервера 1С.

Можно настроить VPN.


Вариант 3: у Вас есть свой сервер. Самый быстрый вариант (до 100 товаров в секунду).


Если на одной машине иметь и 1С, и сервер СУБД, то скорость экспорта товаров на сайт ощутимо возрастает.

Наступает ситуация, когда скорость импорта/экспорта ограничивается уже не сетевыми каналами, а производительностью самой 1С.

Однако нужно понимать, что при ненадлежащей защите, сайт могут взломать злоумышленники и получить доступ к 1С.

А данные, содержащиеся в 1С, нередко очень ценны и конфиденциальны.

Идеальный с точки зрения скорости и надёжности передачи данных между 1С и сайтом вариант - размещение сервера 1С и веб-сервера

на двух разных машинах, но в одной локальной сети.

Также можно использовать виртуальные машины.


##########################################################################################################################################################


Ошибки


##########################################################################################################################################################


Иногда обработка выдаёт ошибку, содержащую текст: "MySQL server has gone away".

Тот же случай при использовании SSH-клиента (например, Putty), текст: "server unexpectedly closed network connection".

Обычно это происходит, когда сайт находится на хостинге или на неверно настроенном VDS.

Причины могут быть разные: тайм-аут, политика хостинг-провайдера, настройки MySQL-сервера и т.п.

Для того, чтобы решить эту проблему "локально", здесь и сейчас, достаточно перезапустить обработку 1С или нажать на кнопку "(Пере)подключиться к БД"

на вкладке "Параметры подключения к БД сайта". Однако проблема будет повторяться.

Для того, чтобы решить её "раз и навсегда", нужно разбираться в причинах и консультироваться с хостинг-провайдером.


В некоторых случаях пробему "MySQL server has gone away" можно решить увеличив таймаут ожидания активности в сеансе подключения к MySQL.

Для этого в коде обработки после вызова метода DBLogin (ПодключитьсяКБД) достаточно добавить следущие строки:


    Сообщить(oc1c.ВремяОжидания);

    oc1c.ВремяОжидания = 3600;


Первая строка даст Вам понять, какое таймаут ожидания активности установлен глобально для сервера MySQL хостинг-провайдером,

вторая - поможет установить желаемый таймаут для Вашего сеанса подключения к СУБД.


В любом случае причины возникновения этой проблемы лежат за пределами обработки 1С и библиотек dll.

Доказано, т.к. есть живой верно настроенный VDS с сервером 1С в 2000 км и всё работает, как часы, в режиме 24х7х365.


Если текст ошибки содержит "You have an error in your SQL syntax", скопируйте ВЕСЬ текст ошибки и пришлите на mail@oc1c.ru и support@oc1c.ru


##########################################################################################################################################################


Помощь в установке и настройке библиотеки, настройке доступа к БД, предложения по доработкам.


##########################################################################################################################################################


E-mail: mail@oc1c.ru, support@oc1c.ru


##########################################################################################################################################################

Демо-комплекс для ознакомления будет работать, но размещать в нескольких местах Вашего сайта ссылку на ресурс http://oc1c.ru

Для коммерческого использования комплекса приобретите лицензию.


Программа распространяется "как есть".

Автор не несёт ответственности за порчу или удаление критически важных данных пользователя, за убытки или недополученную прибыль.