Используется для обращения к метаданным объекта конфигурации - общий модуль.
Полное описание, параметры и ограничения
ОбъектМетаданных: ОбщийМодуль (MetadataObject: CommonModule)
ОбъектМетаданных: ОбщийМодуль (MetadataObject: CommonModule)
Доступен, начиная с версии 8.1.
Свойства:
Имя (Name)
Комментарий (Comment)
ОбъектРасширяемойКонфигурации (ExtendedConfigurationObject)
ПринадлежностьОбъекта (ObjectBelonging)
Синоним (Synonym)
ВнешнееСоединение (ExternalConnection)
ВызовСервера (ServerCall)
Глобальный (Global)
КлиентОбычноеПриложение (ClientOrdinaryApplication)
КлиентУправляемоеПриложение (ClientManagedApplication)
Модуль (Module)
ПовторноеИспользованиеВозвращаемыхЗначений (ReturnValuesReuse)
Привилегированный (Privileged)
Сервер (Server)
Методы:
ЕстьИзмененияРасширениямиКонфигурации (ChangedByConfigurationExtensions)
ПолноеИмя (FullName)
Представление (Presentation)
РасширениеКонфигурации (ConfigurationExtension)
Родитель (Parent)
Описание:
Используется для обращения к метаданным объекта конфигурации - общий модуль.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Отделить доступность общего модуля во внешнем соединении от установки COM
Перед проектированием внешнего клиента читаем флаг модуля. Код не создаёт COM-соединение и не требует пароля базы.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Запускайте в учебной копии конфигурации. Примеры читают структуру метаданных, но не создают объекты, не записывают регистры и не проводят документы.
Сверяйте вывод с деревом конфигурации в Конфигураторе. Имена, длины и настройки в УНФ, КА2, БП, УТ 11 и УТ 10.3 могут различаться.
Имена объектов взяты из XML КА2 Progress: C:\claude\KA2\Progress\XML_CF_KA2_PROGRESS. Исходные XML не изменяйте. Выполняйте код только в своей учебной копии соответствующей конфигурации.
В другой конфигурации предварительно найдите аналогичный объект в Конфигураторе и замените только строку имени в поиске. Отсутствие имени обрабатывается до чтения свойств; оно не доказывает отсутствие аналогичной возможности.
Каждый урок запускайте отдельно. Код не вызывает бизнес-функции модулей и обработчики команд, не переключает привилегированный режим и не меняет параметры сеанса.
Описание = Метаданные.ОбщиеМодули.Найти("АвтономнаяРаботаСлужебный");
Если Описание = Неопределено Тогда
ВызватьИсключение "В учебной конфигурации отсутствует ОбщиеМодули.АвтономнаяРаботаСлужебный";
КонецЕсли;
Сообщить(СтрШаблон("%1: внешнее соединение %2; сервер %3",
Описание.Имя, Описание.ВнешнееСоединение, Описание.Сервер));
Если Описание.ВнешнееСоединение Тогда
Сообщить("Изучите экспортные методы для внешнего соединения; соединение здесь не устанавливается");
Иначе
Сообщить("Этот модуль не объявлен доступным во внешнем соединении");
КонецЕсли;Разбор по шагам
Флаг ВнешнееСоединение относится к контексту процедур и функций модуля.
Сервер выводим отдельно: эти контексты нельзя считать одной настройкой.
Наличие экспорта, регистрацию COM, аутентификацию и права проверяют отдельно.
Учебный пример не пытается подключаться к рабочей базе.
Как проверить результат
В предоставленном XML ВнешнееСоединение = Истина; это можно проверить без COMObject.
После запуска не возникло внешнего сеанса базы и не запрашивался пароль.
Ожидаемый результат
Проверена только декларация доступности кода во внешнем контексте.
На что обратить внимание
Флаг не устраняет TYPE_E_LIBNOTREGISTERED и другие ошибки установки компоненты.
Не передавайте секреты через сообщение или жёстко заданную строку соединения.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Выбрать квалифицированное имя функции при переносе примера
Глобальный модуль и неглобальный модуль дают разные способы обращения к экспортным функциям. Мы проверяем настройку, но не придумываем несуществующую функцию.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Запускайте в учебной копии конфигурации. Примеры читают структуру метаданных, но не создают объекты, не записывают регистры и не проводят документы.
Сверяйте вывод с деревом конфигурации в Конфигураторе. Имена, длины и настройки в УНФ, КА2, БП, УТ 11 и УТ 10.3 могут различаться.
Имена объектов взяты из XML КА2 Progress: C:\claude\KA2\Progress\XML_CF_KA2_PROGRESS. Исходные XML не изменяйте. Выполняйте код только в своей учебной копии соответствующей конфигурации.
В другой конфигурации предварительно найдите аналогичный объект в Конфигураторе и замените только строку имени в поиске. Отсутствие имени обрабатывается до чтения свойств; оно не доказывает отсутствие аналогичной возможности.
Каждый урок запускайте отдельно. Код не вызывает бизнес-функции модулей и обработчики команд, не переключает привилегированный режим и не меняет параметры сеанса.
Описание = Метаданные.ОбщиеМодули.Найти("АвтономнаяРаботаСлужебный");
Если Описание = Неопределено Тогда
ВызватьИсключение "В учебной конфигурации отсутствует ОбщиеМодули.АвтономнаяРаботаСлужебный";
КонецЕсли;
Сообщить(СтрШаблон("Имя %1; глобальный %2", Описание.Имя, Описание.Глобальный));
Если Описание.Глобальный Тогда
Сообщить("Экспорт входит в глобальный контекст; проверьте уникальность имён и место выполнения");
Иначе
Сообщить("У неглобального общего модуля перед именем экспортной функции указывают имя модуля");
КонецЕсли;
Сообщить("Синоним для человека: " + Описание.Синоним);
Сообщить("Текст для человека: " + Описание.Представление());
Сообщить("Комментарий разработчика: " + Описание.Комментарий);Разбор по шагам
Поиск использует Имя объекта, а не пользовательское Представление.
Глобальный определяет включение экспорта в глобальный контекст, не доступность на всех клиентах.
Представление и Комментарий помогают найти назначение, но не являются кодом.
Перед переносом вызова найдите существующую экспортную функцию в модуле.
Как проверить результат
Для данного XML Глобальный = Ложь; вывод объясняет необходимость имени модуля.
Сверьте Имя, синоним и комментарий в Конфигураторе; не заменяйте имя модуля текстом его синонима.
Ожидаемый результат
Новичок различает имя API, описание и область видимости экспорта.
На что обратить внимание
Установить Глобальный ради сокращения записи — изменение архитектуры, не косметика.
В примере нет выдуманного вызова функции из типовой конфигурации.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.