Расширения конфигурации. Полезные советы для разработки Внесение изменений в модуль объекта
В данной статье предлагаю рассмотреть, что такое «расширение конфигурации», как добавить расширение или же отключить его. Начиная с версии 1C 8.3.6.1977 в платформе введен новый механизм – расширения конфигурации. Сначала немного теории.
Расширения представляют в 1С собой что-то вроде параллельных конфигураций, которые автоматически объединяются с основной конфигурацией поставщика. Причем в расширениях можно добавлять как свои объекты, так и заимствовать объекты основной конфигурации.
Для чего нужны расширения?
В первую очередь расширения созданы для облегчения внесения изменений в программу. То есть, если пользователи просят добавить какой-либо функционал, то до появления расширений программистам приходилось снимать конфигурацию с полной поддержки и менять типовую конфигурацию.
Снятие с полной поддержки влечет за собой ряд неудобств:
- пропадает возможность автоматического обновления, что приводит как минимум к увеличению времени на то, чтобы ;
- требуется высокая квалификация специалиста, обслуживающего программу;
- если изменения вносились в стандартные объекты типовой конфигурации, то при обновлении они могут пропасть, то есть замениться опять на типовые, от поставщика.
При использовании расширений при внесении изменений программист не будет трогать типовую конфигурацию. Все изменения будут делаться при помощи расширений, которые (как я писал выше) тоже являются конфигурациями. Таким образом, основная конфигурация останется на полной поддержке.
После обновления основной конфигурации, если произошли в новом релизе какие-то изменения с объектом, который ранее был изменен расширением, то изменения все равно возьмутся из расширения. То есть расширения имеют больший приоритет, чем основная конфигурация.
Видео — расширения в 1С за 45 минут
Получите 267 видеоуроков по 1С бесплатно:
Пример добавления расширения в 1С
Чтобы показать, что такое расширение, лучше привести пример его создания в конфигураторе 1С.
В конфигураторе зайдем в меню «Конфигурация» и выберем пункт «Расширения конфигурации». Откроется окно со списком расширений (если они есть). Нажмем кнопку «Добавить» и добавим новое расширение. Теперь можно открыть конфигурацию расширения:
Как видно, конфигурация расширения имеет точно такую же структуру, как и основная. Только она изначально совершенно чистая, без объектов.
Недавно я писал статью о том, как самим сделать . На её примере я хочу сделать ее встроенной при помощи расширения.
В обработке у меня есть поле со ссылкой на справочник «Организации». Поэтому мне этот справочник необходим. Но мы не будем создавать новый справочник «Организации», тем более что платформа этого и не позволит. Нельзя, чтобы в конфигурации расширения были объекты, одноименные с объектами в основной конфигурации.
Поэтому справочник мы позаимствуем из основной конфигурации:
Теперь нажмем правой кнопкой мышки на «Обработки» и выберем «Вставить внешнюю обработку, отчет…» Таким образом, добавим новую обработку в конфигурацию расширения. Если Вы используете мою обработку, то сразу переименуйте ее, так как в основной конфигурации уже есть обработка с таким именем.
Ну и последний штрих. Я хочу, чтобы моя обработка отражалась в меню «Администрирование». Для этого позаимствуем одноименную подсистему основной конфигурации. Не забудьте указать в обработке, что она относится к этой подсистеме.
Вот такая структура у меня получилась:
Посмотрим, что у нас получилось. Обновляем конфигурацию базы данных и запускаем программу в режиме 1C: Предприятие, и идем в меню «Администрирование». Да, чуть не забыл, конфигурацию расширения необходимо закрыть, иначе программа не запустится:
Начиная с редакции 8.3.6 платформы 1С:Предприятия в ней появился механизм расширения конфигураций .
Он позволяет вносить новый и переопределять существующий функционал без изменения основной (расширяемой) конфигурации. Таким образом у нас появляется масса новых возможностей, недоступных ранее.
Новые возможности
Ограничения
Конечно есть и ограничения:
- В расширения можно добавлять только ограниченный набор новых метаданных. Это подсистемы, роли, отчеты, обработки и некоторые другие.
- В некоторых ситуациях возможны проблемы с отладкой.
Пример использования
Давайте рассмотрим на примере как можно переопределить процедуру общего модуля с использованием расширения конфигурации. То есть это тот случай, когда нам надо оперативно исправить какую-то ошибку без выпуска релиза и обновления основной конфигурации. Итак пусть у нас есть общий модуль professia1c_ry_Расширения .
И в нем простейшая процедура, которая выводит сообщение:
Процедура ВывестиСообщение() Экспорт Сообщение = Новый СообщениеПользователю; Сообщение. Текст = "Это основная конфигурация" ; Сообщение. Сообщить() ; КонецПроцедурыА теперь давайте выведем другое сообщение с помощью расширения. В первую очередь нам конечно же надо создать само расширение. В меню конфигуратора выбираем Конфигурация — Расширение конфигурации
В открывшемся окне жмем кнопку Добавить
и заполняем поля со свойствами расширения. Поля Имя
и Синоним
комментариев не требуют. Префикс будет использоваться имени расширяющей процедуры, которая будет замещать исходную. А в списке Назначение
из трех возможных вариантов (Исправление, Адаптация, Дополнение) выберем Исправление
:
Далее в списке расширений убираем флажки «Безопасный режим, имя профиля безопасности»
и «Защита от опасных действий»
:
Таким образом мы создали расширение. Но если мы откроем его двойным щелчком, то увидим, что дерево метаданных у него пустое. И теперь нам надо добавить в расширение общий модуль.
Для этого в дереве метаданных основной конфигурации щелкаем правой кнопкой по нужному общему модулю и выбираем пункт «Добавить в расширение»
:
И теперь наше расширение будет выглядеть следующим образом:
Но если мы посмотрим на код общего модуля расширения, то увидим, что он пустой. И следующим шагом надо добавить в него процедуру. Снова идем в основную конфигурацию, открываем код общего модуля, щелкаем правой кнопкой по процедуре, снова выбираем пункт «Добавить в расширение»
и в открывшемся окне выбираем тип вызова Вызывать вместо
:
В итоге в общий модуль расширения будет добавлена процедура со следующим кодом:
Как видим в имени процедуры присутствует префикс, который был указан при создании расширения. Теперь остается только доработать код процедуры так как нам нужно:
&Вместо("ВывестиСообщение") Процедура Сообщения_ВывестиСообщение_() Сообщение = Новый СообщениеПользователю; Сообщение. Текст = "Это расширение" ; Сообщение. Сообщить() ; КонецПроцедурыИ теперь можно легко убедиться, что у нас будет выполняться код расширения вместо кода основной конфигурации, если выполнить следующий код:
Professia1c_ry_Расширения. ВывестиСообщение() ;
Предлагаем вашему вниманию новый механизм кастомизации приложений в облачном сервисе «1С:Предприятие через Интернет» (сайт): расширения конфигурации платформы «1С:Предприятие 8».
1. Зачем нужны расширения конфигурации
При работе с прикладными решениями пользователи нередко предъявляют дополнительные требования и пожелания, которые не обеспечиваются стандартной функциональностью «из коробки». Для прикладных решений, реализованных на базе технологической платформы «1С:Предприятие 8», имеется универсальный и удобный механизм адаптации и добавления новых возможностей - расширения конфигурации . Разработчики могут прочесть об этом механизме в документации по платформе «1С:Предприятие 8».
2. Возможности расширений конфигурации
С помощью расширений конфигураций вы можете:
- реализовать интеграцию прикладного решения с другими программами, в том числе с мобильными приложениями посредством веб-сервисов;
- изменять управляемые формы прикладного решения;
- добавлять новые подсистемы, изменять состав подсистем прикладного решения;
- изменять роли прикладного решения, добавляя в них объекты, созданные в расширении;
- изменять командный интерфейс прикладного решения (основного раздела, подсистем), например, убирать «лишние детали» и помещать часто используемые команды «на первый план»;
- изменять поведение системы, например логику проведения документов, посредством подписок на события;
- автоматизировать выполнение любых операций в программе посредством регламентных заданий;
- добавить печатные формы (счет на оплату, индивидуальный дизайн);
- добавить новые обработки (обработчики заполнения документов и табличных частей, печатные формы, произвольные обработки);
- добавить новые отчеты;
- и многое другое.
Многие из этих задач реализовать с помощью дополнительных отчетов и обработок затруднительно или вовсе невозможно.
3. Сравнение с дополнительными отчетами и обработками
Раньше функционал прикладных решений на базе платформы «1С:Предприятие 8» можно было расширять с помощью дополнительных отчетов и обработок. Этот механизм по-прежнему поддерживается (см. по ссылке), но расширения конфигурации использовать предпочтительнее:
- они позволяют сделать все, что возможно с помощью дополнительных отчетов и обработок, и много того, что с помощью дополнительных отчетов и обработок сделать нельзя;
- их проще и удобнее разрабатывать: в сервис загружается то же расширение конфигурации, которое используется для «коробочной» версии приложения. Для загружаемых в сервис расширений не нужно добавлять специальный программный интерфейс и не требуется подготавливать «комплект поставки». Нужно лишь обеспечить выполнение требований сервиса .
4. Порядок разработки и использования
Порядок разработки и использования в сервисе расширений конфигурации аналогичен тому, который используется для дополнительных отчетов и обработок ():
- Авторизация разработчиков. Право на добавление в сервис расширений конфигурации выдается фирмой «1С» сотрудникам обслуживающих организаций сервисасайт со статусом «1С:ЦСК» по их заявкам. Сотрудники этих организаций, получившие право на добавление в сервис расширений конфигурации, получают статус разработчик расширений конфигурации . Подробнее об этом см. в статье по ссылке .
- Разработка расширения. Разработчик расширений конфигурации разрабатывает расширение на своем компьютере, тестирует расширение. Требования к расширениям конфигурации приведены После того, как расширение конфигурации разработано и протестировано, разработчик добавляет его в сервис, как описано в статье по ссылке . Расширение помещается в централизованный каталог расширений сервиса.
- Публикация в сервисе. После успешного прохождения аудита расширение конфигурации получает статус «Опубликовано в сервисе» и может использоваться - то есть, встраиваться в приложения.
Предоставление доступа клиентам (абонентам). Если правообладателем расширения конфигурации является обслуживающая организация, то она может:
- использовать расширение в своих приложениях;
- предоставить доступ к расширению своим клиентам (обслуживаемым абонентам) - одному, некоторым по своему выбору или всем (см. статью по ссылке).
Если правообладателем расширения конфигурации является клиент (абонент), по заявке которого разработано расширение, то:
- клиент получает доступ к этому расширению конфигурации автоматически;
- расширение конфигурации может использоваться только в приложениях этого клиента.
- Установка в приложения. Владельцы абонентов , имеющих доступ к расширению конфигурации, могут установить его в свои приложения (см. статью по ссылке).
Аудит расширения. При добавлении в сервис расширения конфигурации или его новой версии расширение автоматически направляется на аудит . Аудит выполняется сотрудниками провайдера (администратора) сервиса.
Условия разработки, предоставления клиентам и сопровождения расширений конфигурации каждая обслуживающая организация определяет самостоятельно.
5. Сопровождение и обновление
Сопровождение расширений конфигурации выполняет обслуживающая организация. Клиент должен обращаться к своей обслуживающей организации по вопросам исправления ошибок, изменений и доработок функционала расширения конфигурации.
При каждом обновлении приложения , опубликованного в сервисе, обслуживающей организации рекомендуется проверить работоспособность опубликованного в сервисе расширения конфигурации и при необходимости выполнить его доработку. В случае существенных изменений в приложениях фирма «1С» будет стараться заранее оповещать об этом обслуживающие организации (партнеров со статусом «ЦСК»), в частности, публиковать ознакомительные версии приложений на сайте «1С:Обновление программ» , чтобы обслуживающие организации могли заранее адаптировать разработанные ими расширения конфигурации к новой версии приложения.
6. Примеры расширений конфигурации
6.1. Пример 1: вывод сведений о погоде
Расширение конфигурации «Демо:Погода» (его можно скачать ) показывает, как в приложении можно вывести информацию, полученную из внешней системы посредством выполнения HTTP-запроса.
Расширение отображает в начальной странице приложения сведения о погоде, полученные через публичный API с погодного сайта http://api.wunderground.com .
В составе расширения реализована общая форма, при открытии которой выполняется HTTP-запрос для получения местоположения. По полученному местоположению также с помощью HTTP-запросов выполняется получение данных о текущей погоде и картинки погоды. Информация выводится на форму и обновляется каждый час. Результат можно увидеть на рисунке:
Расширению конфигурации необходим доступ к внешним ресурсам (ресурсам интернет), поэтому его работоспособность обеспечивается только при подключении в небезопасном режиме. При установке расширения необходимо выполнить запрос небезопасного режима подключения с требованием доступа к внешним ресурсам:
- http://api.wunderground.com - определение местоположения и получение сведений о погоде;
- http://icons.wxug.com - получение картинки погоды.
Расширение совместимо с любой конфигурацией, так как не заимствует объектов из расширяемой конфигурации.
6.2. Пример 2: предоставление ленты новостей
Расширение конфигурации «Демо:RSS» (его можно скачать ) показывает, как приложение может предоставлять данные внешней системе - например, мобильному приложению.
Приложение создает внешний программный интерфейс для получения информации в формате RSS, используемом лентами новостей, о последних десяти поступлениях в кассу для конфигурации «Бухгалтерия предприятия, редакция 3.0». В составе расширения реализован XDTO-пакет (URI пространства имен http://www.w3.org/2005/Atom):
а также HTTP-сервис, возвращающий информацию о последних десяти поступлениях в кассу, полученную по данным документов «Приходный кассовый ордер».
Для удобства подключения к RSS-ленте расширение выводит в начальной странице приложения:
- гиперссылку с адресом ленты новостей;
- QR-код с адресом ленты новостей - для чтения с помощью камеры мобильного устройства.
При отображении на мобильном устройстве полученной ленты новостей пользователь получит сведения о последних поступлениях в кассу:
Для генерации QR-кода расширение конфигурации обращается к внешнему ресурсу http://api.qrserver.com , поэтому это расширение также должно подключаться в небезопасном режиме.
Механизм расширения конфигурации – это специальный механизм, предназначенный для доработки расширяемой конфигурации без изменения этой конфигурации (в том числе без снятия с поддержки).
При рассмотрении механизма расширения конфигурации будут использоваться следующие термины:
- Расширяемая конфигурация – основная конфигурация информационной базы, для которой применяется расширение или для которой расширение разрабатывается.
- Расширение конфигурации – набор объектов конфигурации, подключаемых к расширяемой конфигурации и содержащий набор объектов, добавляемых к расширяемой конфигурации. Расширение может включать в себя как объекты расширяемой конфигурации, так и объекты, которые отсутствуют в расширяемой конфигурации.
- Собственный объект – самодостаточный объект конфигурации, который может находиться как в расширяемой конфигурации, так и в расширении (отчет, обработка или подсистема).
- Заимствованный объект – собственный объект, добавленный в расширение конфигурации.
- Расширяемый объект – собственный объект, для которого в заимствованном объекте изменены какие-либо параметры (свойства, формы и т. д.).
- Расширяющий объект – это заимствованный объект, в который внесены изменения относительно расширяемого объекта. Наличие в заимствованном объекте только контролируемых свойств не делает заимствованный объект расширяющим.
- Результирующий объект – это собственный объект плюс объединение всех расширяющих объектов (если расширений несколько). Если для собственного объекта нет расширяющих объектов – он становится результирующим «без изменений». Т.е. в конфигурации, с которой работает пользователь – все объекты являются результирующими, вне зависимости от наличия и количества установленных расширений.
- Расширяющее свойство – свойство заимствованного объекта, которое изменяет одноименное свойство расширяемого объекта.
- Контролируемое свойство – свойство заимствованного объекта, значение которого проверяется при подключении расширения к расширяемой конфигурации. Если при подключении расширения (в режиме 1С:Предприятие) значение контролируемого свойства в расширении не совпадет со значением этого же свойства в расширяемой конфигурации, расширение не будет подключено.
- Модифицируемое свойство – свойство заимствованного объекта, значение которого в результирующем объекте будет получаться из расширения.
Свойство заимствованного объекта не может быть одновременно контролируемым и модифицируемым.
Основное назначение расширения конфигурации – это доработка прикладного решения при внедрении (или в «облаке») под нужды клиента. При этом дорабатываемую конфигурацию не надо снимать с поддержки. В результате сохраняется простота обновления типового прикладного решения, стоящего на поддержке, с необходимостью выполнять доработки. При разработке расширения следует понимать некоторые особенности функционирования расширения конфигурации. Так, расширяемая конфигурация в любой момент может быть изменена, например, в результате обновления. При этом разработчик расширения не может никак повлиять на возможность или невозможность обновления. Также следует учитывать тот факт, что в системе могут функционировать более одного расширения и автор каждого расширения (в общем случае) не знает, как функционирует другое расширение.
Расширение создается в конфигураторе, хранится в информационной базе и может быть сохранено в файл. Для добавления (подключения) расширения, сохраненного в файл, в прикладное решение конкретного клиента нет необходимости использовать конфигуратор. Подключить расширение можно с помощью специальной стандартной функции (Все функции – Стандартные – Управление расширениями конфигурации). Подключить расширение также можно с помощью инструментария прикладного решения, которое использует программный интерфейс, предоставляемый платформой. Подключение расширения (интерактивно или из встроенного языка) возможно или в небезопасном режиме или в том случае, когда профиль безопасности, под управлением которого работает сеанс, разрешает доступ к подключаемому расширению.
В качестве расширяемых объектов могут выступать:
- Управляемые формы;
- Роли;
- Подсистемы;
- Настройки начальной страницы (рабочего стола) прикладного решения;
- Общие модули;
- Модули объектов для всех типов объектов;
- Модули менеджеров для всех типов объектов;
- Модуль сеанса;
- Модуль управляемого приложения;
- Модуль внешнего соединения;
- Модули команд.
В качестве собственных объектов расширения могут выступать:
- Подсистемы;
- Обработки;
- Отчеты;
- Реквизиты, табличные части и реквизиты табличных частей в заимствованных обработках и отчетах;
- Роли;
- XDTO-пакеты;
- Web-сервисы;
- HTTP-сервисы;
- WS-ссылки;
- Общие макеты;
- Общие команды;
- Общие модули (кроме глобальных серверных и привилегированных общих модулей);
- Группы команд;
- Общие картинки;
- Формы, макеты и команды заимствованных объектов:
- Планов обмена;
- Критерев отбора;
- Хранилищ настроек;
- Справочников;
- Документов;
- Журналов документов;
- Перечислений;
- Отчетов;
- Обработок;
- Регистров сведений;
- Регистров накопления;
- Регистров бухгалтерии;
- Регистров расчета;
- Планов видов характеристик;
- Планов счетов;
- Планов видов расчета;
- Бизнес-процессов;
- Задач;
- Таблиц внешних источников данных;
- Кубов внешних источников данных;
- Таблиц измерений внешних источников данных.
Среди контролируемых свойств следует особо выделить:
- Состав плана обмена;
- Предопределенные элементы для справочников, планов видов характеристик, планов счетов и планов видов расчетов.
В базовых версиях прикладных решений работа с расширениями не поддерживается.