Настройка интеграции SH4 с 1С

Описание интеграции

Складскую систему "Store House 4" можно связать с бухгалтерской системой - "1С Бухгалтерия". Данный функционал (обработка) приобретается отдельно и защищен лицензионным ключом Guardant. Ниже будут рассмотрены варианты поддерживаемого связкой ПО, общие требования и рекомендации, а также информация по установке и настройке. 

Важно! Перед установкой обработки необходимо знать заранее, какая версия SH4 и какая редакция, платформа, конфигурация 1С установлены на объекте, так как не все версии программных комплексов можно связать между собой!
Важно - 2. Выгружать проводки без указания номенклатурной группы нельзя и дорабатываться этот функционал не будет. 

Таблица версионности ПО и отдельных модулей используемых для выгрузки в "1С", каталоги дистрибутивов (на 25.03.2014)

Установка обработки

Установка складывается из распаковки дистрибутива и копирования файлов в нужные каталоги. Также, в дистрибутиве обработки, как правило идет win-инсталлятор, которым чаще всего пользуются если и 1С и SH4 вместе со своими базами находятся локально на одном ПК.

Сама связка представлена в виде нескольких файлов:

1. Интерфейсная библиотека - SH4book.dll - копируется в каталог с клиентом \SH4\Client
2. После копирования, ее необходимо зарегистрировать в системе. Запустите от администратора:

"Пуск"\"Выполнить" в окне набрать: "regsvr32 <папка в которой установлен клиент Store House>\Sh4book.dll" 

3. Так же необходимо зарегистрировать бибилиотеку midas.dll, которая есть в папке клиента после установки:

"Пуск"\"Выполнить" в окне набрать: "regsvr32 <папка в которой установлен клиент Store House>\Midas.dll" 

4. Файл обработки для 1С - SHto1C.epf  - обычно копируется в каталог установленного клиента 1С или куда угодно, например, в тот же каталог \SH4 или  \SH4\1C, лишь бы путь был покороче, что бы проще было найти и открыть этот файл через 1С. открывается непосредственно через 1С:

Примечание: если при открытии внешней обработки, появляется сообщение "Нарушение прав доступа", то выполните действия пункта ниже.

5. Файл settings.ini - формируется автоматически при первом запуске обработки, в том же каталоге, где находится и SHto1C.epf. В нем будут содержаться настройки используемых при работе с обработкой фильтров и среды.
6. Файл 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 на некорректный, то соответсвие документов в базах будет нарушено!

Разрешение открытия внешней обработки

Если при открытии внешней обработки или отчёта через меню Файл->Открыть

появляется ошибка "Нарушение прав доступа": "Нарушение прав доступа",

то сделайте следующее:

1. Зайдите в конфигуратор базы:
   
2. Выполните команду меню "Администрирование" > "Пользователи":
   
3. Двойным щелчком откройте своего пользователя:
   
4. Перейдите на закладку "Прочие", установите галку "Интерактивное открытие внешних отчетов и обработок" и нажмите "ОК":
   
5. Теперь закройте конфигуратор и базу (если она у вас была открыта).
6. Вновь зайдите в базу и попытайтесь открыть отчёт через меню "Файл"->"Открыть".

Несколько баз 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

 - второй экземпляр и т.д. 

Лицензирование

Библиотека SH4book.dll защищена ключем Gurdant. Для использования выгрузки нужно получить физический ключ. На сервере лицензирования лицензия называется R-Keeper модуль Выгрузка из SHV4 в 1CV8 ПО.

Обработка будет запускаться и работать только компьютере, к которому подключен лицензионный ключ. 

Изменения в установке обработки для 1С, редакция 3.0

1. С версии обработки 6.08 для 1С редакции 3.0, файлы keys.num и settings.ini более не требуются. Как уже писалось выше, в одну базу 1С можно выгружать данные из нескольких баз SH4 (по организациям).
2. Для каждой базы SH будут созданы и сохранены отдельные настройки, что позволит избежать "перезатирания" данных. Для этих целей при первом запуске загрузки в базах (и 1C и SH4) прописываются дополнительные реквизиты сопоставления.
3. Так как необходимо вносить изменения в настройки 1С, то предварительно нужно включить разрешение на изменение параметров:
   
4. далее:
   
5. Выставьте флаг и нажмите [ОК] для сохранения настроек 1С. В открывшемся окне введите код базы SH, который будет использоваться в дальнейшем для синхронизации баз данных SH и 1С. Код может содержать как буквы так и цифры (описывалось выше при пояснении назначения файла keys.num). 
   Примечание: указываемый код базы в этом поле - не более двух символов!
6. Нажмите [Сохранить] для сохранения введенных настроек. Для отказа от сохранения настроек нажмите [Закрыть без сохранения]:
   

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

• После сохранения данных настроек в базе SH будет создан "Дополнительный атрибут корреспондентов". И в пункте "Сервис"\"Собственные реквизиты" будет определен код для сопоставления элементов:

- а так же:

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

• Следующим шагом, необходимо сопоставить валюты.
• Выберите валюту из базы 1С, сопоставив ее с валютой SH4.
• Для сохранения внесенных изменений нажмите кнопку [Сохранить и закрыть]. 
• Если необходимо отказаться от сохранения внесенных настроек, нажмите кнопку [Закрыть без сохранения]:

• Остальные настройки выполняется самим пользователем, согласно прилагаемому руководству пользователя.

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

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