Тип: Строка. Строка произвольных символов - синоним имени объекта метаданных.
Полное описание, параметры и ограничения
ОбъектМетаданных: РегистрНакопления.Синоним (MetadataObject: AccumulationRegister.Synonym)
ОбъектМетаданных: РегистрНакопления (MetadataObject: AccumulationRegister)
Синоним (Synonym)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: Строка.
Строка произвольных символов - синоним имени объекта метаданных.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Проверить подпись списка регистра, не путая её с именами товаров
Регистр остатков хранит движения, а настройки представления относятся к интерфейсу его списка. Читаем подготовленные подписи и родителя схемы.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Создайте НОВУЮ пустую файловую базу, имя корневой конфигурации УчебныеОстатки85. Не добавляйте эти объекты в УТ/КА2/УНФ/БП. Режим управления блокировкой данных конфигурации — Управляемый.
Документы → Добавить: УчебноеДвижение85. Номер: Строка длиной 40, автонумерация выключена. Модули объекта и менеджера оставьте пустыми; не добавляйте обработчики, подписки и обязательные пользовательские реквизиты.
Регистры накопления → Добавить: УчебныеОстатки85. Вид регистра Остатки. Единственное измерение КодТовара: Строка 50, индексировать, проверка заполнения Показывать ошибку. Единственный ресурс Количество: Число 12,3, неотрицательное. Дополнительных реквизитов нет.
В списке регистраторов выберите только собственный документ УчебноеДвижение85. Оставьте модули регистра пустыми, использование итогов включённым. Планы обмена, разделители, историю данных и фоновые задания для урока не создавайте.
Обновите конфигурацию базы данных. Создайте серверный общий модуль УчебныеЗадачи и команду собственной обработки. Фрагмент вставьте внутрь ВыполнитьПример() Экспорт; запускайте задачи по отдельности.
Первые задачи работают с незаписанными наборами. Только задачи с пометкой «в собственной транзакции» временно записывают два собственных документа и движения, затем обязательно отменяют транзакцию. В рабочей базе этот код не запускайте.
В этом разделе код ТОЛЬКО ЧИТАЕТ метаданные УчебныеОстатки85. Наборы, документы, транзакции, блокировки и запись движений не создаются.
Не создавайте пользовательские формы, команды, макеты и дополнительные индексы у учебного регистра; расширения не устанавливайте.
В Конфигураторе у регистра задайте Синоним=Учебные остатки, ПредставлениеСписка=Учебные движения товаров, РасширенноеПредставлениеСписка=Список учебных движений товаров.
Пояснение=Только собственные учебные движения, Комментарий=Регистр для обучения, не рабочие остатки. Обновите конфигурацию БД.
Если Метаданные.Документы.Количество() <> 1
Или Метаданные.РегистрыНакопления.Количество() <> 1
Или Метаданные.Документы.Найти("УчебноеДвижение85") = Неопределено Тогда
ВызватьИсключение "Разрешены только собственный учебный документ и регистр";
КонецЕсли;
Описание = Метаданные.РегистрыНакопления.Найти("УчебныеОстатки85");
Если Описание = Неопределено Тогда
ВызватьИсключение "Сначала создайте собственный учебный регистр";
КонецЕсли;
Если Описание.ВидРегистра <> Метаданные.СвойстваОбъектов.ВидРегистраНакопления.Остатки
Или Описание.Измерения.Количество() <> 1
Или Описание.Ресурсы.Количество() <> 1
Или Описание.Реквизиты.Количество() <> 0
Или Описание.Измерения.Найти("КодТовара") = Неопределено
Или Описание.Ресурсы.Найти("Количество") = Неопределено Тогда
ВызватьИсключение "Нужен регистр остатков с КодТовара и Количество";
КонецЕсли;
Менеджер = РегистрыНакопления.УчебныеОстатки85;
Сообщить(Описание.Имя = "УчебныеОстатки85");
Сообщить(Описание.Синоним = "Учебные остатки");
Сообщить(Описание.ПредставлениеСписка = "Учебные движения товаров");
Сообщить(Описание.РасширенноеПредставлениеСписка = "Список учебных движений товаров");
Сообщить(Описание.Пояснение = "Только собственные учебные движения");
Сообщить(Описание.Комментарий = "Регистр для обучения, не рабочие остатки");
Сообщить("Представление: " + Описание.Представление());
Сообщить("Полное имя: " + Описание.ПолноеИмя());
РодительСхемы = Описание.Родитель();
Сообщить(РодительСхемы.Имя = "УчебныеОстатки85");Разбор по шагам
Защитный блок выбирает собственный регистр с одним измерением КодТовара и ресурсом Количество.
Техническое имя оставляем неизменным. Подписи списка, пояснение и комментарий читаем из настроек Конфигуратора.
Представление и ПолноеИмя относятся к объекту метаданных, а не к отдельной строке движения.
Родитель() возвращает корень конфигурации. В этой подготовке корень и регистр специально имеют одинаковое имя, но это разные объекты метаданных.
Как проверить результат
Семь логических сообщений дают Истина.
Полное имя идентифицирует РегистрНакопления.УчебныеОстатки85; сведения о наличии/количестве товаров здесь не рассчитываются.
Ожидаемый результат
Проверены подписи интерфейса и адрес собственного регистра в дереве метаданных.
На что обратить внимание
Синоним списка не изменяет КодТовара в движениях и не переименовывает измерение.
Метаданные.Имя и Описание.Имя здесь текстово совпадают по подготовке; совпадение имён не делает корень конфигурации самим регистром.
Для остатка нужна виртуальная таблица/метод расчёта, не Представление объекта схемы.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Разобрать схему регистра накопления перед отчётом
Выбираем первый регистр текущей учебной конфигурации и разделяем измерения, ресурсы и реквизиты. Остатки не читаем и записи не создаём.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Запускайте в учебной копии конфигурации. Примеры читают структуру метаданных, но не создают объекты, не записывают регистры и не проводят документы.
Сверяйте вывод с деревом конфигурации в Конфигураторе. Имена, длины и настройки в УНФ, КА2, БП, УТ 11 и УТ 10.3 могут различаться.
Если Метаданные.РегистрыНакопления.Количество() = 0 Тогда
ВызватьИсключение "В этой конфигурации нет регистров накопления";
КонецЕсли;
Регистр = Метаданные.РегистрыНакопления.Получить(0);
Сообщить(Регистр.ПолноеИмя());
Сообщить(СтрШаблон("%1 (%2): вид %3", Регистр.Имя, Регистр.Синоним, Регистр.ВидРегистра));
Сообщить(Регистр.Комментарий);
Сообщить(СтрШаблон("Разделение итогов: %1; блокировки: %2",
Регистр.РазрешитьРазделениеИтогов, Регистр.РежимУправленияБлокировкойДанных));
Для Каждого Измерение Из Регистр.Измерения Цикл
Сообщить(СтрШаблон("Измерение %1: %2", Измерение.Имя, Измерение.Тип));
КонецЦикла;
Для Каждого Ресурс Из Регистр.Ресурсы Цикл
Сообщить(СтрШаблон("Ресурс %1: %2", Ресурс.Имя, Ресурс.Тип));
КонецЦикла;
Для Каждого Реквизит Из Регистр.Реквизиты Цикл
Сообщить(СтрШаблон("Реквизит %1: %2", Реквизит.Имя, Реквизит.Тип));
КонецЦикла;
Сообщить(СтрШаблон("Измерений %1; ресурсов %2; реквизитов %3; агрегатов %4",
Регистр.Измерения.Количество(), Регистр.Ресурсы.Количество(),
Регистр.Реквизиты.Количество(), Регистр.Агрегаты.Количество()));Разбор по шагам
Проверяем наличие регистра до обращения к индексу 0. Порядок коллекции не означает бизнес-приоритет объекта.
Измерения задают разрезы учёта, ресурсы — учитываемые значения, реквизиты — дополнительные поля записи.
ВидРегистра определяет регистр остатков или оборотов: нельзя автоматически подставлять виртуальную таблицу Остатки для любого регистра.
Разделение итогов, агрегаты и режим блокировок читаем как настройки схемы, не изменяя их.
Как проверить результат
Откройте указанный регистр в Конфигураторе: имена и количества трёх групп полей должны совпасть.
Выполните пример в конфигурации без регистров накопления: ожидается понятное исключение, а не ошибка индекса.
После запуска в базе не появились новые движения: в примере нет наборов записей и Записать().
Ожидаемый результат
Получена фактическая схема одного регистра для дальнейшего проектирования запроса.
На что обратить внимание
Наличие ресурса Количество не объясняет, что считать свободным остатком: правила резервов и распределения нужно изучать в конкретной конфигурации.
Количество агрегатов не является количеством товаров или строк движений. Первый регистр может не относиться к складу.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.