Разработка и Конфигурация · 9 мин
Как правильно назвать объекты в 1С: правила и практические рекомендации
Как правильно назвать конфигурацию, базу, справочники и переменные в 1С: правила именования, ограничения платформы, типичные ошибки и проверка результата.
Вопрос о том, как назвать объект в 1С, возникает в трёх разных ситуациях: при создании информационной базы в списке запуска, при добавлении объектов метаданных в конфигураторе и при написании кода на встроенном языке. Правила для каждого случая различаются, и путаница между ними — частая причина ошибок «Недопустимое имя» или конфликтов при обновлении.
Платформа 1С:Предприятие накладывает жёсткие технические ограничения на идентификаторы, а методические рекомендации вендора добавляют к ним соглашения о стиле. Соблюдение обоих уровней правил делает конфигурацию читаемой, упрощает доработку и снижает риск проблем при обмене данными и обновлении типовых решений.
Ниже разобраны правила именования баз, объектов метаданных, переменных и процедур, а также типичные ошибки и способы проверить результат до того, как неудачное имя разойдётся по обменам и отчётам.
Чем имя отличается от синонима и представления
В конфигураторе у каждого объекта метаданных есть несколько текстовых свойств, которые часто смешивают. Имя — это идентификатор, по которому объект вызывается в коде: оно однострочное, без пробелов, подчиняется правилам платформы. Синоним — пользовательское название, которое видит оператор в интерфейсе: оно может содержать пробелы и любые символы. Представление формируется автоматически из синонима или задаётся отдельно для списков и команд.
Практический вывод: имя меняйте осмысленно и один раз, потому что на него завязывается код, запросы, роли и настройки обмена. Синоним можно корректировать в любой момент — пользователи увидят новое название, а логика не пострадает. Если нужно «переименовать» объект для пользователей, почти всегда правильнее править синоним, а не имя.
Как назвать информационную базу в списке запуска
Название базы в окне запуска (файл ibases.v8i) — это чисто пользовательская подпись, платформа не накладывает на неё технических ограничений. Тем не менее хаотичные названия вроде «База1», «Новая» или «Копия (2)» приводят к тому, что бухгалтер вводит документы не в ту организацию, а копии для тестирования неотличимы от рабочих баз.
Рабочий шаблон названия: Организация — прикладное решение — назначение. Например: «ООО Вектор — Бухгалтерия 3.0 — рабочая» или «ООО Вектор — УТ 11 — тест обмена». Для копий обязательно добавляйте пометку о назначении и, при необходимости, дату создания копии в комментарии к базе, а не в самом имени.
Правила платформы для имён объектов метаданных
При создании справочника, документа, регистра или реквизита конфигуратор проверяет имя по правилам встроенного языка. Нарушение любого из них блокирует сохранение конфигурации.
- Имя должно начинаться с буквы (русской или латинской) либо со знака подчёркивания; начинаться с цифры нельзя.
- Допустимы только буквы, цифры и подчёркивания; пробелы, дефисы, точки и спецсимволы запрещены.
- Имя не должно совпадать с зарезервированными словами языка и именами свойств платформы.
- Регистр букв значения не имеет: «Номенклатура» и «НОМЕНКЛАТУРА» — один идентификатор.
- Длина имени ограничена; на практике держите имена в разумных пределах, чтобы они читались в запросах и коде.
Для неразделённых имён действует и ограничение на уникальность: два объекта одного вида не могут иметь одинаковое имя, а имя реквизита не должно дублировать стандартные реквизиты объекта.
Как выбрать осмысленное имя для справочников, документов и регистров
Имя объекта должно отвечать на вопрос «что это» одним-двумя словами без сокращений, понятных только автору. Справочники называют существительными во множественном или единственном числе по смыслу: «Номенклатура», «Контрагенты», «ДоговорыКонтрагентов». Документы — по сути операции: «РеализацияТоваровУслуг», «ПоступлениеНаРасчетныйСчет». Регистры — по хранимой информации: «ОстаткиНоменклатуры», «КурсыВалют».
Для собственных доработок в типовой конфигурации принято добавлять префикс проекта или компании, например «век_СпецификацияКлиента» или «АБ_ЗаявкаНаДоставку». Префикс защищает от конфликтов при обновлении: если вендор добавит объект с похожим именем, ваш объект не пересечётся с ним. Префикс выбирают коротким — две-четыре буквы — и используют единообразно во всей конфигурации.
Перед тем как завести новый объект, поищите по конфигурации существующие объекты со схожим смыслом. Дубли вроде «Клиенты» рядом с типовым «Контрагенты» создают двойной учёт и ломают отчёты.
Именование переменных, процедур и функций в коде
В коде действует тот же принцип: имя отражает содержимое. Переменные называют существительными («СуммаДокумента», «ВыборкаОстатки»), процедуры — глаголом с объектом действия («ЗаполнитьТабличнуюЧасть», «ПроверитьЗаполнениеРеквизитов»), функции, возвращающие значение, — по возвращаемому результату («ПолучитьКурсВалюты», «ЭтоПолноправныйПользователь»).
Избегайте однобуквенных имён вне коротких циклов, транслитерации вперемешку с русским и английским в одном модуле и сокращений вроде «ТЗ», «Спр» в новых разработках — если конфигурация ведётся на русском, держите единый язык идентификаторов. Смешение стилей затрудняет поиск по коду и автодополнение в редакторе.
Как переименовать объект без потери данных
Переименование объекта метаданных не удаляет данные: таблицы в СУБД привязаны к внутренним идентификаторам, а не к имени. Однако все ссылки на старое имя в коде, запросах, макетах, ролях и внешних обработках станут недействительными. Поэтому переименование делают по процедуре, а не «нажал и забыл».
- 1Сделайте резервную копию базы или выгрузку конфигурации
- 2Выполните глобальный поиск по старому имени во всех модулях, запросах и макетах
- 3Переименуйте объект в конфигураторе и исправьте найденные обращения
- 4Проверьте роли, права, подписки на события и настройки обмена, где объект упоминается
- 5Обновите конфигурацию базы данных и протестируйте ключевые сценарии работы с объектом
Если объект участвует в планах обмена или внешних интеграциях, согласуйте переименование с владельцами смежных систем: для них имя может быть частью контракта обмена, и его смена сломает выгрузку без каких-либо ошибок внутри самой базы.
Как проверить, что имя выбрано правильно
Перед сохранением конфигурации полезно прогнать имя по короткому списку контрольных точек. Это занимает меньше минуты и избавляет от переделок после того, как объект обрастёт кодом и данными.
Как проверить результат
Буква или подчёркивание
Цифра или спецсимвол — платформа отклонит имя
Только буквы, цифры, подчёркивания
Пробелы, дефисы, точки
Коллега без пояснений понимает, что хранит объект
«Объект1», «Новый», «Тест2» без назначения
Единый префикс проекта у всех собственных объектов
Часть объектов с префиксом, часть без
Понятное пользовательское название с пробелами
Синоним дублирует техническое имя с подчёркиваниями
Дополнительно убедитесь, что конфигурация проходит проверку без ошибок после добавления или переименования объекта: команда проверки конфигурации в конфигураторе покажет битые ссылки на старое имя в модулях и запросах.
Что важно запомнить
Имя — технический идентификатор для кода, синоним — название для пользователей. Имя начинается с буквы, содержит только буквы, цифры и подчёркивания, отражает смысл объекта и для доработок снабжается префиксом. Переименование выполняйте с поиском всех ссылок и резервной копией.
Часто задаваемые вопросы
Можно ли использовать русские буквы в именах объектов 1С?
Да, встроенный язык полностью поддерживает кириллицу в идентификаторах, и большинство типовых конфигураций написано на русском. Главное — не смешивать русские и латинские имена без системы: выберите один стиль и придерживайтесь его во всей конфигурации.
Что делать, если конфигуратор пишет «Недопустимое имя»?
Проверьте три причины: имя начинается с цифры, содержит пробел или спецсимвол, либо совпадает с зарезервированным словом или уже существующим объектом. Уберите недопустимые символы, добавьте букву в начало или уточняющее слово для уникальности.
Потеряются ли данные при переименовании справочника или документа?
Нет, данные хранятся в таблицах, привязанных к внутренним идентификаторам, а не к имени. Риск в другом: перестанут работать код, запросы, роли и обмены, где использовалось старое имя, поэтому перед переименованием обязателен глобальный поиск ссылок и резервная копия.
Зачем нужен префикс в именах собственных объектов?
Префикс отделяет ваши доработки от типовых объектов и предотвращает конфликт имён при обновлении конфигурации: если поставщик добавит объект с таким же именем, обновление не столкнётся с вашим. Префикс выбирают коротким и используют единообразно.
Как назвать копию базы для тестирования?
Начните название со слова «ТЕСТ», затем укажите организацию и назначение, например «ТЕСТ — ООО Вектор — проверка обновления». В самой базе отключите фоновые обмены и рассылки, чтобы тестовая копия не отправила данные во внешние системы.
Чем имя отличается от синонима на практике?
Имя используется в коде и запросах и подчиняется строгим правилам платформы, синоним видят пользователи в интерфейсе и он может содержать любые символы. Если нужно изменить отображаемое название, правьте синоним — это безопасно и не требует правки кода.