Интеграция с 1С
Описание интеграции
Складскую систему "Store House 4" можно связать с бухгалтерской системой - "1С Бухгалтерия". Данный функционал (обработка) приобретается отдельно и защищен лицензионным ключом Guardant. Ниже будут рассмотрены варианты поддерживаемого связкой ПО, общие требования и рекомендации, а также информация по установке и настройке.
Важно!
Перед установкой обработки необходимо знать заранее, какая версия SH4 и какая редакция, платформа, конфигурация 1С установлены на объекте, так как не все версии программных комплексов можно связать между собой!Выгружать проводки без указания номенклатурной группы нельзя и дорабатываться этот функционал не будет.
Таблица версионности ПО и отдельных модулей используемых для выгрузки в "1С", каталоги дистрибутивов (на 25.03.2014)
| Версия SH4 | Редакция 1С, каталог на ФТП | Платформа 1С, каталог на ФТП | Конфигурация 1С | sh4book.dll | Версия обработки | Файл keys.num | ||
|---|---|---|---|---|---|---|---|---|
минимум - SH 4.70.172 и выше (рекомендуется 4.95 и выше) | 1.6 | ftp://.../storehouse/sh4/1C/Buh 1.6 | 8.1 | .../Buh 1.6/Platform_8_1/ | "1С Бухгалтерия" | не ниже 4.5.6.0 | 3.02 | не используется |
| 8.2 | .../Buh 1.6/Platform_8_2/ | |||||||
| 2.0 | ftp://.../storehouse/sh4/1C/Buh 2.0 | 8.1 | .../Buh 2.0/Platform_8_1/ | "Бухгалтерия предприятия КОРП" | не ниже 4.19.10.0 | 5.01 | используется | |
| 8.2 | .../Buh 2.0/Platform_8_2/ | "Бухгалтерия предприятия" | 5.03 | |||||
| "Бухгалтерия предприятия КОРП" | ||||||||
| 8.2.15 и выше | .../Buh 2.0/Platform_8_3/ | "Бухгалтерия предприятия" | ||||||
| "Бухгалтерия предприятия КОРП" | ||||||||
| 3.0 | ftp://.../storehouse/sh4/1C/Buh 3.0 | 8.2.17 и выше | .../Buh 3.0/Platform_8_2/ | "Бухгалтерия предприятия" | не ниже 4.15.16.0 | 6.08 и выше | не используется | |
| 8.3.3 и выше | .../Buh 3.0/Platform_8_3/ | |||||||
Установка обработки
Установка складывается из распаковки дистрибутива и копирования файлов в нужные каталоги. Также, в дистрибутиве обработки, как правило идет win-инсталлятор, которым чаще всего пользуются если и 1С и SH4 вместе со своими базами находятся локально на одном ПК.
Сама связка представлена в виде нескольких файлов:
- Интерфейсная библиотека - SH4book.dll - копируется в каталог с клиентом \SH4\Client
- После копирования, ее необходимо зарегистрировать в системе. Запустите от администратора:
"Пуск"\"Выполнить" в окне набрать: "regsvr32 <папка в которой установлен клиент Store House>\Sh4book.dll"
- Так же необходимо зарегистрировать библиотеку midas.dll, которая есть в папке клиента после установки:
"Пуск"\"Выполнить" в окне набрать: "regsvr32 <папка в которой установлен клиент Store House>\Midas.dll"
- Файл обработки для 1С - SHto1C.epf - обычно копируется в каталог установленного клиента 1С или куда угодно, например, в тот же каталог \SH4 или \SH4\1C, лишь бы путь был покороче, что бы проще было найти и открыть этот файл через 1С. открывается непосредственно через 1С:

Примечание
Если при открытии внешней обработки, появляется сообщение "Нарушение прав доступа", то выполните действия пункта ниже.- Файл settings.ini - формируется автоматически при первом запуске обработки, в том же каталоге, где находится и SHto1C.epf. В нем будут содержаться настройки используемых при работе с обработкой фильтров и среды.
- Файл keys.num - использовался только на 1С редакции 2.0, должен в обязательном порядке находиться там же, где и запускаемый через 1С файл SHto1C.epf. В этот файл вписывается уникальный код соответствия документов базы SH4 выгруженным документам в базе 1С. Пример содержимого файла:
Документы: 0 ; Код соответствия документов SH4 выгруженным документам в 1С. Заполняется при использовании нескольких баз SH4. Справочники: 0 ; Этот код, не используется. Править его не нужно, т.к. этот функционал остался на стадии разработки.
- В случае, использования нескольких баз SH4 с одной общей базой 1С, заполнение этого кода - принципиально. Можно вписать любое циферно-буквенное обозначение но, не более 37-ми символов, причем использовать желательно латинские буквы и цифры (специальные символы и прочее не использовать). Это значение будет в дальнейшем отображаться в реквизитах каждого выгруженного документа в 1С.
Важно!
Важно! по этим реквизитам документов, в случае если например, рабочий файл keys.num утерян/удален можно выяснить этот код и вписать его в новый keys.num. Если на рабочей и настроенной связке заменить keys.num на некорректный, то соответствие документов в базах будет нарушено!Разрешение открытия внешней обработки
Если при открытии внешней обработки или отчёта через меню Файл > Открыть

