Как переименовать колонку в терминале сбора данных 1С

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

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

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

Различие между именем реквизита и заголовком поля

Фундаментальным принципом разработки в 1С является разделение логической структуры данных и их визуального представления. Имя реквизита используется в коде, запросах и алгоритмах обработки информации. Оно должно быть уникальным, лаконичным и соответствовать правилам именования идентификаторов. В то же время заголовок поля (или название колонки в таблице) — это текст, который видит конечный пользователь.

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

Рассмотрим типичную ситуацию. У вас есть справочник "Номенклатура", в котором есть реквизит "Артикул". В базе данных он хранится как Артикул. Однако на экране ТСД кладовщикам привычнее видеть название "Код товара" или "Штрихкод производителя". Изменив свойство Синоним или настройку формы, вы поменяете надпись на экране, не затрагивая внутреннюю логику работы программы. Это обеспечивает стабильность системы при частых изменениях интерфейса.

Важно понимать, что в мобильном клиенте 1С отображение колонок табличного документа или списка управляется свойствами формы. Если вы меняете имя в конфигураторе, это повлияет на все места использования объекта. Если же вы меняете заголовок только в форме, изменение будет локальным для данного конкретного экрана ТСД.

⚠️ Внимание: Никогда не меняйте имя реквизита в конфигураторе, если он уже используется в обработках, отчетах или внешнем коде. Это приведет к ошибкам компиляции и неработоспособности модулей. Используйте только изменение заголовков в формах или синонимов.

Настройка заголовков в конфигураторе 1С

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

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

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

Как обновить мобильное приложение после изменений?

После изменения конфигурации на сервере, мобильное приложение на ТСД необходимо обновить. Зайдите в приложение, выберите вашу базу данных и нажмите кнопку "Обновить" или "Синхронизировать". Если используется файл обновления (.cfu), его нужно загрузить через меню настроек приложения.

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

Редактирование формы мобильного клиента

Часто требуется изменить название колонки только для конкретного сценария использования, не затрагивая глобальные настройки. Например, в форме "Приемка товара" колонка должна называться "Факт", а в форме "Инвентаризация" — "Остаток". Для этого используется редактор форм в конфигураторе.

Откройте нужную форму мобильного приложения в режиме редактирования. Найдите элемент табличного документа или списка, где расположена целевая колонка. Выделите эту колонку в дереве элементов формы. В палитре свойств вы увидите поле Заголовок (или Title в англоязычной версии интерфейса разработки).

Свойство: Заголовок
Значение по умолчанию: Артикул
Новое значение: Код производителя

Изменив это свойство, вы переопределите стандартное поведение системы. Теперь, независимо от того, как назван реквизит в базе данных или какой у него синоним, на экране ТСД в этой конкретной форме будет отображаться заданный вами текст. Это мощный инструмент для адаптации интерфейса под разные роли пользователей.

Если колонка динамически добавляется через код, например, с помощью метода ДобавитьКолонку, то заголовок задается вторым параметром этой функции. В таком случае вам придется лезть в код модуля формы. Найдите строку, где формируется таблица, и измените строковый литерал, передаваемый в метод.

После внесения изменений в форму обязательно проверьте её в режиме эмулятора или на реальном устройстве. Мобильный клиент 1С может кэшировать некоторые элементы интерфейса. Для гарантированного отображения новых заголовков рекомендуется выполнить полную выгрузку и загрузку приложения на устройство.

Программное изменение заголовков в коде

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

Для работы с элементами формы в коде используется объект ЭлементыФормы. Чтобы изменить заголовок колонки табличного документа, нужно обратиться к соответствующему элементу таблицы, а затем к колонке внутри неё. Синтаксис выглядит следующим образом:

ЭлементыФормы.ТаблицаТоваров.Колонки.Артикул.Заголовок = "Штрихкод";

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

При использовании динамических списков (НСЧ) ситуация немного сложнее. Там структура колонок часто определяется запросом. В этом случае псевдонимы полей в запросе (КАК) могут влиять на заголовки, если они не переопределены в настройках списка. Однако, надежнее всего явно задавать заголовки через объект НастройкиСписка в коде перед выводом списка.

Особенности работы с табличными документами

Табличный документ — это основной способ отображения списков в мобильных приложениях 1С. Работа с заголовками колонок здесь имеет свою специфику. Колонки могут быть добавлены как через конструктор, так и программно. Важно различать заголовок колонки в шапке таблицы и подсказку, которая всплывает при наведении (хотя на сенсорных экранах наведение отсутствует, подсказки могут использоваться для сканирования).

Если вы используете макет табличного документа, заголовки "зашиты" в ячейки макета. Чтобы их изменить, нужно открыть макет в редакторе и поменять текст в соответствующей ячейке области заголовков. Это самый простой, но наименее гибкий способ, так как требует изменения макета при любой правке текста.

Более продвинутый вариант — использование области заголовков, которая заполняется программно. В этом случае вы формируете таблицу значений, задаете имена колонок и их заголовки через объект ОписаниеПолейТаблицыЗначений. Это позволяет применять форматирование, выравнивание и динамическое изменение текстов.

Способ настройки	Уровень влияния	Гибкость	Сложность
Синоним реквизита	Глобальный	Низкая	Низкая
Свойство формы	Локальный (форма)	Средняя	Низкая
Код 1С (Элементы)	Динамический	Высокая	Средняя
Макет табличного документа	Статический	Низкая	Низкая

Обратите внимание на производительность. Программное изменение заголовков в цикле при отрисовке больших таблиц может незначительно замедлить открытие формы. Однако для изменения именно заголовка (один раз при старте) это влияние пренебрежимо мало. Главное — не делать это в цикле обработки каждой строки данных.

Типовые ошибки и их решение

При попытке переименовать колонку разработчики часто сталкиваются с тем, что изменения не отображаются на устройстве. Самая частая причина — кэширование мобильного клиента. Приложение 1С на Android или iOS хранит локальную копию метаданных и форм для ускорения работы.

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

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

⚠️ Внимание: Интерфейс мобильного клиента 1С может отличаться в зависимости от версии платформы (8.3.10, 8.3.20 и т.д.). Некоторые свойства форм могли быть переименованы или перемещены в новых версиях. Всегда сверяйтесь с синтаксис-помощником вашей версии платформы.

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

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

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

В режиме предприятия (пользовательском режиме) стандартными средствами переименовать колонку в мобильном приложении нельзя. Это требует прав разработчика и доступа к конфигурации. Однако, если разработчик предусмотрел персональные настройки формы, пользователь может скрыть или переместить колонку, но не переименовать её глобально.

Почему после изменения синонима название на экране не поменялось?

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

Влияет ли переименование колонки на выгрузку данных в Excel?

Нет, не влияет. При выгрузке табличного документа или списка в Excel обычно используются внутренние имена реквизитов или значения ячеек. Заголовок колонки — это лишь визуальное отображение. Однако, если вы формируете печатную форму на основе макета, где заголовки "зашиты" жестко, то там изменения отразятся только после правки макета.

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

Чтобы вернуть название по умолчанию, необходимо очистить свойство "Заголовок" у элемента формы в конфигураторе. После этого система снова начнет подтягивать имя из синонима реквизита метаданных. Если меняли через код — удалите или закомментируйте строку присваивания нового заголовка.