Выгрузка кадровых данных (регламентная/руками) В DBF, XLSX, XML И TXT

ВЫГРУЗКА КАДРОВЫХ ДАННЫХ В DBF, XLSX, XML И TXT

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

Обработка формирует три отдельных набора данных:

• Staff_1C — основные кадровые и персональные сведения сотрудников;
• Post_1C — сведения о должностях, подразделениях и периодах работы;
• Tarif_1c — сведения о тарифной ставке, рабочей неделе и должности.

Поддерживается выгрузка в четыре формата:

• DBF
• XLSX
• XML
• TXT

Один и тот же состав данных может быть выгружен в выбранный пользователем формат без изменения логики получения кадровой информации.

ЧТО УМЕЕТ ОБРАБОТКА

Обработка позволяет:

• выбрать организации, сотрудники которых должны попасть в выгрузку;
• указать каталог для формирования файлов;
• выбрать формат выгрузки: DBF, XLSX, XML или TXT;
• сохранить настройки для последующего использования;
• очистить существующие DBF-файлы перед формированием новой выгрузки;
• получить три логически разделенных файла с кадровой информацией;
• использовать одинаковые имена полей во всех поддерживаемых форматах;
• запускать выгрузку непосредственно из формы настроек;
• использовать обработку как основу для дальнейшей интеграции с внешними системами.

ВЫГРУЗКА ТОЛЬКО ПО ВЫБРАННЫМ ОРГАНИЗАЦИЯМ

Список организаций задается непосредственно в настройках обработки.

При формировании данных используются сотрудники только выбранных организаций.

Организации не требуется дополнительно поддерживать в отдельном макете сопоставления. Для определения организации используется сама организация информационной базы и ее код.

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

СОХРАНЕНИЕ НАСТРОЕК

Обработка сохраняет параметры выгрузки, в том числе:

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

После повторного открытия формы можно продолжить работу с ранее выбранными параметрами.

При нажатии кнопки выгрузки используются именно текущие параметры формы.

ПОДДЕРЖИВАЕМЫЕ ФОРМАТЫ

DBF

Исходный формат обмена.

Файлы создаются через механизм XBase.

Сохраняются типы, длины и точность полей DBF.

Для DBF предусмотрен режим очистки существующего файла перед новой выгрузкой.

Если очистка отключена, данные могут добавляться в существующий DBF-файл.

XLSX

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

Файл формируется штатными средствами платформы через ТабличныйДокумент.

COM-соединение с Microsoft Excel не используется.

Установленный Microsoft Excel на сервере для формирования XLSX не требуется.

Первая строка содержит имена полей.

Каждая последующая строка соответствует записи выгрузки.

XML

Формируется структурированный XML-файл в кодировке UTF-8.

Общая структура имеет следующий вид:

<Export>
    <Rows>
        <Row>
            <ИМЯПОЛЯ>Значение</ИМЯПОЛЯ>
            ...
        </Row>
    </Rows>
</Export>

Имена XML-элементов соответствуют именам полей исходной DBF-структуры.

Формат удобен для интеграции с внешними информационными системами, веб-сервисами и собственными загрузчиками.

TXT

Формируется текстовый файл UTF-8.

В первой строке записываются имена полей.

Разделителем колонок является символ табуляции TAB.

TXT можно использовать для дальнейшей автоматической обработки, импорта в другие системы или открытия в табличных редакторах.

ПРЕИМУЩЕСТВА ОБРАБОТКИ

1. Четыре формата одной выгрузки

Не требуется делать отдельную обработку для Excel, XML или TXT.

Кадровые данные формируются один раз, после чего записываются в выбранный формат.

2. Единая структура полей

Названия и последовательность полей сохраняются между форматами.

Это упрощает интеграцию: внешний загрузчик может работать с одинаковой логической структурой независимо от выбранного типа файла.

3. Разделение данных на логические наборы

Вместо одного большого файла создаются три специализированных набора:

Staff_1C
Post_1C
Tarif_1c

Такую структуру проще использовать при обмене с внешними кадровыми, учетными и корпоративными системами.

4. Выбор организаций

Не нужно выгружать сотрудников всей информационной базы.

Пользователь самостоятельно определяет организации, которые должны попасть в выгрузку.

