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

Другое · 5 мин

Листинг в 1С: что это такое и как с ним работать

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

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

Листинг встречается у модулей объектов, форм, общих модулей, менеджеров объектов и других объектов конфигурации. Он нужен для просмотра логики, копирования фрагментов, сравнения версий и подготовки печатной копии кода.

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

Что показывает листинг модуля

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

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

Где открыть листинг в конфигураторе

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

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

Порядок действий
  1. 1
    Откройте конфигуратор и выберите нужный модуль в дереве конфигурации
  2. 2
    Запустите редактирование модуля, чтобы отобразить листинг
  3. 3
    Проверьте синтаксис и сохраните изменения

Как скопировать и распечатать листинг

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

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

Ограничения и риски при правке кода

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

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

Частые ошибки при работе с листингом

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

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

Типичные ошибки
01
Правка без проверки синтаксиса — ошибки при запуске или компиляции
02
Копирование чужого кода без адаптации — сбои в учёте и отчётах

Как проверить, что изменения применились

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

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

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

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

Текст модуля после повторного открытия
Норма

Совпадает с сохранённым вариантом

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

Отсутствуют строки или есть маркеры ошибок

Запуск типовой операции
Норма

Выполняется без сообщений

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

Ошибки выполнения или некорректный результат

Когда стоит обратиться к разработчику

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

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

Итог

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

Листинг — это текст модуля в конфигураторе; правьте его осторожно, проверяйте синтаксис и храните резервные копии перед изменениями.

Можно ли редактировать листинг в обычной рабочей базе?

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

Нужно ли сохранять листинг отдельным файлом?

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

Что делать, если после правки листинга программа не запускается?

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

Подходит ли чужой листинг из интернета для моей конфигурации?

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

Как понять, что изменения в листинге применились?

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