Режим «Конфигуратор» в 1С:Предприятии 8.3: метаданные, код, отладка и обновление
Содержание
Конфигуратор 1С — это режим запуска платформы 1С:Предприятие 8.3, в котором программист меняет саму программу: структуру данных, формы, отчёты, код модулей. Открывается он кнопкой Конфигуратор в окне запуска или командой 1cv8.exe DESIGNER. Пользователь вносит документы в режиме «1С:Предприятие», разработчик в это время описывает, какими эти документы должны быть, — в Конфигураторе.
Кроме разработки, здесь же делают административную работу: выгружают базу в .dt, заводят пользователей, обновляют типовую конфигурацию
, запускают тестирование и исправление. Поэтому в Конфигуратор заходит не только программист, но и администратор базы, а иногда и опытный бухгалтер, который сам ставит обновления.
Зачем нужен Конфигуратор и что в нём делают
Любая конфигурация — Бухгалтерия, ЗУП, УТ или самописная — это набор объектов метаданных и кода на встроенном языке. Конфигуратор — среда, где этот набор создают и меняют.
Основные задачи по ролям:
- 🛠 Программист — добавляет реквизиты и объекты, правит формы, пишет код модулей, отлаживает, собирает запросы конструктором, создаёт расширения.
- 🔄 Администратор — обновляет типовую конфигурацию через механизм поддержки, применяет изменения к базе данных, ведёт список пользователей и ролей.
- 💾 Тот, кто отвечает за сохранность данных — выгружает и загружает информационную базу, запускает тестирование и исправление, сохраняет конфигурацию в файл
.cf.
Что Конфигуратор не делает: в нём не вводят документы и не формируют отчёты для работы. Для проверки своей доработки программист запускает режим «1С:Предприятие» прямо из Конфигуратора — обычно в режиме отладки.
Кроме Конфигуратора у фирмы 1С есть отдельная среда разработки 1С:Enterprise Development Tools (EDT) на базе Eclipse. Она удобна для командной работы с Git, но для обновления типовых конфигураций, выгрузки .dt и администрирования базы Конфигуратор всё равно остаётся основным инструментом.
Как открыть режим Конфигуратора
Два рабочих способа.
- Из окна запуска. Выделите базу в списке и нажмите
Конфигуратор. Платформа спросит пользователя и пароль, если в базе есть пользователи. - Из командной строки. Подходит для ярлыков и скриптов:
"C:\Program Files\1cv8\8.3.24.1691\bin\1cv8.exe" DESIGNER /F"D:\Bases\Buh" /N"Администратор" /P"пароль"
Для серверной базы вместо /F указывают /S"имя_сервера\имя_базы". Номер версии в пути подставьте свой — он должен совпадать с версией, под которой работает база.
Из открытого режима «1С:Предприятие» в Конфигуратор не перейти: это отдельное приложение. Зато оба окна можно держать открытыми одновременно.
Тонкий клиент 1cv8c.exe Конфигуратор не открывает. Если на компьютере установлен только тонкий клиент, кнопки Конфигуратор в окне запуска не будет — нужна установка компонента «1С:Предприятие» (толстый клиент) с конфигуратором.
Права тоже имеют значение. Пользователь, у которого в базе нет права на администрирование или на открытие Конфигуратора, получит отказ при входе. Если пользователей в базе нет совсем, Конфигуратор открывается без пароля.
Дерево метаданных и окна интерфейса
После входа рабочее место пустое. Первое действие — Конфигурация → Открыть конфигурацию. Слева появится дерево метаданных: это и есть «скелет» программы.
Из чего состоит дерево
Ветки идут в постоянном порядке. Основные:
| Ветка | Что хранит | Пример |
|---|---|---|
| Общие | Подсистемы, общие модули, роли, общие формы, макеты, регламентные задания | Роль «Бухгалтер», общий модуль с функциями печати |
| Константы | Одиночные значения | Основная организация |
| Справочники | Списки однотипных элементов | Номенклатура, Контрагенты |
| Документы | Хозяйственные операции | Реализация товаров и услуг |
| Перечисления | Фиксированные наборы значений | Виды договоров |
| Отчёты и Обработки | Встроенные отчёты и инструменты | Оборотно-сальдовая ведомость |
| Планы счетов, видов характеристик, видов расчёта | Счета, произвольные характеристики, виды начислений | План счетов хозрасчётный |
| Регистры | Сведений, накопления, бухгалтерии, расчёта | Регистр бухгалтерии с проводками |
| Бизнес-процессы и задачи | Маршруты согласования | Согласование заявки |
Раскройте любой объект — внутри будут реквизиты, табличные части, формы, команды, макеты. Двойной щелчок открывает окно редактирования объекта с вкладками.
Что ещё есть на экране
- 📝 Палитра свойств — свойства выделенного объекта или реквизита: имя, синоним, тип, проверка заполнения.
- 🔍 Поиск в дереве — строка над деревом фильтрует объекты по имени. В типовой БП их тысячи, вручную искать бесполезно.
- 🔗 Поиск ссылок на объект — в контекстном меню объекта. Показывает, где он используется: в каких документах, регистрах, ролях. Нужен перед любым удалением.
- 🧩 Синтакс-помощник — справочник по встроенному языку и методам платформы, открывается из меню
Справка.
Имя объекта — техническое (РеализацияТоваровУслуг), синоним — то, что видит пользователь («Реализация (акты, накладные, УПД)»). В коде всегда используется имя. Когда ищете объект по названию из пользовательского интерфейса, вводите в поиск часть синонима — дерево умеет искать и по нему.
Чем Конфигуратор отличается от режима «1С:Предприятие»
Это два режима одной платформы и одной базы, а не две программы. Разница — в том, с чем вы работаете.
| Параметр | Конфигуратор | 1С:Предприятие |
|---|---|---|
| Для кого | Разработчик, администратор | Бухгалтер, кадровик, менеджер |
| Что меняется | Структура, формы, код | Данные: документы, справочники |
| Исполняемый файл | 1cv8.exe с параметром DESIGNER | 1cv8.exe (толстый клиент) или 1cv8c.exe (тонкий) |
| Ключ запуска | DESIGNER | ENTERPRISE |
Выгрузка базы в .dt | Есть | Нет |
| Обновление типовой | Через поддержку конфигурации | Через встроенный механизм обновления (если конфигурация без изменений) |
| Работа с кодом | Редактор модулей, отладчик | Нет |
Последняя строка про обновление важна на практике. Типовая конфигурация без доработок умеет обновляться из режима «1С:Предприятие» сама. Если же её меняли в Конфигураторе — включили возможность изменения, — обновлять придётся через Конфигуратор, с объединением изменений.
Модули, код и отладка
Код на встроенном языке 1С живёт в модулях. Модули бывают разных видов, и от вида зависит, где и когда код выполняется.
- 📄 Модуль объекта — события самого документа или справочника:
ПередЗаписью,ОбработкаПроведения. - 📋 Модуль формы — поведение формы: нажатия кнопок, изменение полей. Здесь директивы
&НаКлиентеи&НаСерверерешают, на какой стороне работает процедура. - 🗂 Модуль менеджера — функции, которые относятся ко всему виду объектов, а не к одному элементу.
- 🧰 Общие модули — общие процедуры для всей конфигурации; у каждого настраивается, где он доступен: клиент, сервер, вызов сервера.
Инструменты при написании кода
- Конструктор запроса — открывается из контекстного меню в модуле. Собирает текст запроса мышкой: таблицы, поля, условия, группировки.
- Проверка синтаксиса —
Ctrl+F7для текущего модуля. Перед сохранением конфигурации есть смысл запустить и общую проверку из менюКонфигурация. - Контекстная подсказка —
Ctrl+Пробелвыдаёт методы и свойства по месту.
Пример простого обработчика в модуле объекта документа: запрет записи без контрагента.
Процедура ПередЗаписью(Отказ, РежимЗаписи, РежимПроведения)
Если НЕ ЗначениеЗаполнено(Контрагент) Тогда
ОбщегоНазначения.СообщитьПользователю("Не указан контрагент", ЭтотОбъект, "Контрагент", , Отказ);
КонецЕсли;
КонецПроцедуры
ОбщегоНазначения.СообщитьПользователю есть в типовых конфигурациях на БСП. В самописной без БСП используйте объект СообщениеПользователю и установите Отказ = Истина вручную.
Как отлаживать
- Поставьте точку останова на строке кода —
F9или двойной щелчок по полю слева от строки. - Запустите отладку —
F5илиОтладка → Начать отладку. Откроется режим «1С:Предприятие», уже подключённый к отладчику. - Выполните действие, которое вызывает код: запишите документ, нажмите кнопку.
- Выполнение остановится на точке. Дальше идите по шагам:
F11— с заходом в вызываемую процедуру,F10— без захода. - Значения переменных смотрите в окне вычисления выражений или в «Табло» — туда можно добавить выражение и следить за ним на каждом шаге.
Для серверной базы отладку на сервере сначала разрешают: служба сервера 1С должна быть запущена с ключом -debug, иначе точки останова в серверном коде не сработают. Меняется ключ в параметрах службы, а перезапуск службы оборвёт сеансы всех пользователей — делайте это вне рабочего времени.
Конфигурация базы данных и основная конфигурация: как их синхронизировать
Новички чаще всего спотыкаются здесь. В базе хранятся две конфигурации:
- Основная конфигурация — та, которую вы редактируете в дереве метаданных. Сюда попадают все ваши правки.
- Конфигурация базы данных — та, по которой реально работают пользователи. Её напрямую не редактируют.
Пока вы не применили изменения, пользователи их не видят. Признак расхождения — значок или звёздочка в заголовке дерева и активная команда обновления.
Как применить изменения
- Сохраните основную конфигурацию —
Конфигурация → Сохранить конфигурацию. - Выполните
Конфигурация → Обновить конфигурацию базы данных(клавишаF7). - Платформа покажет список изменений структуры: какие таблицы создаются, какие реквизиты меняются. Проверьте его и нажмите
Принять.
Если изменения затрагивают структуру хранения — новые реквизиты, новые объекты, смена типов, — для их применения в базе не должно быть других сеансов. Платформа сообщит об этом и предложит варианты. Динамическое обновление, при котором пользователи остаются в базе, возможно не для всех изменений, и работающим людям потом всё равно придётся перезайти.
Перед обновлением конфигурации базы данных в рабочей базе сделайте выгрузку .dt через Администрирование → Выгрузить информационную базу. Реструктуризация больших таблиц может идти долго, и откатить её без копии нельзя.
Обратная операция
Бывает, что основную конфигурацию испортили неудачными правками и хотят вернуться к работающей. Для этого есть Конфигурация → Конфигурация базы данных → Вернуться к конфигурации БД. Все несохранённые в базу изменения основной конфигурации пропадут.
Сохранить снимок конфигурации отдельно от данных можно командой Конфигурация → Сохранить конфигурацию в файл — получится файл .cf. Он весит гораздо меньше .dt и подходит, чтобы держать версии доработок.
Поддержка, сравнение и объединение конфигураций
Типовые конфигурации приходят «на поддержке» у поставщика. Это значит, что платформа знает, какая версия поставщика лежит в основе вашей, и умеет накатывать новые релизы.
Режимы поддержки
Настройка — Конфигурация → Поддержка → Настройка поддержки. По умолчанию типовая закрыта от изменений. Кнопка «Включить возможность изменения» открывает её, после чего для каждого объекта можно выбрать правило:
| Правило | Что происходит при обновлении |
|---|---|
| Объект поставщика не редактируется | Объект обновляется автоматически, править его нельзя |
| Объект редактируется с сохранением поддержки | Можно менять; при обновлении изменения поставщика и ваши объединяются |
| Объект поставщика снят с поддержки | Обновления поставщика к объекту не применяются |
Вернуть конфигурацию на полную поддержку после включения изменений непросто. А пока изменения включены, типовая не обновляется автоматически из режима «1С:Предприятие», каждый релиз ставят в Конфигураторе.
Сравнение и объединение
Команда Конфигурация → Сравнить конфигурации показывает различия между любыми двумя: основной, конфигурацией БД, файлом .cf, конфигурацией поставщика. Отличающиеся объекты подсвечиваются, по модулям можно открыть построчное сравнение.
При обновлении изменённой типовой через Конфигурация → Поддержка → Обновить конфигурацию платформа строит трёхстороннее сравнение:
- старая версия поставщика;
- новая версия поставщика;
- ваша текущая конфигурация.
Для объектов, которые меняли и вы, и поставщик, нужно решить, чья версия побеждает, или объединить модули по процедурам. Здесь проходит граница между обновлением «за пять минут» и обновлением на полдня.
Расширения вместо правки типовой
Начиная с платформы 8.3.6 доработки можно выносить в расширения: Конфигурация → Расширения конфигурации. Расширение лежит поверх типовой, саму типовую не трогает, и она продолжает обновляться штатно. Для типовых конфигураций это основной способ дорабатывать без снятия с поддержки.
Командная работа
Если в одной конфигурации работают несколько программистов, подключают хранилище: Конфигурация → Хранилище конфигурации → Подключиться к хранилищу. Объект захватывают на редактирование, правят, помещают обратно. Двое одновременно один объект не изменят, а история версий сохраняется в хранилище.