Конфигуратор 1С 8.3 без страха: запуск, код, отладка и хранилище

· 9 мин

Содержание

Чтобы начать работать в конфигураторе 1С, выберите базу в окне запуска и нажмите кнопку «Конфигуратор», затем откройте дерево через Конфигурация → Открыть конфигурацию. Дальше всё крутится вокруг трёх клавиш: F5 запускает отладку, F7 применяет изменения к базе, Ctrl+F7 проверяет синтаксис модуля.

Конфигуратор пугает новичков: десятки веток, непонятные «основная конфигурация» и «конфигурация базы данных», страх что-то сломать. На деле порядок работы в 1С 8.3 один и тот же у разработчика и администратора: вход, навигация по дереву, правка кода, отладка, применение изменений и групповая разработка через хранилище.

1. Как запустить конфигуратор и в каком режиме работать

Самый простой путь — через окно запуска 1cestart:

  1. Выберите информационную базу в списке.
  2. Нажмите «Конфигуратор» (кнопка справа от списка баз).
  3. Введите пользователя и пароль. Для входа нужны административные права — в типовых конфигурациях это роль «Полные права».

Тот же запуск из командной строки удобен для ярлыков и сценариев обслуживания:

"C:\Program Files\1cv8\8.3.xx.xxxx\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /N "Администратор" /P "пароль"

Для клиент-серверной базы вместо /F указывают /S "server\base". Подставьте свою папку версии платформы вместо 8.3.xx.xxxx.

Файловая и серверная база: что меняется

ВариантКак подключаетсяЧто учесть
ФайловаяПуть к папке с 1Cv8.1CDРаботать удобно в одиночку; при обновлении структуры остальные пользователи должны выйти
Клиент-сервернаяИмя сервера и базы в кластереДля отладки на сервере агент ragent запускают с ключом -debug

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

Перед любой серьёзной правкой выгрузите базу: Администрирование → Выгрузить информационную базу. Файл .dt — самая надёжная точка отката.

2. Окно конфигуратора и дерево конфигурации

После Конфигурация → Открыть конфигурацию слева появится дерево. Это вся прикладная логика базы, разложенная по типам объектов.

📂 Что лежит в ветках дерева:

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

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

Две конфигурации, о которых надо помнить

В конфигураторе одновременно живут:

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

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

Как быстро найти объект

  • Строка поиска над деревом фильтрует ветки по имени.
  • Ctrl+Shift+F — глобальный поиск по всем модулям, формам и макетам. Незаменим, когда нужно понять, где используется реквизит.
  • Правый щелчок по объекту → «Поиск ссылок на объект» покажет, кто к нему обращается.

3. Модули и программный код: где писать и как не сломать типовую

Поддержка: почему код «серый» и не редактируется

Типовые конфигурации стоят на поддержке поставщика. Объекты на замке редактировать нельзя. Чтобы снять запрет, откройте Конфигурация → Поддержка → Настройка поддержки и включите возможность изменения.

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

Поэтому опытные разработчики правят типовые решения через расширения: Конфигурация → Расширения конфигурации. Расширение хранит доработки отдельно, а основная конфигурация остаётся на поддержке. Расширения появились в платформе 8.3.6. Перехват процедуры делается через аннотации &Перед, &После или &Вместо в модуле расширения.

Какие бывают модули

МодульГде открытьЧто туда пишут
Модуль объектаПравый щелчок по справочнику/документуОбработчики ПередЗаписью, ОбработкаПроведения
Модуль менеджераТам жеФункции, которые не требуют экземпляра объекта
Модуль формыФорма → вкладка «Модуль»Обработчики кнопок и полей
Общий модульВетка «Общие → Общие модули»Переиспользуемые процедуры
Модуль сеанса, модуль управляемого приложенияПравый щелчок по корню дереваДействия при старте сеанса и приложения

