Возвращает Истина, если сам объект или один из его дочерних объектов изменен (в том числе, и добавлением нового дочернего объекта) расширениями в текущем сеансе.
Синтаксис
ЕстьИзмененияРасширениямиКонфигурации()Полное описание, параметры и ограничения
ОбъектМетаданных: ОбщийМодуль.ЕстьИзмененияРасширениямиКонфигурации (MetadataObject: CommonModule.ChangedByConfigurationExtensions)
ОбъектМетаданных: ОбщийМодуль (MetadataObject: CommonModule)
ЕстьИзмененияРасширениямиКонфигурации (ChangedByConfigurationExtensions)
Доступен, начиная с версии 8.3.9.
Синтаксис:
ЕстьИзмененияРасширениямиКонфигурации()
Описание:
Возвращает Истина, если сам объект или один из его дочерних объектов изменен (в том числе, и добавлением нового дочернего объекта) расширениями в текущем сеансе.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.3.9.
Методическая информация
Практические примеры
Проверить происхождение четырёх общих объектов при наличии расширений
Одинаковые базовые методы существуют у разных описаний. Сравниваем полные имена, родителя, принадлежность и влияние расширений, не меняя расширения.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Запускайте в учебной копии конфигурации. Примеры читают структуру метаданных, но не создают объекты, не записывают регистры и не проводят документы.
Сверяйте вывод с деревом конфигурации в Конфигураторе. Имена, длины и настройки в УНФ, КА2, БП, УТ 11 и УТ 10.3 могут различаться.
Имена объектов взяты из XML КА2 Progress: C:\claude\KA2\Progress\XML_CF_KA2_PROGRESS. Исходные XML не изменяйте. Выполняйте код только в своей учебной копии соответствующей конфигурации.
В другой конфигурации предварительно найдите аналогичный объект в Конфигураторе и замените только строку имени в поиске. Отсутствие имени обрабатывается до чтения свойств; оно не доказывает отсутствие аналогичной возможности.
Каждый урок запускайте отдельно. Код не вызывает бизнес-функции модулей и обработчики команд, не переключает привилегированный режим и не меняет параметры сеанса.
Описание = Метаданные.ОбщиеМодули.Найти("АвтономнаяРаботаСлужебный");
Если Описание = Неопределено Тогда
ВызватьИсключение "В учебной конфигурации отсутствует ОбщиеМодули.АвтономнаяРаботаСлужебный";
КонецЕсли;
Команда = Метаданные.ОбщиеКоманды.Найти("АрхивСообщенийОбменов");
Если Команда = Неопределено Тогда
ВызватьИсключение "В учебной конфигурации отсутствует ОбщиеКоманды.АрхивСообщенийОбменов";
КонецЕсли;
Картинка = Метаданные.ОбщиеКартинки.Найти("Адрес");
Если Картинка = Неопределено Тогда
ВызватьИсключение "В учебной конфигурации отсутствует ОбщиеКартинки.Адрес";
КонецЕсли;
Реквизит = Метаданные.ОбщиеРеквизиты.Найти("КомментарийЯзык1");
Если Реквизит = Неопределено Тогда
ВызватьИсключение "В учебной конфигурации отсутствует ОбщиеРеквизиты.КомментарийЯзык1";
КонецЕсли;
Объекты = Новый Массив;
Объекты.Добавить(Описание);
Объекты.Добавить(Команда);
Объекты.Добавить(Картинка);
Объекты.Добавить(Реквизит);
Для Каждого Объект Из Объекты Цикл
Сообщить(СтрШаблон("%1: %2", Объект.ПолноеИмя(), Объект.Представление()));
Сообщить(Объект.Родитель() = Метаданные);
Сообщить(Объект.ПринадлежностьОбъекта);
Сообщить("Идентификатор расширяемого объекта: " + Строка(Объект.ОбъектРасширяемойКонфигурации));
Сообщить("Изменён расширениями: " + Строка(Объект.ЕстьИзмененияРасширениямиКонфигурации()));
Расширение = Объект.РасширениеКонфигурации();
Если Расширение = Неопределено Тогда
Сообщить("Объект не добавлен расширением по этому методу");
Иначе
Сообщить("Объект добавлен расширением: " + Расширение.Имя);
КонецЕсли;
КонецЦикла;Разбор по шагам
Находим четыре конкретных описания и складываем их в собственный массив.
ПолноеИмя различает виды объектов; Представление предназначено для человека.
Родитель относится к дереву метаданных, не к владельцу бизнес-записи.
РасширениеКонфигурации показывает добавившее объект расширение; ЕстьИзмененияРасширениямиКонфигурации отвечает на другой вопрос — изменён ли объект в текущем сеансе.
Как проверить результат
Получены четыре блока для ОбщийМодуль, ОбщаяКоманда, ОбщаяКартинка и ОбщийРеквизит; родитель корневых описаний — текущие Метаданные.
В базе без расширений метод добавившего расширения возвращает Неопределено; для объекта основной конфигурации, изменённого расширением, не требуйте ненулевого результата этого метода.
Ожидаемый результат
Разделены добавление объекта расширением, его заимствование и изменение в текущем сеансе.
На что обратить внимание
Не включайте и не отключайте расширения в рабочей базе ради урока.
Принадлежность и идентификатор расширяемого объекта нужно интерпретировать вместе с настройками расширения, не как бизнес-ключ.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Проверить, где доступен общий модуль УчебныеЗадачи
Разбираем флаги созданного учебного общего модуля и объясняем различие между Сервер и Вызов сервера.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Запускайте в учебной копии конфигурации. Примеры читают структуру метаданных, но не создают объекты, не записывают регистры и не проводят документы.
Сверяйте вывод с деревом конфигурации в Конфигураторе. Имена, длины и настройки в УНФ, КА2, БП, УТ 11 и УТ 10.3 могут различаться.
Используйте созданный для уроков общий модуль УчебныеЗадачи с флагом Сервер. Не включайте Привилегированный ради запуска примера.
Для второй проверки меняйте флаг Вызов сервера только у своего учебного модуля в копии базы, а не у типовых модулей.
Модуль = Метаданные.ОбщиеМодули.Найти("УчебныеЗадачи");
Если Модуль = Неопределено Тогда
ВызватьИсключение "Сначала создайте общий модуль УчебныеЗадачи в учебной базе";
КонецЕсли;
Сообщить(Модуль.ПолноеИмя());
Сообщить(Модуль.Представление());
Сообщить(СтрШаблон("%1 (%2)", Модуль.Имя, Модуль.Синоним));
Сообщить(Модуль.Комментарий);
Сообщить(СтрШаблон("Сервер: %1; вызов сервера: %2", Модуль.Сервер, Модуль.ВызовСервера));
Сообщить(СтрШаблон("Управляемый клиент: %1; обычный клиент: %2; внешнее соединение: %3",
Модуль.КлиентУправляемоеПриложение, Модуль.КлиентОбычноеПриложение, Модуль.ВнешнееСоединение));
Сообщить(СтрШаблон("Глобальный: %1; привилегированный: %2", Модуль.Глобальный, Модуль.Привилегированный));
Сообщить(Модуль.ПовторноеИспользованиеВозвращаемыхЗначений);
Если Модуль.Сервер И Не Модуль.ВызовСервера Тогда
Сообщить("Вызывайте процедуру из серверного обработчика. Прямой клиентский вызов серверного модуля этим флагом не разрешён");
КонецЕсли;
Сообщить(Модуль.ЕстьИзмененияРасширениямиКонфигурации());Разбор по шагам
Находим реальный общий модуль по имени и читаем его контексты выполнения.
Сервер отвечает за наличие серверного контекста; ВызовСервера — за возможность соответствующих обращений с клиента.
Отдельно смотрим доступность на клиентах и во внешнем соединении; не считаем их автоматически включёнными.
Привилегированность и повторное использование возвращаемых значений — отдельные настройки, не универсальное исправление ошибок вызова.
Как проверить результат
Вывод флагов совпадает с окном свойств учебного общего модуля.
При Сервер=Истина и ВызовСервера=Ложь выводится пояснение о серверном обработчике.
Изменение флага в Конфигураторе требует обновления конфигурации учебной базы перед повторной проверкой.
Ожидаемый результат
Новичок видит фактические контексты своего модуля и понимает, откуда его вызывать.
На что обратить внимание
Флаг Вызов сервера не отменяет необходимость Экспорт у вызываемого метода.
Метаданные не заменяют просмотр исходного кода модуля: здесь не извлекается его текст.
Не включайте привилегированный режим без анализа прав; пример не требует его.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.