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

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

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

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

Таблица версионности ПО и отдельных модулей используемых для выгрузки в "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 вместе со своими базами находятся локально на одном ПК.

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

  1. Интерфейсная библиотека - SH4book.dll - копируется в каталог с клиентом \SH4\Client
  2. После копирования, ее необходимо зарегистрировать в системе. Запустите от администратора:
"Пуск"\"Выполнить" в окне набрать: "regsvr32 <папка в которой установлен клиент Store House>\Sh4book.dll" 
  1. Так же необходимо зарегистрировать бибилиотеку midas.dll, которая есть в папке клиента после установки:
"Пуск"\"Выполнить" в окне набрать: "regsvr32 <папка в которой установлен клиент Store House>\Midas.dll" 
  1. Файл обработки для 1С - SHto1C.epf  - обычно копируется в каталог установленного клиента 1С или куда угодно, например, в тот же каталог \SH4 или  \SH4\1C, лишь бы путь был покороче, что бы проще было найти и открыть этот файл через 1С. открывается непосредственно через 1С:

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

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

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

Важно! Если, выгрузку необходимо обновить, то файлы keys.num и settings.ini должны быть сохранены, т.е. обновляется только sh4book.dll и epf-файл!

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

Библиотека 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С.