Выгрузка данных сотрудника во внешние системы: XML, сетевой каталог и резервное сохранение на компьютере пользователя
При интеграции кадровой системы со сторонними решениями часто возникает простой на первый взгляд сценарий: после приема сотрудника необходимо передать его данные во внешнюю систему — например, SAP, AXAPTA, NAVISION, корпоративный портал или другую учетную систему.
На практике задача быстро становится сложнее.
Выгружать нужно не каждого сотрудника, который появился в информационной базе. Передача должна выполняться только для определенных сотрудников и только тогда, когда кадровик завершил их оформление и данные готовы к отправке.
При этом файл обычно должен попадать в заранее определенный сетевой каталог. Но что делать, если сетевой ресурс в данный момент недоступен?
Предлагаемая внешняя обработка решает именно эту практическую задачу: формирует XML-файл с кадровыми данными выбранного сотрудника, пытается сохранить его в рабочий сетевой каталог, а при недоступности сетевого ресурса позволяет пользователю самостоятельно выбрать папку на своем компьютере.
Для чего предназначена обработка
Обработка предназначена для адресной выгрузки данных сотрудника из кадровой системы во внешний файл установленного формата.
Типовой бизнес-сценарий выглядит следующим образом:
1. Кадровик оформляет прием сотрудника.
2. В карточке заполняются необходимые кадровые и персональные данные.
3. После завершения оформления определяется, требуется ли передача этого сотрудника во внешнюю систему.
4. Для нужного сотрудника запускается команда выгрузки.
5. Обработка получает кадровые данные и формирует XML-файл.
6. Если основной сетевой каталог доступен, файл сохраняется туда автоматически.
7. Если сетевой ресурс недоступен, пользователь получает сообщение и выбирает другой каталог на своем компьютере.
8. Сформированный файл может быть загружен во внешнюю систему, корпоративный портал или передан следующему звену интеграции.
Таким образом, обработка не предназначена для безусловной массовой выгрузки всех сотрудников.
Она рассчитана на управляемый сценарий, при котором кадровик запускает передачу для конкретного сотрудника в нужный момент.
Основная проблема, которую решает обработка
В корпоративных интеграциях часто используется общий сетевой каталог, например:
`\\1c\Принятые`
В него система должна автоматически складывать файлы для последующей обработки сторонним программным обеспечением.
Что выгружается
В текущем варианте обработки формируется XML-файл с данными выбранного сотрудника.
В выгрузку включены:
* ФИО;
* фамилия;
* имя;
* отчество;
* табельный номер;
* дата рождения;
* дата приема;
* должность;
* организация;
* ИНН организации;
* вид документа, удостоверяющего личность;
* серия документа;
* номер документа;
* дата выдачи;
* кем выдан документ;
* код подразделения;
* наименование подразделения;
* КПП подразделения;
* телефон;
* ИНН физического лица;
* страховой номер ПФР;
* серия водительского удостоверения;
* номер водительского удостоверения;
* дата выдачи водительского удостоверения;
* срок действия водительского удостоверения.
Формат XML может быть адаптирован под требования конкретной принимающей стороны.
Например, обработку можно использовать как основу для обмена с:
* SAP;
* AXAPTA;
* NAVISION;
* корпоративным порталом;
* системой управления доступом;
* системой обучения сотрудников;
* внутренней HR-системой;
* системой оформления пропусков;
* другими информационными системами предприятия.
Получателем необязательно должна быть именно одна из перечисленных систем. Главное — наличие согласованного формата обмена.
Пример имени формируемого файла
Имя файла формируется автоматически из кода сотрудника и текущей даты.
Например:
`00000125_09_09_2026.xml`
Такой подход позволяет идентифицировать сотрудника и дату формирования файла без необходимости открывать XML.
При необходимости правило формирования имени легко изменить под требования конкретного интеграционного проекта.
Перед началом сохранения выполняется проверка рабочего каталога.
Если каталог существует и доступен, пользователь сразу получает готовый файл в стандартном расположении.
Если каталог недоступен, обработка выводит сообщение:
> Сетевой каталог недоступен. Выберите каталог для сохранения файла на своем компьютере.
После этого вызывается механизм выбора каталога.
После выбора пользователем папки обработка продолжает выполнение и записывает в нее уже сформированный файл.
Это позволяет сохранить единый сценарий работы и не заставляет кадровика самостоятельно искать временные файлы, копировать их или повторно запускать выгрузку.
Обработка реализована как команда для конкретного выбранного сотрудника.
Кадровик самостоятельно запускает выгрузку в тот момент, когда сотрудник оформлен и по внутреннему бизнес-процессу должен быть передан.
Такой подход дает больше контроля, чем автоматическая отправка каждой вновь созданной карточки.
Регистрация внешней обработки
Обработка регистрируется для справочника сотрудников как дополнительная внешняя обработка.
Назначение:
`Справочник.Сотрудники`
Команда пользователя:
"Выгрузить карточку сотрудника в XML"
Причины купить:
Обработка может использоваться не только как готовое решение для конкретной XML-выгрузки, но и как основа собственного интеграционного проекта (болванка для выгрузки xml файл по кадровым данным сотрудника).
Покупатель получает пример практически востребованной архитектуры:
**выбор сотрудника → получение кадровых данных → формирование файла → временное хранилище → проверка рабочего каталога → сохранение → резервный выбор папки.**
На этой основе можно сравнительно быстро реализовать собственный формат передачи данных.
Преимущества обработки
1. Работа не останавливается из-за недоступности сети
Если стандартный сетевой каталог недоступен, кадровик может сохранить файл локально и продолжить работу.
2. Не требуется вручную указывать каталог при каждой выгрузке
В штатной ситуации файл автоматически сохраняется в заданный сетевой ресурс.
Диалог появляется только тогда, когда основной путь использовать невозможно.
3. Выгрузка запускается для конкретного сотрудника
Обработка не формирует файлы автоматически для всех появившихся в базе сотрудников.
Кадровик контролирует момент выполнения операции.
4. Подходит как основа для различных интеграций
XML-структуру можно изменить под требования внешней системы без необходимости полностью переписывать механизм сохранения и клиент-серверного взаимодействия.
5. Предусмотрена обработка исключительных ситуаций
Ошибки формирования или записи файла не превращаются в непонятное для кадровика падение сценария.
8. Код подготовлен для дальнейшего развития
Вспомогательные процедуры, понятные имена и разделение ответственности позволяют быстрее адаптировать решение под требования конкретного предприятия.
Причина купить:
В реальной интеграционной задаче необходимо одновременно решить несколько вопросов:
* откуда корректно получить кадровые данные;
* где должен выполняться код — на клиенте или сервере;
* как передать сформированный файл между сервером и клиентом;
* как работать с временным хранилищем;
* как сохранить файл на компьютере пользователя;
* как проверить доступность корпоративного ресурса;
* как организовать резервный сценарий;
* как корректно обработать ошибки;
* как зарегистрировать обработку для карточки сотрудника;
* как сделать решение понятным для последующей поддержки.
Покупка готовой обработки позволяет не собирать этот механизм с нуля, а просто добавить в коде необходимые поля.
Решение особенно полезно, если требуется:
* дать заказчику посмотреть основу решения в один клик
* быстро запустить файловый обмен кадровыми данными;
* получить рабочую основу для интеграции;
* адаптировать существующий XML под формат заказчика;
* организовать выгрузку на корпоративный портал;
* отказаться от ручного переноса реквизитов сотрудника;
* сделать сохранение устойчивым к временным проблемам сетевого ресурса.
Возможности адаптации
Обработка может быть доработана под конкретный проект.
Например, можно изменить:
* состав выгружаемых реквизитов;
* структуру XML;
* имя и расширение формируемого файла;
* основной сетевой каталог;
* критерий сотрудников, подлежащих выгрузке;
* перечень обязательных полей;
* проверку полноты кадровых данных;
* способ фиксации факта передачи;
* правила формирования имени файла;
* формат даты;
* кодировку и структуру выходных данных;
* организацию или подразделения, для которых разрешена выгрузка.
XML также может быть заменен другим форматом, если принимающая система этого требует.
Тестирование
Обработка протестирована на следующем окружении:
**Платформа:**
1С:Предприятие 8.3 (8.3.27.1989)
**Конфигурация:**
Зарплата и управление персоналом КОРП, редакция 3
**релиз 3.1.38.92**
Сценарий использования
Практический сценарий может выглядеть так.
Кадровик оформил сотрудника и заполнил требуемые данные.
По правилам предприятия этот сотрудник должен быть передан, например, на корпоративный портал или в SAP.
Из карточки сотрудника запускается команда:
«Выгрузить карточку сотрудника в XML»
Обработка получает кадровые данные и формирует XML.
Если корпоративный каталог доступен, файл автоматически сохраняется туда.
Кадровик получает сообщение:
«Создан файл выгрузки: …»
Если сетевой ресурс недоступен, обработка сообщает об этом и предлагает выбрать другой каталог.
Пользователь указывает локальную папку, после чего сформированный файл сохраняется туда.
То есть кадровый бизнес-процесс может быть завершен даже при временной недоступности сетевого ресурса.
Кому будет полезно
Решение подойдет:
* разработчикам кадровых интеграций;
* специалистам по сопровождению ЗУП;
* компаниям, использующим несколько информационных систем;
* организациям с корпоративным HR-порталом;
* проектам интеграции с SAP, AXAPTA, NAVISION и другими системами;
* специалистам, которым нужен практический пример клиент-серверной работы с файлами;
* разработчикам, которым требуется основа для собственного XML-обмена.
Проверено на следующих конфигурациях и релизах:
- 1С:ERP Управление предприятием 2, релизы 2.6.1.59
- 1С:Комплексная автоматизация 2, релизы 2.6.1.59
- Зарплата и кадры государственного учреждения КОРП, редакция 3, релизы 3.1.38.92
- Зарплата и кадры государственного учреждения, редакция 3, релизы 3.1.38.92
- Зарплата и управление персоналом, редакция 3.1, релизы 3.1.38.92
Вступайте в нашу телеграмм-группу Инфостарт