ecm-administrator-manuals/docs/Admin manuals/Настройка для интеграции с 1С/Описание настроек на стороне 1С/Описание настроек на стороне 1С.md

Описание настроек на стороне 1С

Для отладки обмена данными между системами СЭД и 1C, необходимо предоставить доступ к серверу 1С.
Это должно быть VPN-соединение (обязательно для отладки сервиса загрузки данных из 1С) и дополнительно
подключение через RDP. В случае предоставления доступа по RDP необходимо установить программы:
pgAdmin, Postman, Google Chrome. Также на время тестирования необходимо развернуть копию базы 1С.
К копии базы должен быть доступ со стороны специалистов ООО «Лексема», а также ответственных за внедрение КЭДО специалистов со стороны заказчика.
Во время тестирования осуществляется проверка по всем запланированным к обмену документам с продуктивной базой Lexema-ECM. К запуску пилотного проекта база Lexema-ECM будет очищена от тестовых документов.

Для того, что настроить обмен данными между системами СЭД и 1C по интерфейсам API, необходимо произвести следующие настройки на стороне системы 1С:

1. Опубликовать работу с OData в конфигураторе базы.
   Публикация сервисов OData выполняется из меню Конфигуратора «Администрирование -> Публикация на веб-сервере», флажок «Публиковать стандартный интерфейс OData».
   

2. Создать пользователя, через которого будет осуществляться обмен, с полными правами на выполнение методов get и post.
   

3. Опубликовать в 1с следующие каталоги справочников:
   

• Catalog_ФизическиеЛица
  
• InformationRegister_ФИОФизическихЛиц
• Catalog_ВидыДокументовФизическихЛиц
  
• Catalog_ВидыКонтактнойИнформации
  
• InformationRegister_ДокументыФизическихЛиц
  
• InformationRegister_СклоненияПредставленийОбъектов
  
• Catalog_Сотрудники
  
• InformationRegister_КадроваяИсторияСотрудников
  
• InformationRegister_ВидыЗанятостиСотрудников
  
• Catalog_Должности
  
• Catalog_ПодразделенияОрганизаций
  
• Catalog_Организации
  
• Catalog_ВидыОтпусков
  
• Catalog_Пользователи
  
• Catalog_ИзменениеОплатыТрудаПрисоединенныеФайлы
• Catalog_РаботаВВыходныеИПраздничныеДниПрисоединенныеФайлы
• Catalog_ОтгулПрисоединенныеФайлы
• Catalog_СовмещениеПрисоединенныеФайлы

4. Опубликовать в 1с каталоги документов, обмен которыми планируется осуществлять, например:

• Document_ОтпускБезСохраненияОплаты
• Document_КомандировкиСотрудников
• Document_ТабельУчетаРабочегоВремени
• Document_СправкаНДФЛ
• Document_ПриемНаРаботу
• Document_ПереносОтпуска
• Document_ГрафикОтпусков
• Document_ОтпускПоУходуЗаРебенком
• Document_ВозвратИзОтпускаПоУходуЗаРебенком
• Document_ИзменениеГрафикаРаботыСписком
• Document_МатериальнаяПомощь
• Document_КадровыйПеревод
• Document_ЗаявлениеВФССОВозмещенииРасходовНаПогребение
• Document_ЗаявлениеНаПредоставлениеСтандартныхВычетовПоНДФЛ
• Document_ЗаявлениеСотрудникаНаВыплатуПособия
• Document_ПрогулНеявка
• Document_СправкаНДФЛ
• Document_Командировка
• Document_ОплатаДнейУходаЗаДетьмиИнвалидами
• Document_Увольнение
• Document_ОплатаПоСреднемуЗаработку
• Document_ОтпускБезСохраненияОплаты
• Document_КомандировкиСотрудников
• Document_ТабельУчетаРабочегоВремени
• Document_СправкаНДФЛ
• Document_ПриемНаРаботу
• Document_ПереносОтпуска
• Document_ГрафикОтпусков
• Document_ОтпускПоУходуЗаРебенком
• Document_ВозвратИзОтпускаПоУходуЗаРебенком
• Document_ИзменениеГрафикаРаботыСписком
• Document_МатериальнаяПомощь
• Document_КадровыйПеревод
• Document_ЗаявлениеВФССОВозмещенииРасходовНаПогребение
• Document_ЗаявлениеНаПредоставлениеСтандартныхВычетовПоНДФЛ
• Document_ЗаявлениеСотрудникаНаВыплатуПособия
• Document_ПрогулНеявка
• Document_СправкаНДФЛ
• Document_Командировка
• Document_ОплатаДнейУходаЗаДетьмиИнвалидами
• Document_Увольнение
• Document_ОплатаПоСреднемуЗаработку
• Document_БольничныйЛист
  
