К статье
Практический материал

Разработка и Конфигурация · 11 мин

Как переименовать реквизиты в 1С: пошаговая инструкция

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

Переименование реквизита в 1С — типовая задача, которая возникает при доработке конфигурации, исправлении ошибок в наименованиях или адаптации типового решения под процессы компании. Важно понимать: у реквизита есть два названия — имя (внутренний идентификатор, используемый в коде и запросах) и синоним (то, что видит пользователь в формах и отчётах). Менять их нужно по-разному, и цена ошибки сильно отличается.

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

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

Имя и синоним: что именно вы переименовываете

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

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

Что менять: синоним или имя

Синоним

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

Имя

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

Частая ситуация: пользователь просит «переименовать поле», хотя достаточно поправить синоним. Уточните требование до начала работ — это сэкономит время и убережёт от лишней реструктуризации базы.

Подготовка: резервная копия и поиск зависимостей

Любое изменение имени реквизита начинайте с резервной копии информационной базы. Для файловой базы достаточно выгрузки через «Администрирование → Выгрузить информационную базу» в конфигураторе или копирования файла 1Cv8.1CD при остановленной работе пользователей. Для клиент-серверной базы используйте штатные средства СУБД или выгрузку в dt.

Второй обязательный шаг — найти все места, где используется реквизит. В конфигураторе выделите реквизит в дереве метаданных, нажмите правую кнопку мыши и выберите «Поиск ссылок в объектах». Дополнительно выполните глобальный поиск (Ctrl+Shift+F) по старому имени по всей конфигурации, включая модули, запросы и макеты.

Подготовка к переименованию
  1. 1
    Сделайте резервную копию базы (выгрузка в dt или копия файла)
  2. 2
    Найдите ссылки на реквизит через контекстное меню «Поиск ссылок в объектах»
  3. 3
    Выполните глобальный поиск по старому имени во всех модулях и запросах
  4. 4
    Проверьте планы обмена, подписки на события и внешние обработки, использующие реквизит
  5. 5
    Завершите работу пользователей или договоритесь о монопольном доступе

Особое внимание уделите местам, где имя реквизита задано строкой: например, обращения вида Документ["СтароеИмя"], настройки СКД, динамические списки с произвольным запросом, типовые правила обмена. Глобальный поиск по строке находит такие обращения, но только если имя указано литералом — динамически формируемые строки поиск не покажет.

Как изменить синоним реквизита

Откройте конфигуратор, в дереве конфигурации найдите нужный объект (справочник, документ, регистр), разверните ветку «Реквизиты» и дважды щёлкните по нужному реквизиту — откроется палитра свойств. Найдите поле «Синоним» и введите новое значение.

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

После изменения сохраните конфигурацию (Ctrl+S) и обновите конфигурацию базы данных (F7 или «Конфигурация → Обновить конфигурацию базы данных»). Реструктуризация при смене синонима не выполняется, обновление проходит быстро. Проверьте результат в пользовательском режиме: откройте форму объекта и убедитесь, что новая подпись отображается.

Как изменить имя реквизита без потери данных

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

Ключевой момент — окно реструктуризации. Платформа покажет список изменений: старое поле будет помечено на удаление, новое — на добавление. Если просто нажать «Принять», данные старой колонки будут удалены. Чтобы сохранить значения, нужно, чтобы платформа восприняла изменение как переименование: при изменении только имени реквизита (без смены типа и принадлежности) платформа, как правило, сопоставляет поля автоматически и показывает операцию «изменение», а не «удаление + добавление».

Если одновременно с переименованием меняется тип реквизита (например, строка на число или увеличивается длина), риск потери данных возрастает: платформа попытается преобразовать значения, и непреобразуемые данные будут очищены. Такие изменения делайте поэтапно: сначала переименование с обновлением, затем отдельно смена типа с контролем результата.

Переименование в типовой конфигурации на поддержке

Если конфигурация типовая и находится на полной поддержке, изменение имени реквизита снимет объект с поддержки и усложнит будущие обновления. Предпочтительные варианты: ограничиться синонимом, использовать расширение конфигурации (для добавления собственных реквизитов) или оставить типовое имя и изменить только отображение. Решение о снятии с поддержки должно быть осознанным и зафиксированным.