В модулях форм каждая процедура помечается директивой: &НаКлиенте, &НаСервере или &НаСервереБезКонтекста. Ошибка в директиве — частая причина сообщений вида Метод объекта не обнаружен, когда клиентский код пытается вызвать серверный метод объекта напрямую.

Пример серверной процедуры формы документа:

&НаСервере
Процедура ПосчитатьИтогНаСервере()
	Итого = 0;
	Для Каждого Строка Из Объект.Товары Цикл
		Итого = Итого + Строка.Сумма;
	КонецЦикла;
	Сообщить("Итого по документу: " + Формат(Итого, "ЧДЦ=2"));
КонецПроцедуры

Клавиши, которые экономят время в редакторе

  • Ctrl+Space — контекстная подсказка: методы, реквизиты, переменные.
  • F12 — переход к определению процедуры.
  • Ctrl+G — переход на строку по номеру (удобно, когда ошибка указывает строку).
  • Ctrl+/ и Ctrl+Shift+/ — закомментировать и раскомментировать блок.
  • Ctrl+F7 — проверка синтаксиса текущего модуля.

Справка по встроенному языку открывается через Справка → Синтакс-помощник. Для запросов используйте конструктор запроса из контекстного меню редактора — он собирает текст запроса без опечаток в именах таблиц.

4. Отладка в конфигураторе 1С

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

  1. Поставьте точку останова: курсор на строку, клавиша F9. Слева появится красная метка.
  2. Нажмите F5 (Отладка → Начать отладку) — запустится 1С:Предприятие, уже подключённое к отладчику.
  3. Выполните в пользовательском режиме действие, которое вызывает нужный код: нажмите кнопку, проведите документ.
  4. Выполнение остановится на строке, а конфигуратор выйдет на передний план.

Управление шагами

КлавишаДействие
F10Шаг через: выполнить строку, не заходя в вызываемые процедуры
F11Шаг в: зайти внутрь вызываемой процедуры
Shift+F11Выйти из текущей процедуры
F5Продолжить до следующей точки останова
Shift+F9Вычислить выражение: значение переменной или любой формулы

Окно «Табло» (Отладка → Табло) держит перед глазами несколько выражений сразу. Окно «Стек вызовов» показывает, через какие процедуры вы пришли в текущую строку.

Отладка серверного кода и чужих сеансов

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

Чтобы подключиться к уже запущенному сеансу (например, фоновому заданию), используйте Отладка → Подключение: там видны доступные предметы отладки.

Если код работает медленно, а не с ошибкой, включите замер производительности в меню «Отладка». Он покажет, какие строки съедают время — чаще всего это запросы в цикле.

5. «Компиляция» и обновление конфигурации базы данных

Отдельной кнопки «скомпилировать» в 1С нет. Платформа сама переводит модули во внутренний код при выполнении. На практике под компиляцией понимают два шага: проверку и применение изменений к базе.

Проверка перед применением

  • Ctrl+F7 — синтаксис открытого модуля.
  • Конфигурация → Проверка конфигурации — полная проверка: синтаксис всех модулей, ссылки на несуществующие объекты, режимы клиентов. Флажки в окне проверки задают, какие клиенты и режимы учитывать.

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

Применение изменений: F7

Конфигурация → Обновить конфигурацию базы данных (F7) переносит основную конфигурацию в конфигурацию базы данных. Что произойдёт, зависит от характера правок:

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

Окно реорганизации читайте внимательно. Строка об удалении реквизита означает, что данные в нём пропадут. Если не уверены — нажмите «Отмена» и сделайте выгрузку .dt.

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

Пакетный режим для администратора

Ночное обслуживание удобно автоматизировать через командную строку:

"C:\Program Files\1cv8\8.3.xx.xxxx\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /N "Администратор" /P "пароль" /DumpIB "D:\Backup\buh.dt" /Out "D:\Backup\log.txt"
"C:\Program Files\1cv8\8.3.xx.xxxx\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /N "Администратор" /P "пароль" /UpdateDBCfg /Out "D:\Backup\log.txt"

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

