Навигатор по разделу:

1. Общие сведения

Avanpost IDM обеспечивает получение кадровых данных и кадровых событий из информационной базы системы 1С "Зарплата и управление персоналом" (далее – 1С ЗУП) редакций версий 2.5 и 3.0 и выше.
Основное назначение интеграции:

• централизованный учет персонала;
• управление доступом сотрудников на основе кадровых событий.

Коннектор Avanpost IDM к 1С ЗУП поддерживает следующие возможности конфигурации:

• указание точки подключения;
• ограничение принимаемых IDM кадровых данных.

1.1. Поддерживаемые функции

Кадровый коннектор Avanpost IDM к 1С ЗУП по запросу модуля синхронизации с доверенным источником данных позволяет получить список должностей, иерархическую структуру организаций и подразделений, список сотрудников: 

• Список организаций со следующими атрибутами:
  • Уникальный идентификатор организации;
  • Наименование организации;
  • Уникальный идентификатор родительской организации;
  • Уникальный идентификатор руководителя организации;7.1. 1С Зарплата и управление персоналом ред. 2.5/3.0
  • Код организации.
• Список подразделений со следующими атрибутами:
  • Уникальный идентификатор подразделения;
  • Наименование подразделения;
  • Код подразделения.
  • Уникальный идентификатор родительского подразделения;
  • Уникальный идентификатор руководителя подразделения;
• Список должностей со следующими атрибутами:
  • Уникальный идентификатор должности;
  • Наименование должности.
• Список сотрудников со следующими атрибутами:
  • Текущие ФИО;
  • Уникальный идентификатор текущей должности;
  • Уникальный идентификатор текущего подразделения;
  • Табельный номер;
  • Дата рождения;
  • Пол;
  • E-mail (при наличии);
  • Статус сотрудника (работает/уволен/в отпуске).
• Конкретное подразделение с его атрибутами по его уникальному идентификатору.
• Конкретного сотрудника с его атрибутами по его уникальному идентификатору.

1.3. Предварительные условия

Требуется установленный веб-сервер (Apache, IIS или др.) для публикации HTTP-сервиса (расширения).

Требуется сетевой доступ с сервера, на котором функционирует Avanpost IDM, на веб-сервер, на котором будет размещен HTTP-сервис 1С ЗУП.

1.4. Используемые библиотеки

• Avanpost.HR.DataSources.V8x1C.Http.Standard.dll (библиотека Avanpost IDM)

2. Порядок установки и настройки подключения

Для установки подключения через коннектор к информационной базе кадровой системы 1С ЗУП редакций 2,5 и 3.0 необходимо:

1. Установить и запустить веб-сервер.
2. Настроить и опубликовать на веб-сервере HTTP-сервис (расширение) в 1С ЗУП для платформы Avanpost IDM.
3. Установить коннектор и настроить интеграцию с 1С ЗУП на сервере Avanpost IDM.

3. Установка и запуск веб-сервера на примере IIS 

Установку и запуск IIS необходимо выполнить, если в качестве веб-сервера предполагается использовать IIS. Для этого требуется выполнить шаги:

Шаг 3.1. Установить компоненты IIS.

Для этого необходимо открыть "Панель управления" → "Программы" → "Программы и компоненты" → "Включение или отключение компонентов Windows" → "Службы IIS" → (выбрать все).

Шаг 3.2. Запустить IIS.

Для этого необходимо открыть: "Панель управления" → "Все элементы панели управления" → "Администрирование" → "Диспетчер служб IIS".

Для настройки требуется выбрать пункт "Просмотреть пулы приложений", щёлкнуть ПКМ на "DefaultAppPool" и выбрать "Дополнительные параметры". В группе "Общие" у пункта "Разрешены 32-разрядные приложения" поставить значение "True".

4. Настройка веб-сервиса для 1С

Для добавления и настройки веб-сервиса (расширения) в конфигурации 1С требуется выполнить шаги:

Шаг 4.1. Загрузить конфигурацию из файла расширения.

Для этого необходимо:

1. Открыть приложение 1С: Конфигуратор от имени администратора ОС под пользователем с полными правами.
   
   Рисунок – Меню "Пуск" ОС. Запуск приложения
