Режим «Конфигуратор» 1С 8.3 для администратора и разработчика: от дерева метаданных до отладки
Содержание
Работа с конфигуратором в 1С начинается с команды Конфигурация → Открыть конфигурацию: без неё дерево объектов пустое и править нечего. Любая правка потом проходит два этапа — сохранение (Ctrl+S) и обновление конфигурации
базы данных (F7). Пока вы не нажали F7, пользователи в режиме «1С:Предприятие» вашей правки не увидят.
Частое заблуждение — считать, что «сохранил, значит работает». Сохранение пишет изменения только в основную конфигурацию. Боевая база продолжает жить по старой конфигурации базы данных, пока вы её не обновите. Это главное, что нужно понять специалисту, прежде чем трогать любой объект.
Интерфейс конфигуратора: где что находится
Конфигуратор запускается из окна выбора баз: выделите базу и нажмите кнопку «Конфигуратор». Для запуска из командной строки используйте ключ DESIGNER:
"C:\Program Files\1cv8\common\1cestart.exe" DESIGNER /F "D:\Bases\Buh" /N "Администратор" /P "пароль"
Для клиент-серверной базы вместо /F указывают /S "server\base".
После открытия вы видите главное меню, панель инструментов и рабочую область. Основные элементы:
- 🌳 Дерево конфигурации — все объекты метаданных, сгруппированные по видам: «Общие», «Константы», «Справочники», «Документы», «Регистры сведений» и так далее.
- 🧾 Палитра свойств — открывается по
Alt+Enterна выделенном объекте. В ней имя, синоним, типы реквизитов, флаги поведения. - 💬 Окно служебных сообщений — сюда падают результаты синтаксической проверки, ошибки обновления и вывод
Сообщить()при отладке. - 🔎 Строка поиска над деревом — фильтрует объекты по имени. На крупной конфигурации вроде БП 3.0 это быстрее, чем раскрывать ветки вручную.
Если дерево закрыли случайно, повторно выберите Конфигурация → Открыть конфигурацию — окно вернётся.
Полезные горячие клавиши , которые экономят больше всего времени:
| Клавиша | Действие |
|---|---|
Ctrl+S | Сохранить основную конфигурацию |
F7 | Обновить конфигурацию базы данных |
F5 | Начать отладку |
Ctrl+F7 | Синтаксический контроль модуля |
F12 | Перейти к определению процедуры |
F9 | Поставить или снять точку останова |
Ctrl+F | Поиск в текущем модуле |
Ctrl+Shift+F | Глобальный поиск по конфигурации |
Основная конфигурация и конфигурация БД: базовые действия
В конфигураторе одновременно существуют две конфигурации. Их путаница — частая причина «пропавших» доработок.
| Что это | Где открыть | Можно ли править |
|---|---|---|
| Основная конфигурация | Конфигурация → Открыть конфигурацию | Да, это рабочая копия разработчика |
| Конфигурация базы данных | Конфигурация → Конфигурация базы данных → Открыть конфигурацию БД | Нет, только просмотр |
| Конфигурация поставщика | Конфигурация → Поддержка → Открыть конфигурацию поставщика | Нет, эталон для обновлений |
Цикл работы выглядит так:
- Открыть основную конфигурацию.
- Внести изменения в объект, модуль или форму.
- Сохранить (
Ctrl+S). Конфигуратор проверит синтаксис. - Обновить конфигурацию
БД (
F7). Платформа покажет список изменений структуры и попросит подтвердить реорганизацию. - Проверить результат в режиме «1С:Предприятие».
Если в окне основной конфигурации стоит звёздочка или дерево помечено как изменённое, а F7 не нажат — изменения висят в «подвешенном» состоянии. Отменить их целиком можно командой Конфигурация → Конфигурация базы данных → Вернуться к конфигурации БД.
Выгрузка и загрузка файла .cf
Файл .cf содержит только конфигурацию, без данных. Он нужен, чтобы перенести доработки в другую базу или сохранить точку отката:
- 📤
Конфигурация → Сохранить конфигурацию в файл— выгрузка. - 📥
Конфигурация → Загрузить конфигурацию из файла— полная замена основной конфигурации. - 🔀
Конфигурация → Сравнить, объединить с конфигурацией из файла— частичный перенос с выбором объектов.
Загрузка .cf полностью перезаписывает основную конфигурацию. Если в базе были свои доработки, а в файле их нет, они исчезнут после F7. Для частичного переноса используйте сравнение и объединение.
Настройки редактора, которые стоит поменять сразу
Окно параметров открывается через Сервис → Параметры. Две настройки, которые заметно меняют удобство работы:
- ✍️ Модули → Редактирование — автоматическая расстановка отступов и подсказка по
Ctrl+Пробел. Контекстная подсказка показывает реквизиты, методы и параметры процедур. - 🌐 Запуск 1С:Предприятия — тип клиента для отладки (тонкий, толстый, веб). Если ошибка воспроизводится только у пользователя в тонком клиенте, отлаживайте именно в тонком.
Сравнение двух конфигураций
Чтобы увидеть, что поменялось после чужой доработки, используйте Конфигурация → Сравнить конфигурации. Слева выбирают одну конфигурацию (основную, БД, поставщика или файл), справа — другую. Результат — дерево объектов с пометками отличий. По каждому модулю можно открыть построчное сравнение текста.
Это лучший способ разобраться в незнакомой базе: сравните основную конфигурацию с конфигурацией поставщика, и все доработки окажутся перед глазами одним списком. Отчёт о сравнении выводится кнопкой «Отчёт» и сохраняется в файл.
Объекты метаданных: как добавить реквизит, форму и код
Типичная задача — добавить поле в справочник или документ. Порядок такой:
- Найдите объект в дереве, например
Справочники → Контрагенты. - Откройте его двойным щелчком. Появится окно редактирования объекта с закладками «Основные», «Данные», «Формы», «Команды» и другими.
- На закладке «Данные» добавьте реквизит кнопкой с зелёным плюсом.
- Задайте имя латиницей или кириллицей без пробелов, синоним и тип значения.
- Чтобы поле появилось на экране, откройте форму элемента и перетащите реквизит из дерева реквизитов формы в дерево элементов.
Модули: где писать код
У каждого прикладного объекта есть несколько модулей. Ошибка в выборе модуля даёт код, который «не срабатывает».
- 📦 Модуль объекта — обработчики
ПередЗаписью,ОбработкаПроведения,ОбработкаЗаполнения. Выполняется на сервере при записи. - 🧰 Модуль менеджера — функции, которые не требуют конкретного экземпляра: печать, выборки, служебные методы.
- 🖥 Модуль формы — реакция на действия пользователя. Директивы
&НаКлиентеи&НаСервереопределяют, где выполняется процедура. - 🌐 Общие модули (ветка «Общие») — переиспользуемый код с флагами «Сервер», «Клиент», «Вызов сервера».
Пример обработчика в модуле объекта документа, который не даёт записать документ без комментария:
Процедура ПередЗаписью(Отказ, РежимЗаписи, РежимПроведения)
Если ПустаяСтрока(Комментарий) Тогда
Сообщить("Заполните комментарий к документу");
Отказ = Истина;
КонецЕсли;
КонецПроцедуры
Изменение типовой конфигурации и расширения
Типовая конфигурация (БП 3.0, ЗУП 3.1, УТ 11) по умолчанию стоит на поддержке без возможности изменения. Объекты в дереве помечены замочком.
Есть два пути:
- Расширение конфигурации
—
Конфигурация → Расширения конфигурации. Изменения хранятся отдельно, типовая остаётся на полной поддержке, обновления ставятся без ручного сравнения. Механизм доступен с платформы 8.3.6. - Включение возможности изменения —
Конфигурация → Поддержка → Настройка поддержки, кнопка «Включить возможность изменения». После этого каждое обновление потребует сравнения и объединения.
Для печатных форм, новых реквизитов и подписок на события сначала пробуйте расширение. Снимать типовую с поддержки стоит, только если расширение задачу не решает.
Отладка и проверка кода в конфигураторе
Отладка запускается клавишей F5 или через Отладка → Начать отладку с выбором клиента. Откроется окно «1С:Предприятие», связанное с конфигуратором.
Порядок поиска ошибки в коде:
- Откройте модуль и поставьте точку останова на нужную строку (
F9). Слева появится красная точка. - Запустите отладку (
F5) и выполните в базе действие, которое вызывает код. - Когда выполнение остановится, наводите курсор на переменные — увидите их значения.
- Пошаговое выполнение:
F10— шаг с обходом процедуры,F11— шаг с заходом в процедуру,Shift+F11— выйти из текущей процедуры. - Для сложных выражений используйте
Shift+F9— окно «Вычислить выражение». Туда можно вписать запрос, функцию или обращение к реквизиту.
Отладка серверного кода
В файловой базе серверный код отлаживается сразу. В клиент-серверном варианте отладку нужно разрешить на сервере 1С: служба агента запускается с ключом -debug. Изменение параметров службы требует её перезапуска, а перезапуск агента обрывает сеансы всех пользователей. Делайте это вне рабочего времени.
Проверки до выпуска изменений
- ✅
Конфигурация → Проверка конфигурации— ищет неразрешимые ссылки, незаполненные обязательные свойства, ошибки модулей в разных режимах выполнения. - ⏱
Отладка → Замер производительности— показывает время выполнения каждой строки. Помогает найти медленный запрос или цикл. - 🧪 Синтаксический контроль
Ctrl+F7— быстрая проверка одного модуля без сохранения всей конфигурации.
Администрирование базы через конфигуратор
Часть задач администратора решается только в конфигураторе. Все они собраны в меню Администрирование.
| Задача | Путь | Монопольный режим |
|---|---|---|
| Создать пользователя, сбросить пароль | Администрирование → Пользователи | Не нужен |
| Выгрузить базу в .dt | Администрирование → Выгрузить информационную базу | Желателен: пока пользователи вносят данные, копия может быть несогласованной |
| Загрузить базу из .dt | Администрирование → Загрузить информационную базу | Нужен |
| Тестирование и исправление | Администрирование → Тестирование и исправление | Нужен |
| Журнал регистрации | Администрирование → Журнал регистрации | Не нужен |
| Активные пользователи | Администрирование → Активные пользователи | Не нужен |
Загрузка .dt заменяет базу целиком — данные, конфигурацию и пользователей. Перед загрузкой выгрузите текущее состояние в отдельный .dt.
Обновление типовой конфигурации
Обновление ставится из файла поставки .cfu или полного .cf поставщика:
- Сделайте резервную копию:
Администрирование → Выгрузить информационную базу. - Откройте основную конфигурацию.
- Выберите
Конфигурация → Поддержка → Обновить конфигурацию. - Укажите файл обновления. Конфигуратор проверит, подходит ли он к текущему релизу.
- Если конфигурация не изменялась, обновление применится к основной конфигурации сразу. Если были доработки — откроется окно сравнения, где решается судьба каждого изменённого объекта.
- Нажмите
F7, примите изменения структуры. - Запустите базу в режиме «1С:Предприятие» — откроется обработка обновления данных. Дождитесь её завершения.
Обновления идут строго по цепочке: файл обновления рассчитан на конкретные предыдущие релизы. Если текущий релиз слишком старый, придётся ставить промежуточные версии по очереди.
Групповая разработка через хранилище
Когда конфигурацию дорабатывают двое и больше, подключают хранилище конфигурации: Конфигурация → Хранилище конфигурации → Подключиться к хранилищу. Хранилище живёт в отдельном каталоге или на сервере хранилища и ведёт историю версий.
Работа с ним строится на трёх действиях:
- Захватить объект — объект блокируется за вами, остальные видят его только для чтения.
- Поместить изменения — правки уходят в хранилище с комментарием и становятся новой версией.
- Получить изменения — вы забираете в свою основную конфигурацию правки коллег.
История версий позволяет откатиться к любому состоянию и увидеть, кто и когда изменил модуль. После получения изменений всё равно нужен F7, чтобы они попали в базу.
Типичные ошибки в конфигураторе и что с ними делать
Здесь разобраны сообщения и ситуации, которые встречаются чаще всего, и способ выйти из каждой.
Конфигурация → Поддержка → Настройка поддержки.F7. Если правки случайные — Вернуться к конфигурации БД.Администрирование → Активные пользователи, попросите людей выйти. Для клиент-серверной базы сеансы видны в консоли кластера. Принудительное завершение сеанса обрывает работу пользователя без сохранения.F7 ещё не нажимали — выполните Вернуться к конфигурации БД. Если уже обновили — восстановите базу из .dt, сделанного до загрузки.Ещё две ошибки, которые стоят дорого:
- 🧨 Правка прямо в рабочей базе. Доработку лучше делать в копии, проверять там и переносить через
.cfили расширение. Иначе ошибка в модуле проведения остановит работу бухгалтерии. - 🔒 Работа с хранилищем без захвата. Если база подключена к хранилищу (
Конфигурация → Хранилище конфигурации), объект нужно захватить перед изменением. Без захвата редактирование недоступно, а при попытке «обойти» это через отключение хранилища вы потеряете синхронизацию с коллегами.
Частые вопросы о работе в конфигураторе
Можно ли работать в конфигураторе, когда пользователи в базе?
Чем .cf отличается от .dt?
Почему кнопка «Конфигуратор» в окне запуска неактивна или вход запрещён?
Администрирование → Пользователи.Как найти, где используется реквизит или процедура?
Ctrl+Shift+F.