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