Публикация написана по итогам экспериментов, поставленных мной на расширениях версии 8.3.6.2449 и 8.3.7.1845, и не претендует на исчерпывающее описание особенностей поведения тех или иных механизмов. В последующих релизах это поведение может измениться.
Общие моменты поведения
Никакие общие свойства объекта не наследуются и требуют внимания, т.к. по умолчанию копируются «по умолчанию», что вступает в противоречие со свойствами объекта в основной. Так, код с длиной 5 в основной скопируется как 9 в расширение. Поскольку никакое из свойств не может отличаться от основной, за этим стоит следить, выставляя флаги проверки соответствия.
Не наследуются ни владельцы, ни предопределённые данные. С предопределёнными забавная ситуация: в 8.3.6 в их интерфейсе была возможность добавить и удалять предопределённые, но они «не виделись» в Предприятии, а в 8.3.7 и добавлять нельзя, и не наследуется ничего. Предопределённые при наследовании в 8.3.7 уведомляют, что да, можно наследовать, что это действие требует включения режима проверки, и потом их можно изменить «палитрой свойств» - но их так и нет в расширении. Синтакс-подсказка о них не знает, однако обращение в коде модуля нормально отрабатывает. В диалогах конфигуратора (например, при указании списка выбора поля для расширенной) предопределённые основной не видны. При упоминании вида объектов в параметрах выбора поля формы наследует само упоминание, но для предопределённых пишет «Ошибочное значение». Для пустых ссылок сохраняет его, но в списке выбора не даёт, отбор не накладывает. Недостающий вид объекта не добавляет. Более того, при попытке расширить форму, для поля которой в параметрах выбора указано предопределённое значение, искажается и исходная основная форма, т.е. значение делается «ошибочным».
Все действия с метаданными незаимствованных объектов доступны из кода расширения. Все действия с метаданными объектов, созданных только в расширении, доступны из кода основной. Работая с метаданными, нельзя понять, расширен объект/реквизит/форма или нет, просто обращаясь к метаданным (их список всегда строится «по сумме имеющихся»), для этого, казалось бы, можно использовать свойство любого объекта метаданных «ПринадлежностьОбъекта». Но, например, для расширенной формы, как и для заимствованных отчётов/обработок, в любом случае это свойство равно «Собственный» и понять, есть ли они в расширении, нельзя – у расширения нет «своих» метаданных. Даже у объектов, отсутствующих в основной конфигурации, это свойство также равно «Собственный». Найти в метаданных объект со значением принадлежности, равным «Заимствованный», не удалось. Этот вопрос для меня остался открытым.
Добавляемые объекты автоматически расставляются в порядке заимствования, а не в порядке основной конфигурации, что следует учитывать при обходах, в диалогах и т.д.
Закрытие окна расширения без сохранения в рамках оставшегося открытым конфигуратора означает потерю изменений. Если открыто 1 окно расширения, всегда добавляет расширяемый объект туда, даже если расширений в списке несколько, так что будьте внимательны. Выбор расширения предоставляется, только если все окна расширений закрыты или более одного открыто. Если окна неких расширений были сохранены и закрыты, то обновление конфигурации БД по основной не вызывает обновления конфигураций БД этих расширений, т.е. может иметь место расширение сохранённое, но не обновлённое, и в отличие от типовой, никакого сообщения о таком расхождении при запуске «Предприятия» выдаваться не будет, и языковых средств, наподобие «КонфигурацияИзменена» тоже пока нет. Можно использовать некий свой версионный учёт из встроенного языка, с применением свойства расширения «Версия».
В реестре расширений показывается версия только конфигурации БД, а не просто конфигурации расширения. И в конфигураторе, и в предприятии, и в реестре версия конфигурации расширения не видна – только в палитре свойств. Причём, из файла (cfe), в отличие от основной конфигурации, расширения грузятся сразу выполнением автоматического обновления «своей» конфигурации БД в режиме «Предприятие», и со всеми привычными диалоговыми вопросами в режиме «Конфигуратор».
В отличие от основной конфигурации, которую испортить сложно, расширения гораздо более уязвимы – любой обладатель соответствующих прав может «удалить» расширение из списка в режиме «Предприятие», полагая, что лишь временно его отключает; и, если в распоряжении не окажется исходного cfe-файла или не будет архива БД, расширение вообще может быть безвозвратно утеряно. Важно учитывать, что отсутствие прав «Администрирование расширений» у пользователя не влияет на поведение Конфигуратора, где расширения априорно доступны.
Особенность реализации палитры свойств для общих свойств расширения: можно изменить режим и, сняв флаг проверки, оставить его изменённым, при этом свойство станет недоступным для редактирования. В ряде случаев «игры» с этой палитрой приводили к аварийному завершению работы Конфигуратора.
В синтакс-помощнике написано, что свойство глобального контекста «РасширенияКонфигурации» доступно на клиенте – на текущий момент это НЕ так.
Если окно расширения открыто и были изменения, в т.ч. сохранённые, то значка необновлённости конфигурации БД (т.е. «<!>») на её окне нет. Вся функциональность в меню «Конфигурация базы данных» всегда касается основной конфигурации, и никак не применима к расширениям. Способов так же работать с расширением (например, вернуться к конфигурации БД) нет.
При обновлении основной не вызывает обновления расширений. При запуске, если были изменения, отдельно запрашивает подтверждения обновлений конфигураций БД для основной и всех открытых (именно открытых!) расширений, т.е. можно обновлять их «вразнобой», что способно как дать гибкую отладку, так и запутать разработчика. Опять же, это к вопросу, сколько расширений разумно делать – если их у разработчика 10 штук и все открыты, то при каждом запуске отладки диалогов об обновлении будет немало.
Обновление расширения невозможно без перезапуска сеанса, т.е., к сожалению, это не динамически подключаемые модули. Настройка безопасного режима/имени профиля невозможна, если окно расширения открыто в Конфигураторе; изменения, сделанные в «Предприятии», сразу отражаются в Конфигураторе. Удалить из «Предприятия» расширение, если оно открыто в конфигураторе, нельзя. Учтите, что закрытие окна конфигурации расширения закрывает и все связанные с ней окна - т.е. это как с компаундами внешних обработок/отчётов.
С этим моментом связано определённое неудобство работы с расширениями, если вы имеете дело с механизмами типовых конфигураций. Если речь идёт о БСП, то в общем случае, "благодаря" механизму фоновой актуализации расширений, разработчик не может запустить отладку расширения, т.к. механизм типовой конфигурации пытается её удалить, а для этого надо закрыть её окно в конфигураторе; возникает конфликт блокировки расширения:
Кроме того, при такой ситуации процесс обновления БД виснет намертво.
Разработчики БСП предлагают следующий вариант обхода (спасибо mszsuz): следует прописать в коде или прямо в конфигураторе (Сервис -> Параметры -> Запуск 1С:Предприятия -> Параметр запуска) параметр "РежимОтладки". Он учтёт в механизмах БСП. Ссылки по теме: https://partners.v8.1c.ru/forum/topic/1394558 и http://its.1c.ru/db/bspdoc#content:531:hdoc Причём учтите, что при первичной регистрации расширения (первого запуска системы вообще или первого запуска с расширением) оно всё-таки должно быть сохранено и закрыто в конфигураторе; у него обязательно должны быть непустые поставщик и версия. Только после такой регистрации можно держать его открытым, указав "РежимОтладки".
Будем надеяться, что разработчики типовых конфигураций упростят этот момент, либо изменится логика платформы.
В ряде случаев расширения, созданные в версии 8.3.6, не переносятся корректно в версию 8.3.7; так, при попытке открыть расширение из списка было выдано следующее сообщение:
Причины и какие-либо закономерности выявить не удалось, при следующей попытке расширение корректно открылось. По крайней мере в нескольких случаях к этому приводило изменение версии и синонима расширения. Насколько удалось установить, уникально идентифицируют расширение поля "Версия" и "Поставщик", но никак не "Синоним".
Формы
Общее
В заголовке окна конфигуратора невозможно понять, чья форма редактируется – основная или из расширения; при написании кода ориентируйтесь на префиксы, а при работе с диалогом – на приписку к самой форме. Принадлежность к тому или иному расширению, находясь в окне формы на закладке диалога, определить вообще никак нельзя, поэтому рекомендую как-либо маркировать формы, если они наследуются более чем в одно расширение.
Кнопка «Показать сохраненную форму» показывает то, что легло в основу расширенной на момент последнего обновления её из основной конфигурации.
При удалении формы из основной конфигурации её форма-«потомок» не исчезает в расширении, может быть переименована и штатно настроена. При запуске такая форма не будет найдена и произойдёт ошибка подключения расширения. Следует учитывать, что в этом случае при нажатии из диалога расширения кнопки «Показать сохраненную форму» будет выдано сообщение, что «Расширяемая форма не найдена», а при нажатии кнопки «Обновить расширение формы» платформа аварийно завершает работу (падает). Важно: если потом, даже много позже, форму этого объекта с таким именем воссоздать в основной конфигурации, то они заново «подцепятся» друг к другу и всё восстановится, даже УникальныйИдентификатор формы будет одинаковым.
Сначала вызываются обработчики из расширений, в порядке, обратном их регистрации в системе (уточню: не хронологии создания, выгрузки в файл и т.д., а именно хронологии регистрации в конфигураторе и/или в «Предприятии»), последним вызывается обработчик основной конфигурации. Изменить этот порядок нельзя. Более подробные рекомендации по использованию методов встроенного языка для работы с порядком выполнения событий в модуле формы («УстановитьВыполнениеОбработчиковСобытия» и «УстановитьВыполнениеПослеОбработчиковСобытия») см. ИТС.
Функции «РольДоступна» и «ПравоДоступа» верно работают для ролей основной при вызове из расширения. В остальном по работе с ролями см. ИТС, всё так и есть.
Несколько своеобразно ведёт себя подсказка методов, использующих строковые параметры, в модулях расширений . При этом, общая подсказка (например, по «Справочники») даёт в списке все объекты основной конфигурации (а не только расширения, как можно было бы предполагать). Не следует пугаться, это нормально работает:
При повторном обновлении расширенной формы из основной ранее добавленные в расширенной элементы уже не изменяются; вносятся добавленные реквизиты и параметры из основной и при этом не затираются и не изменяются добавленные в расширенной; при удалении в основной и обновлении исчезают из расширенной.
Удаление для расширенной формы параметра, ранее объявленного в основной, вызывает ошибку, если в коде есть обращения к нему, хотя в основной он остаётся. Если в основной параметр есть как ключевой, а в расширенной как обычный, то платформа считает его ключевым, т.е. приоритет не у расширения, но это только пока не обновится ещё раз расширенная – после этого уже приоритет переходит к ней. Аналогично с типами – приоритетнее тип расширения, но только после обновления расширенной. Для уже имеющегося параметра с тем же именем ничего в расширенной не меняет. Аналогично, пока элемента/реквизита нет, берётся из основной, а если есть – из расширенной, и его тип и свойства более приоритетны, т.е. всё как в ИТС (п. 32.5.1)
Элемент формы, добавленный в основной, показывается в итоговой наряду с её изменениями даже без обновления расширенной, при этом отсутствует в синтакс-подсказке и статично объявленном условном оформлении, но позволяет работать с собой в коде, в т.ч. в динамически создаваемом условном оформлении.
Условное оформление наследуется и обновляется (причём изменения расширения приоритетнее, несмотря на утверждение ИТС в п. 32.5.1). Если в условном оформлении упомянут тип, отсутствующий в расширении, то запись об этом перенесётся и уцелеет, и будет работать, но будет недоступна для изменения в диалоге конфигуратора и в ряде случаев вызывает зависание этих диалогов редактирования.
Элементы формы расширения размещаются согласно 32.5.1, даже если были созданы после разделения форм. Если же форма унаследовала некий элемент формы из основной и он затем был удалён в расширении, но остался в основной, то в режиме «Предприятие» он показан не будет, в т.ч. даже если сделать его заново (например, как кнопку по команде).
Все открытия форм, о которых идёт речь в этом исследовании, проверялись с передачей параметров и владельца как открывающей формы, и ни разу использование формы или её элемента (в т.ч. отсутствующего на «другой» стороне) не вызвало проблем.
Типы данных и заимствование
Заимствование, исходя в целом из правильной идеи «всего используемого», работает не вполне корректно – в расширение переносятся объекты, вообще никак не упомянутые, даже совсем косвенно. Точную систему выявить не удалось. Заимствование касается всего, описанного на ИТС, плюс к тому - общие картинки и элементы стиля переносит, если хоть где-то упомянуты в статичном объявлении, и даже если не видны.
При работе в программном коде правильно создаёт и обрабатывает типы и описания типов в расширении для тех, кого в нём нет, в т.ч. при прямой и обратной сериализации различными средствами. При литеральном обращении (СКД, в т.ч. загрузках из xml-файлов) не обрабатывает отсутствующие, но об этом см. ниже.
Элемент/параметр произвольного типа не вызывает переноса всех имеющихся в конфигурации объектов.
При переносе реквизита типа «Характеристика» переносится и «его» план видов характеристик, причём среди типов будут только простые (если они вообще имелись в ПВХ), но правильно унаследованные, с сохранением длины, точности итд.; остальные значения ПВХ, объявленные в основной, будут сброшены, даже если эти типы данных есть в расширении.
Цитата с ИТС: «При заимствовании составных типов будут заимствованы только примитивные типы (Строка, Число и т. д.), а если в составном типе таких типов нет, то будет заимствован только один тип (первый по порядку) и связанный с ним объект конфигурации. Однако, при заимствовании параметрической команды, не происходит заимствование параметра команды и, как следствие, объекта конфигурации, определяющий тип параметра. В случае необходимости следует самостоятельно выполнить заимствование объекта (или объектов, если тип составной) конфигурации, определяющего тип параметра команды и затем указать этот объект в качестве типа параметра заимствованной команды.» Аналогичная картина с определяемыми типами.
В коде расширенной формы можно обращаться к отсутствующим типам («Тип()»), при этом верно определяются, сравниваются, обрабатываются типы значений реквизитов, присвоенных ранее, в т.ч. для реквизитов, созданных уже в расширении. Для полей, связанных с реквизитами типа «Характеристика» и «Произвольный» можно указывать значения и ограничения типа с отсутствующими в расширении типами. Реквизитам типа «Характеристика» (независимо от того, как перенесся ПВХ) и «Произвольный» можно присваивать значения и читать их, даже если такой тип в расширение не переносился.
Реквизиты
Изменение значения реквизита основной из расширенной работает, значение это доступно потом в механизмах основной; изменение значения реквизита расширенной из основной ведёт себя так же.
Реквизит расширенной «не виден» из основной, вызывает ошибку компиляции при прямом обращении, но может быть получен через «Выполнить». Реквизит основной при обращении напрямую из расширенной вызывает ошибку синтакс-контроля, но правильно компилируется, получается как напрямую, так и через «Выполнить».
Клиентские переменные модуля
Рассматривался только случай, когда есть переменная «А» в модуле основной формы, добавленная уже после её расширения, и переменная «Б» в модуле расширенной формы. Напомню, одноимённые переменные (равно, как и процедуры и функции любого объявления) запрещены, вызывают конфликт имён и невозможность подключения.
«Основную» переменную правильно «видно» из расширенной формы. «Расширенную» переменную никак «не видно» из основной формы, даже через «Выполнить». Изменение расширенной переменной из кода основной формы не изменяет её значение, однако изменение основной переменной из кода расширенной формы изменяет её правильным образом.
Процедуры и функции
Синтакс-контроль расширенной формы допускает вызовы клиентских и серверных процедур/функций основной и эти вызовы работают верно. Функции верно возвращают значения, верно меняются переданные по ссылке входные параметры.
Синтакс-контроль основной формы не допускает вызовы клиентских и серверных процедур/функций расширенной формы, а вызов через «Выполнить» позволяет вызывать только серверные (экспортируемые и не-экспортируемые) процедуры, при этом функции верно возвращают значения, верно меняются переданные по ссылке входные параметры. Клиентские экспортируемые платформа по-своему «видит» (процедуру от функции отличает), но нормально не вызывает, а результат функций пуст и имеет тип «Неопределено». Клиентские не-экспортируемые процедуры и функции расширенной формы основная форма «не видит».
Описания оповещений
Вызов процедуры в основной форме из описания оповещения, созданного на расширенной форме, работает, верно передаёт аргумент. Вызов процедуры в расширенной форме из основного описания оповещения с основной формы – тоже.
Значение свойства «ЭтотОбъект» для вызовов из основной и расширенной форм совпадает (что удобно при передаче куда-то вообще вне формы). Если следовать логике, описанной на ИТС, то будут работать и внешние вызовы механизмов, расположенных в основной и расширенной формах, по тем же принципам.
Обработчик ожидания
Подключение обработчика из основной формы (вызываемая процедура находится в расширенной) работает, отключение объявленного в основной работает из расширенной. Подключение обработчика из расширенной формы (вызываемая процедура находится в основной) работает, отключение объявленного в расширенной работает из основной, т.е. всё симметрично. Запущенные из основной и расширенной обработчики нормально работают параллельно одновременно.
Наследование команд
В целом общие, глобальные команды ведут себя, как описано на ИТС, но есть нюансы. Из глобальных наследуются только прямо указанные (независимо от параметризации), т.е. вытаскиваются общие команды, если надо; если команда – некоего объекта (например, обработки), то вытаскивается эта обработка и все упоминания по ней. Важно учесть, что на расширенной форме в итоге они могут быть не видны и, хотя код расширенной работает с этими элементами формы (кнопками, например), никаким образом показать их на форме может не получиться, и придётся всё пересоздавать заново уже в расширенной форме, и именно статически (динамический код ничего не даст).
Коллекция команд общая, поиск в ней верно находит отсутствующие на той или иной стороне, их принудительный вызов верно работает.
Сообщения пользователю
Сообщение пользователю с указанием пути к элементу расширенной формы, вызываемое с основной, и сообщение пользователю с указанием пути к элементу основной формы, вызываемое с расширенной, верно работает, т.е. всё симметрично. Между выведенными подобным образом сообщениями есть сквозная навигация.
Временное хранилище формы
Помещённое в основной форме правильно читается в расширенной. Помещённое в расширенной правильно читается в основной. Не имеет значения, существует ли тип объекта, помещаемого в хранилище и/или читаемого из хранилища, в расширении – всё всегда отрабатывает правильно, с сохранением значений и типизации.
Динамический список с произвольным запросом
Если список как реквизит и как элемент создан в основной, то программно доступен в расширенной, но не виден без полного пересоздания элемента. Программно доступен, даже если не виден. Не вызывает вопросов у синтакс-контроля, но вызывает ошибку выполнения, если отсутствует в расширении. Никак потом не отображается на форме расширения, если создан в основной форме с реквизитом (значением выборки запроса), типа которой нет в расширении. В ряде случаев (не удалось обнаружить какую-либо закономерность) автоматически добавляет недостающий вид объектов в расширение. Если список создан в расширении, и добавлено значение выборки запроса, типа которого нет в расширении, то работает нормально, но не позволяет добавить такое значение (реквизит) в элементы формы (в колонки табличного поля).
При переносе динамических списков с произвольным запросом не переносит в расширение упомянутые в них виды объектов, исключение – если вид объектов упомянут как «ОсновнаяТаблица» в настройке списка. Наличие настроек списка для полей-значений выборки запроса, связанных с объектами, которых нет в расширении, не вызывает перенос упомянутых объектов. Получаются нерабочие, но и не вызывающие ошибку настройки:
Такой список вообще не показывается на форме в режиме «Предприятие».
Список значений с напрямую указанным типом значений вызывает перенос объектов этого типа в расширение, даже если является лишь реквизитом, а не элементом формы. Аналогичное поведение для всех контейнерных объектов-коллекций данных формы.
Обработки, отчёты
Для собственных объектов расширения при выполнении команды «Добавить в расширение» не запрашивается подтверждение обновления уже имеющегося, ранее заимствованного объекта, в отличие от форм. Нигде в интерфейсе не удалось обнаружить команду, позволяющую «обновить» заимствованный объект так, как это можно для формы с помощью «Обновить расширение формы».
Для собственных объектов расширения не выдаётся предупреждение «Объект не включен ни в одну подсистему, отображаемую в командном интерфейсе».
Забавная особенность интерфейса: добавление реквизитов, форм и команд из общего диалога отчёта/обработки недоступно, а по контекстному меню в дереве расширения доступно. При этом добавление табличных частей доступно везде.
Вызов открытия формы обработки расширения из основной конфигурации не даёт подсказки, но верно работает. Вызов открытия форм объектов, отсутствующих в расширении, из формы обработки, не даёт подсказки, но верно работает.
Справочная информация формы в расширении не существует, что надо учитывать разработчику – т.е. итоговая форма в «Предприятии» может быть существенно другого внешнего вида, чем описано во встроенной справке, а отразить это в справке нельзя.
Описания наследуются, и не могут изменяться; гиперссылки в них работают и не вызывают переноса в расширение объектов, с которыми связаны. Гиперссылка из описания объекта основной на описание объекта (в т.ч. формы) расширения делается только путём получения адреса ссылки при работе внутри расширения и последующей ручной вставки этого адреса в html-код описания объекта основной конфы в тег <ahref>; штатным образом это невозможно. Переход из описания объектов расширения на описания объектов основной, не добавленных в расширение, тоже делается только так.
Открытие раздела справки из кода для вида объектов, которого нет в расширении, работает нормально (и ОткрытьСправку, и ОткрытьИндексСправки). Вызов «ОткрытьСправкуФормы()» из расширенной формы вызывает открытие справки такой, какой она задана для объекта/формы в основной конфигурации.
ВАЖНО: справка отчёта/обработки, добавленной в расширении, в неустановленных случаях становится неработоспособна (открывается общая справка по формам) и при F1, и из содержания/индекса, и при ОткрытьСправкуФормы(); но при этом по вышеописанной ссылке продолжает работать. Флаг «Включать в содержание справки» ничего не меняет.
Поведение справки добавленных подсистем в разделах содержания предлагаю изучить самостоятельно.
Макеты наследуются, но недоступны; нельзя даже открыть на просмотр. Обращение в СКД собственного отчёта расширения к отсутствующему виду объектов вызывает ошибку получения информации набора данных. Загрузка из xml схем и/или настроек, содержащих отсутствующие виды объектов через диалоги вызывает их зависание. Загрузка в режиме «Предприятие» и через код, и через диалоги, работает правильно.
Навигационная ссылка формы обработки расширения не отличается по формату от ссылок на основные (видимо, система разбирается по именам). Навигационная ссылка на реквизит объекта, когда объект есть, а реквизита нет в расширении, выглядит как «e1cib/data/Справочник.ДоговорыКонтрагентов.Контрагент?ref=0000000000000000000000 0000000000», где справочник «ДоговорыКонтрагентов» есть в расширении, а реквизита «Контрагент» и такого справочника – нет. Ссылка неработоспособна (переход вызывает ошибку). При этом, ссылка на экземпляр объекта, вида которого нет, нормально работает (так, «"e1cib/data/Справочник.Контрагенты?ref=00000000000000000000000000000000"» вызывает действие, как для создания нового контрагента). Переход по ссылке на обработку/отчёт, добавленные в расширении, из основных команд, работает нормально.
Заключение
В данном обзоре не учтены и не рассмотрены особенности взаимодействия нескольких расширений, в случае наличия во всех них одинаковых объектов (форм и т.д.), поскольку практика показывает, что их взаимоотношения целиком следуют логике взаимоотношений основной конфигурации и расширения с учётом порядка расширений в списке их регистрации и общности контекста результирующего объекта.
Также «за кадром» остаются объекты расширения (веб-сервисы, xdto-пакеты, роли и подсистемы); возможно, это будет предметом отдельной публикации.
Полезные ссылки
Документация от 1С: http://its.1c.ru/db/v837doc#bookmark:dev:TI000001516
Курсы Гилёва&Насипова: http:// /news/how-2-use-extensions-in-8-3-6/
Пример использования: //infostart.ru/public/359597/
Замечу, что на момент публикации методическая информация на сайте, вызываемом контекстно из синтакс-помощника, для всех аспектов, связанных с расширениями, отсутствует.
Любые дополнения, уточнения и опровержения приветствуются.
