Свой тип инфоблока в 1С-Битрикс: чек-лист перед продом

Почему инфоблок ломается не в админке, а после запуска

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

Ниже — практический чек-лист для проекта на ветке 1С-Битрикс: Управление сайтом 24.x. Он подходит для каталога, новостей, справочника или кастомной сущности, которую вы создаёте через административную панель. Цель — проверить не сам факт создания инфоблока, а его поведение в коде, импорте, правах и продакшене.

В продакшен переносится не «инфоблок из админки», а контракт: тип, коды, свойства, значения, права и правила обмена.

Инфоблок — сущность 1С-Битрикс для хранения однотипных элементов: товаров, статей, объектов каталога или записей справочника. У него есть тип, сам инфоблок, разделы, элементы и свойства.

1. Зафиксируйте схему до кликов в админке

Сначала составьте таблицу полей. Для каждого значения запишите не только название, но и его роль в бизнес-логике. Название «Статус» без уточнения почти гарантирует проблемы: это список для редактора, строка из внешней системы или системное значение, которое нельзя менять вручную.

• Название поля для интерфейса.
• Символьный код, который будут использовать шаблоны, компоненты и импорт.
• Тип значения: строка, число, список, файл, привязка к элементу или разделу.
• Обязательность и множественность.
• Источник значения: редактор, импорт, внешний API или вычисление.
• Правило удаления и изменения значения.

Коды делайте короткими, стабильными и понятными разработчику: BRAND, COLOR, DELIVERY_DAYS. Не используйте в кодах пробелы, русские буквы и привязку к текущей маркетинговой формулировке. Подпись свойства можно изменить без миграции, символьный код — уже часть интеграционного контракта.

2. Проверьте тип инфоблока и сам инфоблок

В административной части разделы «Типы инфоблоков» и «Инфоблоки» решают разные задачи. Тип группирует инфоблоки и влияет на структуру административного интерфейса и выбор сущности в компонентах. Сам инфоблок хранит элементы, разделы, свойства и настройки конкретного набора данных.

1. Создайте или выберите тип. Проверьте его символьный код и публичное название. Код должен быть уникальным в проекте и не меняться после первой загрузки данных. Проверка: тип находится в списке, а его код совпадает с согласованной схемой.
2. Создайте инфоблок внутри нужного типа. Задайте имя, код и, если нужны разделы, включите их поддержку. Проверка: инфоблок виден в административном списке именно в нужной группе.
3. Определите правила URL. Если элементы участвуют в ЧПУ, заранее зафиксируйте шаблоны URL и символьные коды элементов. Проверка: тестовый элемент получает ожидаемый адрес, а изменение заголовка не приводит к неожиданной смене URL.
4. Настройте поля элемента. Оставьте только те системные поля и вкладки, которые нужны редактору. Проверка: контент-менеджер видит форму без технических полей, которые может случайно изменить.

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

3. Выберите свойства так, чтобы их можно было поддерживать

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

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

Для значения, которое повторяется в нескольких инфоблоках, чаще безопаснее использовать справочник. Так вы меняете подпись в одном месте и не получаете несколько вариантов «Синий», «синий» и «blue». Если справочник нужен только одному небольшому инфоблоку и набор почти не меняется, список может быть проще.

4. Проверьте коды и значения на тестовых данных

Символьные коды

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

• Код свойства не совпадает с кодом другого свойства в этом инфоблоке.
• Код элемента не зависит от заголовка, если его используют интеграции.
• Значение списка проверяется по выбранному варианту, а не по отображаемому тексту.
• Файл открывается с нужными правами и не превращается в битую ссылку после переноса.
• Привязка не ведёт на удалённый или недоступный элемент.

Если обмен с 1С или внешним сервисом использует XML_ID, проверьте его отдельно. Символьный код и внешний идентификатор — разные поля и разные контракты. Не подменяйте одно другим только потому, что оба выглядят как строки.

5. Проверьте права и редакторский сценарий

Тестируйте не под учётной записью администратора. Создайте или используйте роль контент-менеджера и пройдите полный сценарий: открыть список, создать элемент, изменить свойство, загрузить файл, отправить на модерацию и удалить тестовые данные.

1. У пользователя есть доступ к нужному типу инфоблока и самому инфоблоку.
2. Пользователь может редактировать только разрешённые поля и разделы.
3. Форма не показывает обязательные поля, которые редактор не может заполнить.
4. Сохранение без обязательного значения даёт понятную ошибку.
5. Публикация и снятие с публикации работают без прав администратора.

Проверьте права на файлы и разделы отдельно. Доступ к элементу не означает автоматически доступ к файлу, который привязан к его свойству.

6. Проверьте код, компоненты и импорт

Найдите по проекту все обращения к новому инфоблоку и свойствам. В выборках должны использоваться стабильные идентификаторы и коды, а не случайный ID, который отличается на тестовом и боевом стенде. Если проект использует компоненты Bitrix, проверьте настройки компонента, шаблон и фильтр на пустых значениях.

• Список элементов не исчезает, если необязательное свойство пустое.
• Фильтр по числовому свойству не сравнивает число как текст.
• Множественные значения выводятся без дубликатов и лишних разделителей.
• Карточка элемента не падает при удалённой привязке.
• Импорт повторного запуска не создаёт копии элементов.
• Обновление существующего элемента идёт по согласованному идентификатору.

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

Что чаще всего ломается перед релизом

Где подход ломается

Не пытайтесь решить все задачи свойствами инфоблока. Сложные связи, история изменений, поиск по большим объёмам данных и транзакционный обмен могут потребовать отдельной модели, высокоуровневого API или специализированного решения. Инвалидация кеша и настройка индексации — отдельные темы: здесь достаточно убедиться, что после публикации новый элемент появляется там, где его должен видеть пользователь.

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

Что сделать перед следующим релизом

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

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