2. В главном меню выбрать пункт "Конфигурация" → "Расширения конфигурации".
   
   Рисунок – Главное меню 1С Конфигуратор. Подменю "Конфигурация"
3. В открывшемся окне нажать кнопку "Добавить". Откроется окно "Новое расширение конфигурации", в котором требуется заполнить поля свойств (либо оставить значения по умолчанию) и нажать "ОК".
   
   Рисунок – Окно "Новое расширение конфигурации"
4. В окне "Расширения конфигурации" появится строка нового расширения. Необходимо убрать отметку в чекбоксах "Безопасный режим", "Защита от опасных действий" и "Использовать основные роли для всех пользователей".
   
   Рисунок – Окно "Расширения конфигурации". Добавлено расширение.
5. Выделить строку нового расширения в списке расширений и в меню окна "Расширения конфигурации" перейти к пункту "Конфигурация" → "Загрузить конфигурацию из файла...".
   
   Рисунок – Окно "Расширения конфигурации". Подменю "Конфигурация"
6. В диалоговом окне выбора открыть предоставленный файл с расширением имени ".cfe".
7. В окне предупреждения о замене данных в текущей конфигурации на загружаемую конфигурацию ответить "Да".
   
   Рисунок – Окно предупреждения о замене данных в текущей конфигурации
8. После загрузки конфигурации из файла расширения появится окно с предложением обновления конфигурации базы данных. Требуется нажать кнопку "Нет".
   
   Рисунок – Окно с предложением обновления конфигурации базы данных

Шаг 4.2. Настроить свойства расширения

Перед обновлением конфигурации БД необходимо убедиться в том, что свойства расширения имеют значения, совместимые со свойствами конфигурации. Для этого требуется выполнить следующие действия:

1. В главном меню выбрать пункт "Конфигурация" → "Открыть конфигурацию". Если конфигурация уже открыта, пункт меню будет неактивен.
   
   Рисунок – Главное меню 1С Конфигуратор. Подменю "Конфигурация"
2. В окне "Конфигурация" щелкнуть ПКМ по корневому узлу с названием конфигурации и в контекстном меню выбирать пункт "Свойства".
   
   Рисунок – Окно "Конфигурация". Контекстное меню для узла конфигурации
3. В открывшемся окне свойств в блоке "Совместимость" запомнить состав свойств конфигурации и соответствующие им значения, приведенные на рисунке ниже (например, сделать снимок экрана).
   Рисунок – Окно свойств конфигурации 1С. Блок "Совместимость"
4. В окне "Расширения конфигурации", открывшемся при загрузке, щелкнуть ПКМ по узлу с названием "IDMv7" и в контекстном меню выбрать пункт "Свойства".
   
   Рисунок – Окно свойств расширения. Блок "Совместимость"
5. Привести значения свойств расширения конфигурации к значениям свойств конфигурации 1С (см. пункт 3 шага 4.2).
6. В примере требуется отметить чекбокс напротив свойства "Режим совместимости" слева, после чего в поле значения справа выбрать из выпадающего списка "Версия 8.3.24".
   
   Рисунок – Окно свойств расширения. Блок "Совместимость". Редактирование свойства "Режим совместимости"

Шаг 4.3. Обновить конфигурацию базы данных 

Для этого необходимо запустить вручную обновление базы данных, выбрав в главном меню пункт "Конфигурация" → "Обновить конфигурацию базы данных".

Рисунок – Главное меню 1С Конфигуратор. Подменю "Конфигурация"

4.3.1. Исправление ошибок при обновлении конфигурации БД

При обновлении конфигурации БД могут возникнуть проблемы, что выражается в появлении окон с ошибками.

Рисунок – Ошибка "Обнаружены проблемы при применении расширения конфигурации"

В ряде случаев можно выполнить автоматическое исправление ошибок. Для этого требуется:

