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