Тип: КоллекцияОбъектовМетаданных. Коллекция объектов метаданных, которые описывают все общие модули, определенные в конфигурации. Элементами коллекции являются объекты типа ОбъектМетаданных: ОбщийМодуль.
Полное описание, параметры и ограничения
ОбъектМетаданныхКонфигурация.ОбщиеМодули (ConfigurationMetadataObject.CommonModules)
ОбъектМетаданныхКонфигурация (ConfigurationMetadataObject)
ОбщиеМодули (CommonModules)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: КоллекцияОбъектовМетаданных.
Коллекция объектов метаданных, которые описывают все общие модули, определенные в конфигурации.
Элементами коллекции являются объекты типа ОбъектМетаданных: ОбщийМодуль.
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 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, описание и область видимости экспорта.
На что обратить внимание
Установить Глобальный ради сокращения записи — изменение архитектуры, не косметика.
В примере нет выдуманного вызова функции из типовой конфигурации.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.