Конфигуратор 1С 8.3 без страха: запуск, код, отладка и хранилище
Содержание
Чтобы начать работать в конфигураторе 1С, выберите базу в окне запуска и нажмите кнопку «Конфигуратор», затем откройте дерево через Конфигурация → Открыть конфигурацию. Дальше всё крутится вокруг трёх клавиш: F5 запускает отладку, F7 применяет изменения к базе, Ctrl+F7 проверяет синтаксис модуля.
Конфигуратор пугает новичков: десятки веток, непонятные «основная конфигурация» и «конфигурация базы данных», страх что-то сломать. На деле порядок работы в 1С 8.3 один и тот же у разработчика и администратора: вход, навигация по дереву, правка кода, отладка, применение изменений и групповая разработка через хранилище.
1. Как запустить конфигуратор и в каком режиме работать
Самый простой путь — через окно запуска 1cestart:
- Выберите информационную базу в списке.
- Нажмите «Конфигуратор» (кнопка справа от списка баз).
- Введите пользователя и пароль. Для входа нужны административные права — в типовых конфигурациях это роль «Полные права».
Тот же запуск из командной строки удобен для ярлыков и сценариев обслуживания:
"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С
Отладка показывает, что реально происходит в коде: какие значения у переменных, по какой ветке пошло условие.
- Поставьте точку останова: курсор на строку, клавиша
F9. Слева появится красная метка. - Нажмите
F5(Отладка → Начать отладку) — запустится 1С:Предприятие, уже подключённое к отладчику. - Выполните в пользовательском режиме действие, которое вызывает нужный код: нажмите кнопку, проведите документ.
- Выполнение остановится на строке, а конфигуратор выйдет на передний план.
Управление шагами
| Клавиша | Действие |
|---|---|
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 новой версии.
- Выгрузите базу в
.dt. - Запустите обновление и укажите файл.
- Если конфигурация на замке — платформа обновит её без вопросов.
- Если есть свои изменения — откроется окно сравнения и объединения. Для каждого изменённого объекта решите, чей вариант брать: поставщика или ваш, либо объединить построчно.
- Нажмите
F7, примите реорганизацию. - Запустите 1С:Предприятие — типовые конфигурации выполнят обработчики обновления данных.
Релизы ставятся по цепочке: каждый пакет обновления рассчитан на конкретные предыдущие версии. Перепрыгнуть через несколько релизов одним файлом .cfu получится не всегда.
7. Хранилище конфигурации: работа в команде и история версий
Когда над конфигурацией работают двое и больше, правки вручную перетирают друг друга. Хранилище решает это блокировками объектов и историей изменений.
Подключение
- Создать хранилище:
Конфигурация → Хранилище конфигурации → Создать хранилище. Указывается каталог или адрес сервера хранилища. - Подключиться к существующему:
Конфигурация → Хранилище конфигурации → Подключиться к хранилищу. Для сетевой работы используют сервер хранилища (crserver) с адресом видаtcp://server/repoили публикацию на веб-сервере.
Цикл работы
- Захватить объект — правый щелчок → «Захватить в хранилище». Объект блокируется для коллег.
- Внести правки, проверить, отладить.
- Поместить изменения — правый щелчок → «Поместить в хранилище», с комментарием, что сделано и зачем.
- Коллеги забирают правки командой «Обновить конфигурацию из хранилища ».
История хранится целиком: Конфигурация → Хранилище конфигурации → История хранилища показывает каждую версию, автора и комментарий. Любую версию можно сравнить с текущей или выгрузить в .cf.
💡 Приёмы, которые стоит завести с первого дня:
- 📝 Пишите комментарий к каждому помещению: номер задачи и суть правки.
- 🔒 Не держите объекты захваченными неделями — коллеги стоят.
- 🏷 Ставьте метку версии перед выпуском в рабочую базу, чтобы быстро откатиться.
- 🧪 Рабочую базу не подключайте к хранилищу: разрабатывайте в копии и переносите готовое через
.cfили обновление.
Для больших команд есть альтернатива конфигуратору — среда 1С:Enterprise Development Tools (EDT), где исходники хранятся в Git. Но хранилище и конфигуратор остаются стандартом в большинстве внедрений.
8. Частые вопросы
Почему конфигуратор не открывается и пишет, что недостаточно прав?
Можно ли работать в конфигураторе, пока бухгалтеры сидят в базе?
.dt и тестировании с исправлением.Чем выгрузка .dt отличается от сохранения конфигурации в .cf?
.dt содержит и конфигурацию, и все данные базы — это полная копия. Файл .cf — только конфигурация, без документов и справочников.Как вернуть конфигурацию, если правки всё испортили?
F7 ещё не нажимали, выполните Конфигурация → Конфигурация базы данных → Вернуться к конфигурации БД. Если изменения уже применены — загрузите сохранённый .dt или нужную версию из хранилища.Где посмотреть, какая версия платформы и конфигурации стоит?
Справка → О программе. Там указаны номер платформы и версия конфигурации из её свойств.