Заполнение шаблона

Заполнение шаблона

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

Каждая строка шаблона соответствует одной рабочей записи.

Общие правила заполнения

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

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

Описание колонок шаблона

Колонка

Описание

Формат и ограничения

TaskKey

Ключ задачи. Используется для определения задачи, к которой относится рабочая запись

Максимум 128 символов; обязательное поле. Задача должна существовать в системе.

DateTimeStart

Дата и время начала рабочей записи

ГГГГ-ММ-ДД ЧЧ:ММ:СС (например, 2025-10-28 13:00:00); обязательное поле

Duration

Длительность рабочей записи

Целое положительное число; обязательное поле. Значение указывается в секундах (например, 3600 = 1 час)

Description

Описание или комментарий к рабочей записи

Максимум 1500 символов

UserID

Внутренний идентификатор пользователя

Максимум 64 символа; основной идентификатор пользователя. Если заполнено, остальные поля игнорируются.

UserFullName

Полное имя пользователя

Максимум 121 символ; используется, если в UserID пусто.

IntegrationID

Интеграционный идентификатор рабочей записи

Максимум 64 символа. Должен быть уникальным. При совпадении с существующей записью обновление не произойдет

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

Дополнительные ресурсы:

Табель учёта рабочего времени

Задачи

Проекты

Пользователи