1. В окне "Проверка невозможности применения" в строке расширения, которое связано с ошибкой, в столбце "Действие" щелкнуть мышью по ссылке "Исправить" и выбрать нужное действие.
   Например, при несовпадении языков в конфигурации и расширении необходимо выбрать пункт "Выбрать соответствие". После чего в окне "Выбор соответствия" в списке значений выделить нужный язык и нажать "ОК". 
   
   Рисунок – Окно "Проверка невозможности применения". Контекстное меню вариантов исправления ошибки
   
   Рисунок – Окно "Выбор соответствия"
2. Повторно запустить обновление конфигурации базы данных (см. шаг 4.3).
3. При успешном разрешении ошибок появится окно с информацией о реорганизации информации. Нажать кнопку "Принять".

Шаг 4.4. Публикация HTTP-сервиса в 1С ЗУП на веб-сервере

Чтобы получить доступ к кадровым данным 1С, необходимо опубликовать HTTP-сервис. Для этого требуется:

1. Запустить 1С с правами администратора;
2. Открыть конфигуратор 1С для базы, из которой будет публиковаться HTTP-сервис;
3. В главном меню конфигуратора 1С выбрать "Администрирование" → "Публикация на веб-сервере";
   
   Рисунок – Главное меню 1С Конфигуратор. Подменю "Администрирование"

4. В открывшемся окне "Публикация на веб-сервере" на вкладке "Основные" заполнить следующие поля: 

   Поле	Значение
   Имя	Указать имя информационной базы
   Веб-сервер	Выбрать из выпадающего списка название и версию задействованного веб-сервера
   Каталог	Указать каталог публикации веб-сервиса

5. Отметить чекбоксы "Публиковать доступ для клиентских приложений" и "Публиковать HTTP-сервисы расширений по умолчанию";
   
   Рисунок – Окно "Публикация на веб-сервере"
6. Нажать кнопку "Опубликовать".

Шаг 4.5. Проверка рабочего состояния опубликованного HTTP-сервиса 

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

1. В веб-браузере в адресной строке ввести URL-адрес публикации HTTP-сервиса в формате:
   Формат URL-адреса

   http://[Адрес веб-сервера]:[Номер порта веб-сервера]/[Имя информационной базы]

2. Убедиться, что на странице появилась структурированная информация по штатной структуре организаций и подразделений из 1С ЗУП.
3. Для проверки работы методов HTTP-сервера в адресной строке браузера ввести URL с указанием шаблона (имени метода и параметров) в формате:
   Формат URL-адреса с указанием шаблона

   http://[Адрес веб-сервера]:[Номер порта веб-сервера]/[Имя информационной базы]/hs/[Корневой URL]/[Шаблон]

   Шаблон	Описание
   /positions	Должности
   /divisions/all	Все подразделения
   /divisions/root	Корневые подразделения
   /divisions/{id}	Подразделение, определяемое идентификатором id
   /divisions/{id}/sub	Подразделения, подчиненные подразделению под идентификатором id
   /divisions/{id}/employees	Сотрудники подразделения под идентификатором id
   /employees/all	Все сотрудники
   /employees/{id}	Сотрудник, определяемый идентификатором id

   Пример строки проверки метода получения данных всех сотрудников

   http://localhost:8080/MainOrganization/hs/idmsync/employees/all

   В запросах и ответах HTTP-методов используется заголовок (Content-Type) в формате application/json. Успешный ответ на запрос имеет код 200, ошибка – 500.

5. Настройка интеграции в Avanpost IDM

Для настройки интеграции необходимо выполнить шаги:

Шаг 5.1. Поместить библиотеку коннектора в директорию "/opt/avanpost/connectors" или на удаленный сервис коннекторов.

Шаг 5.2. Добавить новый источник кадровых событий в Avanpost IDM.

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

