Тип: СерииКодовСправочника. Содержит варианты диапазона проверки кода на уникальность и автоматического присвоения кодов элементов справочника.
Полное описание, параметры и ограничения
ПеречислимыеСвойстваОбъектовМетаданных.СерииКодовСправочника (MetadataObjectEnumeratedProperties.CatalogCodesSeries)
ПеречислимыеСвойстваОбъектовМетаданных (MetadataObjectEnumeratedProperties)
СерииКодовСправочника (CatalogCodesSeries)
Доступен, начиная с версии 8.0.
Использование:
Только чтение.
Описание:
Тип: СерииКодовСправочника.
Содержит варианты диапазона проверки кода на уникальность и автоматического присвоения кодов элементов справочника.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Определить тип кода номенклатуры до преобразования входящей строки
В КА2 Progress код Номенклатура строковый. Учебный внешний код 000123 сохраняем как строку: превращение в число убирает ведущие нули.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Запускайте в учебной копии конфигурации. Примеры читают структуру метаданных, но не создают объекты, не записывают регистры и не проводят документы.
Сверяйте вывод с деревом конфигурации в Конфигураторе. Имена, длины и настройки в УНФ, КА2, БП, УТ 11 и УТ 10.3 могут различаться.
Имена объектов взяты из XML КА2 Progress: C:\claude\KA2\Progress\XML_CF_KA2_PROGRESS. Исходные XML не изменяйте. Выполняйте код только в своей учебной копии соответствующей конфигурации.
В другой конфигурации предварительно найдите аналогичный объект в Конфигураторе и замените только строку имени в поиске. Отсутствие имени обрабатывается до чтения свойств; оно не доказывает отсутствие аналогичной возможности.
Каждый урок запускайте отдельно. Код не вызывает бизнес-функции модулей и обработчики команд, не переключает привилегированный режим и не меняет параметры сеанса.
Варианты = Метаданные.СвойстваОбъектов;
Описание = Метаданные.Справочники.Найти("Номенклатура");
Если Описание = Неопределено Тогда
ВызватьИсключение "В учебной конфигурации отсутствует Справочники.Номенклатура";
КонецЕсли;
КодИзОбмена = "000123";
Если Описание.ТипКода = Варианты.ТипКодаСправочника.Строка Тогда
КодДляПоиска = КодИзОбмена;
Сообщить("Строковый код: ведущие нули сохранены");
ИначеЕсли Описание.ТипКода = Варианты.ТипКодаСправочника.Число Тогда
КодДляПоиска = Число(КодИзОбмена);
Сообщить("Числовой код: формат строки не является значением");
Иначе
ВызватьИсключение "Неожиданный тип кода: изучите метаданные перед обменом";
КонецЕсли;
Сообщить(Описание.ТипКода = Варианты.ТипКодаСправочника.Строка);
Сообщить(КодДляПоиска = "000123");
Сообщить(Число(КодИзОбмена) = 123);
Сообщить(Описание.СерииКодов = Варианты.СерииКодовСправочника.ВоВсемСправочнике);
Сообщить("Основное представление: " + Строка(Описание.ОсновноеПредставление));
Если Описание.ОсновноеПредставление = Варианты.ОсновноеПредставлениеСправочника.ВВидеНаименования Тогда
Сообщить("Пользователь видит наименование, но поиск по коду остаётся отдельной операцией");
КонецЕсли;Разбор по шагам
Находим реальное описание Номенклатура из предоставленного XML и проверяем наличие.
СвойстваОбъектов предоставляет типизированные системные значения метаданных, не пользовательское перечисление товаров.
Выбираем преобразование по фактическому ТипКода; текущий строковый код оставляем без преобразования.
СерииКодов определяет область уникальности, ОсновноеПредставление — видимое представление; это разные свойства.
Как проверить результат
В предоставленном XML четыре сравнения Истина: строковый код, сохранённое 000123, отдельно полученное число 123 и серия всего справочника.
В другой версии конфигурации сначала сверяйте ТипКода и СерииКодов; пример не ищет и не создаёт товар.
Ожидаемый результат
Подготовлена корректная типизация входящего кода без потери ведущих нулей.
На что обратить внимание
Не передавайте число 123 вместо строкового кода 000123 по привычке.
Совпадение кода в данной серии ещё не является внешним идентификатором Avito или другого сервиса.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.