Работа с дополнительными свойствами

Обновлено: 21.06.2026

Некоторые сущности Timetta поддерживают пользовательские (кастомные) поля.

Это позволяет администраторам расширять стандартную модель данных без изменения структуры системы.

Если сущность поддерживает кастомизацию, это указано в её описании через признак Customizable.

Как это работаетКак это работает

Кастомные поля настраиваются администраторами в интерфейсе системы.

Для каждого поля задаются:

• название;
• тип данных;
• обязательность;
• дополнительные параметры отображения и поведения.

После создания такие поля сразу становятся частью API соответствующей сущности и доступны наравне со стандартными свойствами.

Отдельной публикации или синхронизации не требуется.

Типы кастомных полейТипы кастомных полей

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

Поддерживаются следующие типы:

Каждое кастомное поле привязывается к одному из этих технических свойств.

Использование в APIИспользование в API

Для работы с кастомными полями необходимо использовать Data Field Name, указанный в карточке настройки кастомного поля.

Именно это имя используется в API.

Например, если в настройке поля указано:

Data Field Name: StringValue3

то чтение:

GET https://api.timetta.com/odata/Projects?$select=id,name,StringValue3

И обновление:

PATCH https://api.timetta.com/odata/Projects('45eb27e2-161e-4eeb-9b56-72eaea30511d')
Content-Type: application/json

{
  "StringValue3": "Высокий приоритет"
}

Навигационные пользовательские поляНавигационные пользовательские поля

Некоторые кастомные поля являются ссылочными.

Например:

• LookupValueXId
• UserValueXId

Они работают по тем же правилам, что и обычные навигационные свойства:

• для записи используется идентификатор;
• для чтения можно использовать $expand.

Пример:

GET https://api.timetta.com/odata/Projects?$select=id,name,LookupValue1Id&$expand=LookupValue1($select=id,name)

Важные замечанияВажные замечания

• Названия пользовательских полей могут отличаться между абонентами.
• Используйте именно Data Field Name, а не отображаемое название.
• Доступность конкретных кастомных полей зависит от настроек сущности.
• При изменении конфигурации кастомных полей API-контракт сущности также изменяется.