К основному содержимому

Импорт истории полей

Узнайте, как импортировать историю полей сотрудников (какое значение было у каждого и с какой даты)

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

Некоторые поля сотрудников хранят не только текущее значение, но и всю его историю: какое значение было в поле и с какой даты. В профиле сотрудника такие поля показывают список датированных записей вместо одного значения, например: Junior с января 2023, Middle с апреля 2024, Senior с июля 2026.

Этот импорт позволяет заполнить эту историю массово. Он пригодится, если вы переходите на PeopleForce и хотите перенести прошлые значения. Также он поможет, если вы только начали вести историю для поля и хотите заполнить её задним числом для всех, или если нужно исправить партию записей.

💡 Импортировать можно только поля, отмеченные как Поле с историческими и запланированными изменениями. Отметьте эту опцию в Настройки > Данные о людях при создании или редактировании поля. После этого снять отметку уже нельзя. Поля типа Файл и Расширенное текстовое поле никогда не могут хранить историю.
​

🧾 Подготовьте файл

  1. Скачайте шаблон и используйте его как образец (пример приведён только для ознакомления).

  2. Заполните обязательные поля:

  • Employee ID: ID существующего сотрудника;

Сотрудники определяются только по ID сотрудника. Этот импорт не принимает адреса эл. почты или ФИО. Убедитесь, что у каждого человека из файла в профиле заполнен ID сотрудника.

  • internal_name: внутреннее название поля сотрудника, в котором хранится история

Чтобы найти внутреннее название, перейдите в Настройки > Данные о людях, откройте поле и скопируйте Внутреннее название в верхней части формы. Регистр не важен, но всё остальное должно совпадать в точности. Внутреннее название не меняется, даже если кто-то переименует поле.
​

  • effective_on: дата, с которой действует значение;

  • value: значение, которое было в поле с этой даты;

Что указывать в столбце value

Значение должно соответствовать типу поля, указанного в internal_name:

Тип поля

Что указать

Однострочный текст, Текст в несколько строк

Любой текст

Число

Число. Десятичная запятая читается как точка: 1,5 импортируется как 1.5

Выбор даты

Дату в формате дат вашего аккаунта или в формате YYYY-MM-DD

Выбор одного ответа

Один вариант, написанный точно так же, как в настройках поля

Выбор нескольких ответов

Несколько вариантов через запятую, например Удалённо, Гибридно

Да/Нет

1 или 0

Выбор сотрудника

ID сотрудника или адрес эл. почты сотрудника, на которого ссылается поле

📤 Импорт истории полей в систему

  1. Перейдите в Настройки > Импорт.

  2. Выберите тип импорта История полей.
    ​

  3. Загрузите заполненный файл.

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

  5. Нажмите Далее, чтобы перейти к предпросмотру данных.

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

✅ Система автоматически проверит каждую строку. Ячейки с некорректными данными будут выделены красным. Исправьте их в файле и при необходимости повторите импорт.

Как обновляются существующие записи

Система определяет записи по сочетанию трёх элементов: сотрудника, поля и даты вступления в силу.

  • Если у сотрудника нет записи для этого поля на эту дату, создаётся новая запись.

  • Если запись для того же сотрудника, поля и даты уже существует, обновляется её значение.

  • Сама дата вступления в силу никогда не меняется. Чтобы перенести запись на другую дату, импортируйте новую строку и удалите старую запись в профиле сотрудника.

  • Импорт никогда не удаляет записи.

📊 Просмотр истории загрузок

  1. Откройте Импорт > История, чтобы просмотреть загрузки.

  2. Проверьте импортированные и обновлённые записи и ошибки.
    ​

  3. Нажмите меню ⋯ > Просмотреть журналы, чтобы увидеть подробные сообщения об ошибках.
    ​

Сообщение об ошибке

Что оно означает

ID сотрудника не существует

Ни у одного сотрудника нет такого ID, или сотрудник архивирован

Поле не существует или для него не ведётся история изменений

Внутреннее название написано с ошибкой, поле не отмечено как Поле с историческими и запланированными изменениями или поле отключено

Дата вступления в силу указана неверно

Не удалось прочитать дату. Используйте формат дат вашего аккаунта или формат YYYY-MM-DD

Значение недопустимо для поля X

Значение не соответствует типу этого поля, или ячейка пустая

Нашли ответ на свой вопрос?