6. Обновление типовой конфигурации на новый релиз

Типовую конфигурацию обновляют через Конфигурация → Поддержка → Обновить конфигурацию. Источник — файл .cfu (пакет обновления) или полный .cf новой версии.

  1. Выгрузите базу в .dt.
  2. Запустите обновление и укажите файл.
  3. Если конфигурация на замке — платформа обновит её без вопросов.
  4. Если есть свои изменения — откроется окно сравнения и объединения. Для каждого изменённого объекта решите, чей вариант брать: поставщика или ваш, либо объединить построчно.
  5. Нажмите F7, примите реорганизацию.
  6. Запустите 1С:Предприятие — типовые конфигурации выполнят обработчики обновления данных.

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

Перед обновлением конфигурации
Выполнено: 0 / 5

7. Хранилище конфигурации: работа в команде и история версий

Когда над конфигурацией работают двое и больше, правки вручную перетирают друг друга. Хранилище решает это блокировками объектов и историей изменений.

Подключение

  • Создать хранилище: Конфигурация → Хранилище конфигурации → Создать хранилище. Указывается каталог или адрес сервера хранилища.
  • Подключиться к существующему: Конфигурация → Хранилище конфигурации → Подключиться к хранилищу. Для сетевой работы используют сервер хранилища (crserver) с адресом вида tcp://server/repo или публикацию на веб-сервере.

Цикл работы

  1. Захватить объект — правый щелчок → «Захватить в хранилище». Объект блокируется для коллег.
  2. Внести правки, проверить, отладить.
  3. Поместить изменения — правый щелчок → «Поместить в хранилище», с комментарием, что сделано и зачем.
  4. Коллеги забирают правки командой «Обновить конфигурацию из хранилища ».

История хранится целиком: Конфигурация → Хранилище конфигурации → История хранилища показывает каждую версию, автора и комментарий. Любую версию можно сравнить с текущей или выгрузить в .cf.

💡 Приёмы, которые стоит завести с первого дня:

  • 📝 Пишите комментарий к каждому помещению: номер задачи и суть правки.
  • 🔒 Не держите объекты захваченными неделями — коллеги стоят.
  • 🏷 Ставьте метку версии перед выпуском в рабочую базу, чтобы быстро откатиться.
  • 🧪 Рабочую базу не подключайте к хранилищу: разрабатывайте в копии и переносите готовое через .cf или обновление.

Для больших команд есть альтернатива конфигуратору — среда 1С:Enterprise Development Tools (EDT), где исходники хранятся в Git. Но хранилище и конфигуратор остаются стандартом в большинстве внедрений.

8. Частые вопросы

Почему конфигуратор не открывается и пишет, что недостаточно прав?
Пользователю не назначена роль с административными правами. Войдите под администратором в режиме 1С:Предприятие и добавьте роль «Полные права» в карточке пользователя или в его группе доступа.
Можно ли работать в конфигураторе, пока бухгалтеры сидят в базе?
Да, читать и править код можно. Отключать пользователей нужно только при обновлении структуры базы, загрузке .dt и тестировании с исправлением.
Чем выгрузка .dt отличается от сохранения конфигурации в .cf?
Файл .dt содержит и конфигурацию, и все данные базы — это полная копия. Файл .cf — только конфигурация, без документов и справочников.
Как вернуть конфигурацию, если правки всё испортили?
Если F7 ещё не нажимали, выполните Конфигурация → Конфигурация базы данных → Вернуться к конфигурации БД. Если изменения уже применены — загрузите сохранённый .dt или нужную версию из хранилища.
Где посмотреть, какая версия платформы и конфигурации стоит?
В конфигураторе: Справка → О программе. Там указаны номер платформы и версия конфигурации из её свойств.