появляется ошибка "Нарушение прав доступа": "Нарушение прав доступа",
то сделайте следующее:
- Зайдите в конфигуратор базы:

- Выполните команду меню "Администрирование" > "Пользователи":

- Двойным щелчком откройте своего пользователя:

- Перейдите на закладку "Прочие", установите галку "Интерактивное открытие внешних отчетов и обработок" и нажмите "ОК":

- Теперь закройте конфигуратор и базу (если она у вас была открыта).
- Вновь зайдите в базу и попытайтесь открыть отчёт через меню "Файл"->"Открыть".
Несколько баз SH в одну базу 1С - версии выгрузки до 6.18
- Если выгрузка идет из нескольких баз SH4 в общую базу 1С (или из нескольких баз SH в несколько баз 1С), необходимо создать несколько отдельных каталогов, с отдельными наборами файлов SHto1C.epf, keys.num, settings.ini для каждого отдельного соединения. Пример:
\SH4\1C\SH4_Base1\
SHto1C.epf
keys.num:
Документы: sh1
settings.ini- первый экземпляр.
\SH4\1C\SH4_Base2\
SHto1C.epf
keys.num:
Документы: sh2
settings.ini- второй экземпляр и т.д.
Важно!
Если, выгрузку необходимо обновить, то файлы keys.num и settings.ini должны быть сохранены, т.е. обновляется только sh4book.dll и epf-файл!Лицензирование
Библиотека SH4book.dll защищена ключом Gurdant. Для использования выгрузки нужно получить физический ключ. На сервере лицензирования лицензия называется R-Keeper модуль Выгрузка из SHV4 в 1CV8 ПО.
Обработка будет запускаться и работать только компьютере, к которому подключен лицензионный ключ.
Изменения в установке обработки для 1С, редакция 3.0
- С версии обработки 6.08 для 1С редакции 3.0, файлы keys.num и settings.ini более не требуются. Как уже писалось выше, в одну базу 1С можно выгружать данные из нескольких баз SH4 (по организациям).
- Для каждой базы SH будут созданы и сохранены отдельные настройки, что позволит избежать перезаписи данных. Для этих целей при первом запуске загрузки в базах (и 1C и SH4) прописываются дополнительные реквизиты сопоставления.
- Так как необходимо вносить изменения в настройки 1С, то предварительно нужно включить разрешение на изменение параметров:

- далее:

Выставьте флаг и нажмите [ОК] для сохранения настроек 1С. В открывшемся окне введите код базы SH, который будет использоваться в дальнейшем для синхронизации баз данных SH и 1С. Код может содержать как буквы так и цифры (описывалось выше при пояснении назначения файла keys.num).
Примечание
Указываемый код базы в этом поле - не более двух символов!- Нажмите [Сохранить] для сохранения введенных настроек. Для отказа от сохранения настроек нажмите [Закрыть без сохранения]:

Важно!
Если в дальнейшем будет использоваться обрезание базы данных SH (любым способом) - после КАЖДОЙ обрезки необходимо в SH ЗАЧИСТИТЬ старый "код базы" 1С ("Сервис"\"Собственные реквизиты"), а в настройках "1С" прописать НОВЫЙ код 1С. Иначе произойдет РАССИНХРОНИЗАЦИЯ баз данных! Подробнее в статье об обрезке БД SH читайте в статье об удалении данных.- После сохранения данных настроек в базе SH будет создан "Дополнительный атрибут корреспондентов". И в пункте "Сервис"\"Собственные реквизиты" будет определен код для сопоставления элементов:

- а так же:

Важно!
Атрибут создается только для собственных реквизитов, в отличие от предыдущих версий выгрузки данных (атрибут создавался для словарей). Данный код будет определяющим для связи баз Store House и 1С. Если данный код будет удален из базы Store House, синхронизацию нужно будет провести заново.- Следующим шагом, необходимо сопоставить валюты.
- Выберите валюту из базы 1С, сопоставив ее с валютой SH4.
- Для сохранения внесенных изменений нажмите кнопку [Сохранить и закрыть].
- Если необходимо отказаться от сохранения внесенных настроек, нажмите кнопку [Закрыть без сохранения]:

- Остальные настройки выполняется самим пользователем, согласно прилагаемому руководству пользователя.
Решение проблем
Использование модальных окон запрещено
Если при попытке работы с выгрузкой появляется сообщение:
То необходимо отключить запрет открытия модальных окон в настройках самой 1С.
Класс не зарегистрирован
Ошибка в основном встречается на 64-битных системах. Связана с тем, что библиотека не регистрируется через regsvr32. 

Чтобы разобраться с этой проблемой, необходимо зарегистрировать библиотеку 1С — v83COMConnector. Аналогичным образом необходимо зарегистрировать библиотеку StoreHouse 4 SH4book.dll
Подробный разбор проблемы и ее решение доступен по ссылке.