Типы полей

Выберите инструмент для разработки с AI-агентом:

используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

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

textWithTranslation

Текст, который можно передать сразу на нескольких языках.

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

{
    "ru": "Сохранить",
    "en": "Save"
}

Правила для объекта с переводами:

ключи — только языки, установленные в Битрикс24, иначе ошибка WRONG_LANG
значение каждого ключа — строка
объект не должен быть пустым: проверку он пройдет, но в записи окажется пустой текст

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

Тип используется в заголовке записи, тегах и бейджах, текстовых блоках и ссылках, кнопках нижней части, пунктах и разделах меню. Рабочий пример — в разделе Запись на нескольких языках.

scope

Область видимости — на каких устройствах показывать элемент записи.

Значение	Где показывается элемент
поле не передано	Везде
`web`	Только в браузере
`mobile`	Только в мобильном приложении

Поле scope есть у контентных блоков, кнопок нижней части и пунктов меню. У кнопок и пунктов меню Битрикс24 отклонит другое значение с ошибкой ENUM_FIELD, у контентных блоков значение не проверяет.