1. Нажать кнопку  в разделе "Интеграции"→"Кадровые системы" веб-интерфейса администратора Avanpost IDM.
2. Из выпадающего списка выбрать тип источника "Кадровый".
3. Заполнить поля в открывшейся форме:

   Поле	Значение
   Название	Произвольное название источника.
   Библиотека коннекторов	Выбрать из выпадающего списка библиотеку коннекторов для подключаемого источника. Примечание: Подробнее про коннекторы см. статью "5.1.5. Настройка сервисов коннекторов".
   Строка подключения	Формат строки подключения Параметры в строке подключения записываются последовательно с указанием передаваемых значений после знака равно (=). Разделителем между параметрами служит точка с запятой (;). url=[URL HTTP-сервиса 1С ЗУП];username=[Техническая учетная запись];password=[Пароль];ignoreSSL=[true или false] Примеры строки подключения Пример стандартной строки подключения url=http://10.100.100.45/InfoBase/hs/idmsync/;username=mow1idm01-avanp-svc;password=******;ignoreSSL=true В строку подключения могут быть добавлены дополнительные параметры, которые будут передаваться в каждом запросе коннектора к HTTP-сервису. Каждый такой параметр должен записываться с префиксом request. Пример записи дополнительных параметров request.orgcodes=124;request.date=11.10.2003; Пример расширенной строки подключения с дополнительными параметрами url=http://10.100.100.45/InfoBase/hs/idmsync/;username=mow1idm01-avanp-svc;password=******;ignoreSSL=true;request.orgcodes=124;request.date=11.10.2003; Обязательные параметры Наименование параметра Описание url URL-адрес HTTP-сервиса, настроенного для синхронизации с кадровой системой 1С ЗУП; username Логин пользователя для аутентификации в HTTP-сервисе (техническая УЗ) с правами, открывающими доступ на методы из HTTP-сервиса; password Пароль пользователя для аутентификации в HTTP-сервисе (техническая УЗ); ignoreSSL Признак игнорирования проверки SSL-сертификатов при подключении к HTTP-сервису. Допустимые значения: true и false.  Опциональные параметры Наименование параметра Описание timeOut Максимальное время ожидания ответа от HTTP-сервиса, в минутах. По умолчанию установлено значение 3. Пример записи параметра: timeOut=4 cachePolicy Политика кеширования передаваемых данных. Допустимые значения: NoCache – кэширование не используется (является значением по умолчанию); SingleSync – синхронизация данных  выполняется единожды: при первом обращении коннектор собирает все соответствующие данные из кадровой системы и кэширует их, при последующих обращениях используются данные, сохранённые в кэше. Кадровая система должна быть настроена для работы в 1 поток. Дополнительные параметры Дополнительные параметры могут использоваться в случае реализации дополнительных доработок HTTP-сервиса по согласованию с заказчиком. Наименование параметра Описание orgcodes Коды организаций, к которым относится кадровая информация. По умолчанию выгружаются все организации. Чтобы ограничить выгрузку нужными организациями, следует в строку подключения добавить данный параметр с перечнем кодов, перечисленных через запятую. В версии 1С ЗУП 2.5+ коды выгружаемых организаций имеют целочисленный формат. Пример: "0000001, 0000002". В версии 1С ЗУП 3.0+ коды организаций записываются в виде GUID. Пример: "42ba10f1-30d4-11e8-af99-4ccc6a0c7543, ebba10f1-30d4-11e8-af99-4ccc6a0c7566". Для получения кодов организаций возможен ручной вызов метода GetAllOrganizations HTTP-сервиса, например, через SoapUI.
   Использовать Vault	Отметить чекбокс для настройки работы защищенного хранилища секретов "Vault". В таком случае Avanpost IDM будет получать данные авторизации для управляемой системы из защищенного хранилища.
   Vault URI	Идентификатор хранилища. По данному URI Avanpost IDM будет запрашивать данные для авторизации. При обращении к нему Avanpost IDM с помощью сертификата установленного в Vault получает токен. Можно указать более одного экземпляра хранилища, разделяя их точкой с запятой. Атрибут активен и требует заполнения только в случае отмеченного чекбокса "Использовать Vault".
   Vault Script	Выбрать необходимый скрипт строковой операции из списка. Данный скрипт должен запрашивать в Vault данные для авторизации в управляемой системе с помощью полученного от Vault токена, и возвращать эти данные для добавления к строке подключения. Атрибут активен и требует заполнения только в случае отмеченного чекбокса "Использовать Vault".

4. Нажать кнопку для сохранения настроек нового источника.

Шаг 5.3. Провести синхронизацию данных с созданным кадровым источником с помощью запланированных заданий.