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