Проверка результата после обновления

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

Затем пройдите по списку зависимостей, составленному на этапе подготовки: запустите обработки, проверьте обмены данными, откройте отчёты на СКД. Ошибки вида «Поле не найдено» при открытии формы или выполнении запроса — признак пропущенного обращения по старому имени.

Контрольные точки

Как проверить результат

Значения реквизита в существующих объектах
Норма

Данные на месте и совпадают с тем, что было до переименования

Тревожный признак

Поле пустое у всех объектов — данные потеряны при реструктуризации

Открытие форм и отчётов
Норма

Формы открываются без ошибок, подписи корректны

Тревожный признак

Ошибки «Поле не найдено» или «Ошибка в запросе» — остались обращения по старому имени

Обмены и интеграции
Норма

Синхронизация проходит без ошибок

Тревожный признак

Ошибки сопоставления полей в правилах обмена

Типичные ошибки и ограничения

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

Третья группа ошибок связана с обменами: если реквизит участвует в правилах конвертации или типовой синхронизации, после переименования сопоставление полей может сломаться, и данные перестанут переноситься. Правила обмена, настроенные через XML или КД 2/3, нужно корректировать отдельно.

Типичные ошибки
01
Принятие реструктуризации без проверки сопоставления полей — старая колонка удаляется вместе с данными
02
Переименование без глобального поиска — в запросах и СКД остаются обращения по старому имени, формы и отчёты падают с ошибкой
03
Смена имени в типовой конфигурации на поддержке — усложняются все последующие обновления
04
Одновременная смена имени и типа реквизита — повышается риск потери или искажения данных
05
Забытые правила обмена — синхронизация с другими системами перестаёт переносить переименованное поле

Отдельное ограничение: предопределённые реквизиты, стандартные реквизиты (Код, Наименование, Номер, Дата) и реквизиты, задействованные в критичных механизмах платформы, переименовываются с ограничениями или не переименовываются вовсе. Для стандартных реквизитов можно менять только синоним.

Часто задаваемые вопросы

Можно ли переименовать реквизит без конфигуратора?

Полноценно — нет: изменение имени и синонима выполняется только в конфигураторе с последующим обновлением конфигурации базы данных. В пользовательском режиме можно лишь изменить видимость и порядок полей через настройки формы, но не их названия. В некоторых конфигурациях есть механизм «дополнительных реквизитов», где наименование задаётся пользователем, — но это другой механизм, не связанный с метаданными.

Пропадут ли данные при переименовании реквизита?

Нет, если платформа распознала изменение как переименование: в окне реструктуризации поле должно значиться как изменяемое, а не как пара «удалить + добавить». Риск потери появляется при одновременной смене типа, переносе реквизита между объектами или при ошибочном принятии удаления. Резервная копия перед обновлением обязательна.

Как переименовать реквизит во всех документах сразу?

Штатного «массового» переименования одного реквизита сразу во многих объектах нет — правка выполняется в каждом объекте отдельно. Если одинаковый реквизит используется в десятках документов, рассмотрите критерии отбора, общие реквизиты или определяемые типы как архитектурную альтернативу на будущее, но сама правка имён всё равно делается по объектам.

Что делать, если после переименования отчёт выдаёт ошибку «Поле не найдено»?

Откройте настройки отчёта: если он построен на СКД, в схеме компоновки в тексте запроса осталось старое имя поля — замените его на новое в консоли СКД или в модуле. Для отчётов, сохранённых пользователями, старые настройки могут ссылаться на прежнее имя — такие настройки проще пересоздать, выбрав поле заново.

Нужно ли переименовывать реквизит в расширении конфигурации?

Расширение не позволяет переименовать существующий реквизит основной конфигурации — оно может добавлять собственные реквизиты и менять некоторые свойства заимствованных объектов, но имя типового реквизита остаётся прежним. Для изменения отображаемой подписи в ряде случаев достаточно переопределить синоним в коде или настройках формы.

Как откатить переименование, если что-то пошло не так?

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

Итог

Что важно запомнить

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