5. Сохранение параметров

После первоначальной настройки обработку можно использовать повторно без постоянного заполнения одних и тех же параметров.

6. XLSX без COM

Для формирования Excel-файла не используется автоматизация Microsoft Excel через COM.

Это уменьшает зависимость обработки от программного обеспечения, установленного на сервере.

7. Подробно прокомментированный код

Основные участки обработки снабжены комментариями.

Логика получения данных отделена от логики записи файлов.

Это существенно облегчает сопровождение и дальнейшую адаптацию обработки под конкретный проект.

8. Удобная основа для интеграции

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

Например, можно:

• изменить состав выгружаемых полей;
• изменить названия колонок;
• добавить собственные реквизиты сотрудников;
• изменить правила формирования табельного номера;
• изменить правила определения подразделений;
• добавить собственные коды организаций;
• изменить структуру XML;
• изменить разделитель TXT;
• формировать CSV;
• добавить дополнительные таблицы;
• изменить правила выгрузки оклада;
• добавить историю кадровых изменений;
• добавить дополнительные отборы;
• реализовать иной формат обмена.

ПОЧЕМУ ОБРАБОТКА МОЖЕТ БЫТЬ ПОЛЕЗНА

Типовая задача интеграции часто начинается с простого требования:

«Нужно выгрузить сотрудников».

На практике быстро появляются дополнительные условия:

• нужны только определенные организации;
• принимающая система ожидает строго определенные имена полей;
• одной системе нужен DBF, другой — XML;
• пользователю нужен Excel для проверки результата;
• разработчику нужен TXT для автоматического импорта;
• необходимо сохранить старую структуру DBF и одновременно предоставить современные форматы.

В этой обработке эти задачи уже объединены в одном механизме.

Покупателю не требуется создавать четыре отдельных выгрузки и поддерживать четыре разных варианта бизнес-логики.

КОМУ ПОДОЙДЕТ

Обработка может быть полезна:

• специалистам и программистам, выполняющим интеграцию кадровой системы со сторонним программным обеспечением;
• организациям, использующим внешние системы учета персонала;
• компаниям с несколькими организациями и филиалами;
• разработчикам, которым нужна готовая основа кадровой выгрузки;
• специалистам, которым необходимо регулярно получать кадровые данные в Excel;
• организациям, продолжающим использовать обмен через DBF;
• проектам, переходящим с DBF на XML, XLSX или текстовые форматы.

КАК РАБОТАЕТ ВЫГРУЗКА

1. Пользователь открывает настройки обработки.

2. Выбирает организации.

3. Указывает каталог выгрузки.

4. Выбирает необходимый формат:

DBF
XLSX
XML
TXT

5. При необходимости устанавливает режим очистки существующих файлов.

6. Нажимает кнопку «Выгрузить».

7. Обработка получает список сотрудников выбранных организаций.

8. Формируются кадровые и персональные сведения сотрудников.

9. Отдельно формируются данные о должностях и подразделениях.

10. Отдельно формируются сведения о тарифных ставках.

11. В указанном каталоге создаются три файла выбранного формата.

Например, при выборе XLSX:

Staff_1C.xlsx
Post_1C.xlsx
Tarif_1c.xlsx

При выборе XML:

Staff_1C.xml
Post_1C.xml
Tarif_1c.xml

При выборе TXT:

Staff_1C.txt
Post_1C.txt
Tarif_1c.txt

При выборе DBF:

Staff_1C.dbf
Post_1C.dbf
Tarif_1c.dbf

ВАЖНО ПЕРЕД ИСПОЛЬЗОВАНИЕМ

В текущей реализации код выбранной организации используется при формировании COMPCODE и табельного номера.

Поэтому рекомендуется проверить заполнение поля «Код» у организаций.

Код организации, используемый текущим алгоритмом, должен иметь значение, подходящее для принятой у покупателя схемы обмена.

Если во внешней системе используется отдельный код юридического лица, отличный от кода организации информационной базы, механизм можно адаптировать под конкретные требования.

ФОРМАТ ВЫГРУЗКИ И СОСТАВ ПОЛЕЙ

1. STAFF_1C — ОСНОВНЫЕ ДАННЫЕ СОТРУДНИКОВ