• Document_РаботаВВыходныеИПраздничныеДни
• Document_Отгул
• Document_Совмещение
• Document_ИзменениеОплатыТруда
• Document_Увольнение

5. Для обмена файлами необходимо опубликовать следующие сущности:
   

• InformationRegister_ДвоичныеДанныеФайлов – один регистр для всех документов,необходим полный доступ.
  

• Каталоги присоединенных файлов, обмен которыми планируется осуществлять,
  Catalog_НАЗВАНИЕПрисоединенныеФайлы, например:
  

• Catalog_ОтпускПрисоединенныеФайлы

• Catalog_ОтпускБезСохраненияОплатыПрисоединенныеФайлы

• Catalog_КомандировкиСотрудниковПрисоединенныеФайлы

• Catalog_ТабельУчетаРабочегоВремениПрисоединенныеФайлы

• Catalog_СправкаНДФЛПрисоединенныеФайлы

• Catalog_ПриемНаРаботуПрисоединенныеФайлы

• Catalog_ПереносОтпускаПрисоединенныеФайлы

• Catalog_ГрафикОтпусковПрисоединенныеФайлы

• Catalog_ОтпускПоУходуЗаРебенкомПрисоединенныеФайлы

• Catalog_ВозвратИзОтпускаПоУходуЗаРебенкомПрисоединенныеФайлы

• Catalog_ИзменениеГрафикаРаботыСпискомПрисоединенныеФайлы

• Catalog_МатериальнаяПомощьПрисоединенныеФайлы,
  

• Catalog_КадровыйПереводПрисоединенныеФайлы,
  

• Catalog_ЗаявлениеВФССОВозмещенииРасходовНаПогребениеПрисоединенныеФайлы,
  

• Catalog_ЗаявлениеНаПредоставлениеСтандартныхВычетовПоНДФЛПрисоединенныеФайлы,
  

• Catalog_ЗаявлениеСотрудникаНаВыплатуПособияПрисоединенныеФайлы,
  

• Catalog_ПрогулНеявкаПрисоединенныеФайлы,
  

• Catalog_СправкаНДФЛПрисоединенныеФайлы,
  

• Catalog_КомандировкаПрисоединенныеФайлы,
  

• Catalog_ОплатаДнейУходаЗаДетьмиИнвалидамиПрисоединенныеФайлы,
  

• Catalog_УвольнениеПрисоединенныеФайлы,
  

• Catalog_ОплатаПоСреднемуЗаработкуПрисоединенныеФайлы,
  

• Catalog_БольничныйЛистПрисоединенныеФайлы
  

• Catalog_РаботаВВыходныеИПраздничныеДниПрисоединенныеФайлы

• Catalog_ОтгулПрисоединенныеФайлы

• Catalog_СовмещениеПрисоединенныеФайлы

• Catalog_ИзменениеОплатыТрудаПрисоединенныеФайлы

Для тестирования работы протокола (проверить права доступа на чтение сущностей 1С) открываем любой доступный браузер и в адресной строке вводим url согласно шаблона:
http://<имя сервера>:<порт>/<имя публикации>/odata/standard.odata/<имя ресурса><формат полученных данных>

где:

• имя сервера – имя веб-сервера или его ip адрес, так же если веб-сервер установлен на ПК, где вы открыли браузер можно ввести localhost или 127.0.0.1 (например: http://localhost/ или http://server1c/);
  
• порт – порт веб-сервера. Если используется стандартный порт 80, тогда можно не указывать порт (например: http://localhost/smallbusiness/);
  
• имя публикации – имя, которое было указано при публикации в конфигураторе 1С 8 (например: smallbusiness);
  
• имя ресурса – имя одного из получаемых ресурсов метаданных (справочники, документы, регистры и т.п.) с установленными фильтрами (например: Catalog_НАЗВАНИЕ);
  
• формат полученных данных – указываем «?$format=json» для формата json или «?$format=atom» для формата xml.
  

(https://<имя сервера>:<порт>/odata/standard.odata/Catalog_НАЗВАНИЕ?$format=json)
Например:
http://server1c.lex.lan/DemoHRM/odata/standard.odata