Как писать расширения для 1С: от идеи до публикации

Расширения в 1С:Предприятие стали неотъемлемой частью современной разработки — они позволяют модифицировать типовую конфигурацию без изменения её исходного кода. Это решение идеально подходит для адаптации программы под специфические бизнес-процессы, когда обновления от вендора не должны ломать ваши доработки. Однако создание расширений требует не только знания 1С:Языка программирования, но и понимания архитектуры платформы, правил совместимости и лучших практик поддержки.

В этой статье мы разберём весь процесс — от подготовки среды разработки до публикации готового расширения. Вы узнаете, какие инструменты использовать для отладки, как избежать конфликтов с обновлениями типовой конфигурации, и какие скрытые возможности платформы 8.3.20+ упростят вашу работу. Материал ориентирован на разработчиков с опытом работы в 1С, но будет полезен и тем, кто только начинает осваивать механизм расширений.

1. Что такое расширение 1С и когда его использовать

Расширение в 1С:Предприятие — это отдельный файл конфигурации (.cf или .cfe), который подключается к основной базе и модифицирует её поведение. В отличие от внешних обработок или отчётов, расширения могут:

• 🔹 Добавлять новые объекты (справочники, документы, отчёты) в типовую конфигурацию.
• 🔹 Изменять существующие формы без редактирования исходного кода.
• 🔹 Переопределять модули (например, добавлять свою логику в обработчики событий).
• 🔹 Расширять функционал без блокировки обновлений от 1С.

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

• ⚠️ Нельзя удалять или полностью заменять объекты типовой конфигурации.
• ⚠️ Не все свойства объектов доступны для модификации (например, нельзя изменить тип данных реквизита).
• ⚠️ Сложные доработки могут потребовать комбинации расширений и внешних обработок.

⚠️ Внимание: Механизм расширений активно развивается. В версиях 1С:Предприятие 8.3.20+ появилась поддержка расширений для мобильного клиента и веб-интерфейса, но некоторые функции (например, работа с HTTPСервисами) могут требовать дополнительных настроек.

2. Подготовка среды разработки

Для создания расширений вам потребуется:

1. Платформа 1С:Предприятие 8.3.20+ (лучше последняя стабильная версия).
2. Конфигуратор с правами администратора.
3. Тестовая база (копия рабочей или чистая типовая конфигурация).
4. Редактор кода (встроенный в конфигуратор или внешний, например, VS Code с плагином 1C-Syntax).

Процедура ПриЗаписи(Отказ, РежимЗаписи) Экспорт
Если РежимЗаписи = РежимЗаписиДокумента.Проведение Тогда
Сообщить("Документ проведён с комментарием: " + Объект.КомментарийМенеджера);
КонецЕсли;
КонецПроцедуры

&НаКлиенте
Процедура ПечатьЭтикеток(Команда)
ПечатьЭтикетокНаСервере(Объект.Ссылка);
КонецПроцедуры

&НаСервере
Процедура ПечатьЭтикетокНаСервере(СсылкаНаДокумент)
// Логика печати этикеток
Сообщить("Печать этикеток для документа " + СсылкаНаДокумент);
КонецПроцедуры

{
"id": "com.yourcompany.ext.salescomments",
"version": "1.0.2",
"name": "Комментарии к продажам",
"description": "Добавляет поле для комментариев менеджера в документы реализации",
"compatible": ["Бухгалтерия предприятия 3.0 (3.0.120.х)"],
"author": "Ваша компания",
"support": "support@yourcompany.ru"
}

/SalesExtension/
├── src/
│   ├── Документы.РеализацияТоваровУслуг.epf
│   ├── Формы.epf
│   └── Модули.epf
├── tests/
│   └── ТестовыеСценарии.epf
├── docs/
│   └── Инструкция.md
└── releases/
├── v1.0.0.cfe
└── v1.1.0.cfe

Если Не ЗначениеЗаполнено(ПользователиИнформационнойБазы.ТекущийПользователь().Роли.Найти("МенеджерыПоПродажам")) Тогда
Возврат;
КонецЕсли;