Содержит 43 поля:

LASTNAME — фамилия;
PATRONYMIC — отчество;
FIRSTNAME — имя;
BIRTHDATE — дата рождения;
DISMDATE — дата увольнения;
IDENTNUM — табельный номер;
POLICY — страховой номер / СНИЛС;
TAXNUM — ИНН;
PSEUDO — псевдоним сотрудника;
SEX — пол;
CITIZEN — код гражданства;
BRCOUNTRY — страна рождения;
BRREGION — регион рождения;
BRDISTRICT — район рождения;
BRPLACE — населенный пункт / место рождения;
COMPCODE — код организации;
ZONE — подразделение / зона;
POST — должность;
CATEGORY — категория;
DRAWDATE — дата приема;
RECDATE — дата приема / регистрации;
DOCTYPE — вид документа;
DOCSERIES — серия документа;
DOCNUMBER — номер документа;
DOCDATE — дата выдачи документа;
DOCAUTHOR — кем выдан документ;
POSTCODE — почтовый индекс;
REGIONCODE — код региона;
ADDRESS — адрес регистрации;
ADDRREAL — адрес фактического проживания;
PHONE — телефон;
CHILDS — количество детей;
LABORDATE — дата начала трудовой деятельности в рамках используемой логики;
DISMCAUSE — причина увольнения;
EDUCATION — образование;
NATURLNAME — дополнительное поле исходного формата;
VMAIN — служебный признак;
ESN — служебный признак;
DIVCODE — код подразделения;
PENSIONER — признак пенсионера;
BANKACCNT — банковский / лицевой счет;
RSDATE — дата, связанная с лицевым счетом;
TEMPIDENT — временный табельный номер.

Некоторые поля сохранены для совместимости с первоначальной DBF-структурой и в базовом варианте могут заполняться фиксированным или пустым значением.

Это сделано намеренно, чтобы структура файла оставалась совместимой с исходным форматом обмена.

2. POST_1C — ДОЛЖНОСТИ И ПОДРАЗДЕЛЕНИЯ

Содержит 7 полей:

IDENTNUM — табельный номер сотрудника;
BEGDATE — дата начала;
ENDDATE — дата окончания;
ZONE — подразделение / зона;
POST — должность;
CATEGORY — категория;
DIVCODE — код подразделения.

Набор предназначен для передачи информации о текущем месте работы, должности и подразделении сотрудника.

3. TARIF_1C — ТАРИФНЫЕ ДАННЫЕ

Содержит 6 полей:

IDENTNUM — табельный номер сотрудника;
BEGDATE — дата начала действия;
ENDDATE — дата окончания действия;
WAGE — текущая тарифная ставка;
WORKWEEK — количество рабочих дней в неделе согласно графику работы;
POST — должность.

ИТОГО

Обработка формирует три таблицы:

Staff_1C — 43 поля;
Post_1C — 7 полей;
Tarif_1c — 6 полей.

Всего используется 56 описаний полей.

Каждый набор может быть сформирован в одном из четырех форматов:

DBF
XLSX
XML
TXT

ДОРАБОТКА ПОД ТРЕБОВАНИЯ ПОКУПАТЕЛЯ

Представленная структура является базовым вариантом выгрузки.

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

При необходимости обработку можно адаптировать под требования конкретной организации или принимающей информационной системы.

В рамках консультации или технической поддержки можно обсудить и реализовать, например:

• добавление или удаление полей;
• изменение имен полей;
• изменение порядка колонок;
• добавление дополнительных кадровых реквизитов;
• изменение правил определения организации;
• использование отдельного внешнего кода организации;
• изменение алгоритма формирования табельного номера;
• изменение структуры Staff_1C, Post_1C или Tarif_1c;
• добавление новых файлов выгрузки;
• изменение XML-структуры;
• изменение формата TXT;
• добавление CSV или другого текстового формата;
• дополнительные отборы сотрудников;
• дополнительные настройки пользователя;
• адаптацию под требования конкретной принимающей системы.

Перед покупкой или после приобретения можно предварительно обсудить требуемый формат обмена и оценить необходимый объем изменений.

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

протестировано  на платформе 1С:Предприятие 8.3 (8.3.27.1989), ЗУП КОРП 3.1.38.92