Устанавливает новый код. Если в коде присутствует числовая часть, то новый код автоматически устанавливается следующим за имеющимся максимальным. При этом определяется текущий максимальный код среди элементов данного справочника. Если передан префикс, то новый код устанавливается следующим образом: выполняется поиск максимального кода среди кодов, имеющих данный префикс, новый код выбирается как следующий от найденного кода.
Синтаксис
УстановитьНовыйКод(<ПрефиксКода>)Примеры платформы
Объект.УстановитьНовыйКод("Пр-");Полное описание, параметры и ограничения
СправочникОбъект.<Имя справочника>.УстановитьНовыйКод (CatalogObject.<Catalog name>.SetNewCode)
СправочникОбъект.<Имя справочника> (CatalogObject.<Catalog name>)
УстановитьНовыйКод (SetNewCode)
Доступен, начиная с версии 8.0.
Синтаксис:
УстановитьНовыйКод(<ПрефиксКода>)
Параметры:
<ПрефиксКода> (необязательный)
Тип: Строка.
Строковое значение префикса. Если префикс указан, то новый код будет формироваться с учетом префикса.
Описание:
Устанавливает новый код. Если в коде присутствует числовая часть, то новый код автоматически устанавливается следующим за имеющимся максимальным. При этом определяется текущий максимальный код среди элементов данного справочника.
Если передан префикс, то новый код устанавливается следующим образом: выполняется поиск максимального кода среди кодов, имеющих данный префикс, новый код выбирается как следующий от найденного кода.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Префикс имеет смысл, если для справочника в Конфигураторе выбран тип кода Строка.
Пример:
Объект.УстановитьНовыйКод("Пр-");
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Скопировать по настоящей ссылке и изменить только незаписанную копию
Ссылка.Скопировать возвращает объект, а не новую сохранённую ссылку. На собственной табличной части проверяем независимость копии и источника.
Где и как запускать
Полный серверный модуль своей новой пустой конфигурации Учебная85, платформа 8.5.1.1343. Собственные ссылки/объекты, временная запись только с откатом; здесь не запускался.
Подготовка
Создайте НОВУЮ пустую файловую учебную базу, не копию рабочего каталога. В Конфигураторе задайте корню имя Учебная85. Не добавляйте эти объекты в рабочую УТ/КА2/УНФ/БП.
Справочники → Добавить: имя УчебныеТовары. Длина кода 10, тип кода Строка, автонумерация и контроль уникальности включены, длина наименования 100.
Для УчебныеТовары включите иерархию групп и элементов. Добавьте реквизиты Артикул (Строка, длина 20) и Цена (Число, 12 цифр, 2 дробных, неотрицательное). Проверка заполнения для этих учебных реквизитов не устанавливается.
Добавьте табличную часть Штрихкоды: Штрихкод (Строка, длина 20) и Основной (Булево). Обновите конфигурацию базы данных. Модули объектов оставьте пустыми.
Для этого блока УчебныеТовары не подчинён владельцу, не имеет предопределённых элементов и дополнительных обработчиков. Модули объекта/менеджера пусты, подписок и расширений нет. Иерархия групп и элементов допускает два уровня ниже корня.
Точную платформу 8.5.1.1343 проверяет код. Ссылки и объекты создаются самим уроком; UUID не подменяется знакомым кодом из УТ/КА2/УНФ/БП.
Свойства ссылки readonly, свойства полученного объекта могут быть записываемыми. Ссылка.Скопировать возвращает новый объект, но сам метод не записывает его в базу.
Непустой UUID/ссылка не подтверждает наличие записи. Для плановой ссылки проверяется ПолучитьОбъект=Неопределено, а данные отсутствующей записи не читаются.
ВерсияДанных — непрозрачная строка платформы, не число, дата, версия конфигурации или номер обновления. Урок не декодирует и не назначает её вручную.
Здесь в 1С примеры не запускались. Проверены исходники и установленная справка; записи/формы в ваших базах этим заполнением не создавались.
Весь модуль вставьте в серверный общий модуль УчебныеСсылки. Его серверная экспортная процедура ВыполнитьПример вызывается из своей процедуры формы с &НаСервереБезКонтекста. Не вставляйте готовую процедуру внутрь другого обработчика.
В транзакционных опытах временно записываются только собственные новые товар/группы, затем выполняется ОтменитьТранзакцию и при успехе, и при ошибке. Не заменяйте откат фиксацией и не вызывайте этот модуль внутри чужой транзакции.
Запускайте строго в новой пустой базе Учебная85, с пустыми модулями объектов и без подписок. Здесь временно записываются только созданные самим примером объекты.
Отмена транзакции выполняется и при успехе, и при ошибке. Не заменяйте её фиксацией и не запускайте внутри транзакции вызывающего кода.
Откат базы не отменяет письма, HTTP-запросы и другие внешние действия обработчиков. Поэтому копия рабочей конфигурации с неизвестными обработчиками не заменяет эту подготовку.
Процедура ВыполнитьПример() Экспорт
Если Метаданные.Справочники.Найти("УчебныеТовары") = Неопределено Тогда
ВызватьИсключение "Сначала создайте учебный справочник по подготовке";
КонецЕсли;
Если ТранзакцияАктивна() Тогда
ВызватьИсключение "Запустите учебную задачу вне чужой транзакции";
КонецЕсли;
Ссылка = Справочники.УчебныеТовары.ПолучитьСсылку(Новый УникальныйИдентификатор);
НачатьТранзакцию();
Попытка
Товар = Справочники.УчебныеТовары.СоздатьЭлемент();
Товар.УстановитьСсылкуНового(Ссылка);
Товар.Наименование = "Источник копии ссылки";
Товар.Артикул = "REF-ORIGINAL";
Товар.Цена = 250;
Штрихкод = Товар.Штрихкоды.Добавить();
Штрихкод.Штрихкод = "REF-OWN-01";
Штрихкод.Основной = Истина;
Товар.УстановитьНовыйКод("У");
Товар.Записать();
СсылкаИсточника = Товар.Ссылка;
Копия = СсылкаИсточника.Скопировать();
Копия.Наименование = "Независимая копия в памяти";
Копия.Артикул = "REF-COPY";
Копия.Штрихкоды.Получить(0).Штрихкод = "REF-COPY-01";
Сообщить(ТипЗнч(Копия) = Тип("СправочникОбъект.УчебныеТовары"));
Сообщить(Копия.ЭтоНовый());
Сообщить(Копия.Ссылка.Пустая());
Сообщить(Копия.Штрихкоды.Количество() = 1);
Сообщить(СсылкаИсточника.Наименование = "Источник копии ссылки");
Исходный = СсылкаИсточника.ПолучитьОбъект();
Если Исходный = Неопределено Тогда
ВызватьИсключение "Собственный источник внутри транзакции не найден";
КонецЕсли;
Сообщить(Исходный.Артикул = "REF-ORIGINAL");
Сообщить(Исходный.Штрихкоды.Получить(0).Штрихкод = "REF-OWN-01");
Сообщить("Скопировать по ссылке вернул новый незаписанный объект; копия не записывалась");
ОтменитьТранзакцию();
Исключение
Если ТранзакцияАктивна() Тогда
ОтменитьТранзакцию();
КонецЕсли;
ВызватьИсключение;
КонецПопытки;
Сообщить(Не ТранзакцияАктивна());
Сообщить(Ссылка.ПолучитьОбъект() = Неопределено);
КонецПроцедурыРазбор по шагам
В собственной отменяемой транзакции записать один новый источник с одним учебным штрихкодом.
Вызвать Скопировать именно на СсылкаИсточника.
Изменить наименование, артикул и строку штрихкода только у возвращённого нового объекта.
Проверить тип объекта, ЭтоНовый и пустую ссылку копии. Копию не записывать.
Получить исходный сохранённый объект по реальной ссылке и проверить неизменность его артикула/строки.
Откатить запись собственного источника и подтвердить отсутствие.
Как проверить результат
Семь сравнений Истина: новая копия не подменила источник.
Не сравнивается код копии с кодом источника: правила нумерации отдельно не выдумываются.
Копия не записана, источник отменён, чужие товары не затронуты.
Ожидаемый результат
Реально разобрана граница между копированием по ссылке и записью возвращённого объекта.
На что обратить внимание
Объект и ссылка не взаимозаменяемы: только объект используется для изменения данных, ссылка идентифицирует запись.
Ссылки на отсутствующий или отменённый объект не следует читать как существующий товар.
Никакие чужие объекты не ищутся по первому совпадению/первой строке и не удаляются по названию.
Свойства ссылки не присваиваются, а непрозрачная ВерсияДанных не декодируется.
Откат базы не отменяет внешние действия обработчиков, поэтому допускается только подготовленная своя пустая конфигурация без таких обработчиков.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Проверить путь и уровень товара методами именно ссылки
Собственное дерево Бумага → Книги → Учебная книга записывается только внутри отменяемой транзакции. Методы вызываются на ссылках, не на переменных объектов.
Где и как запускать
Полный серверный модуль своей новой пустой конфигурации Учебная85, платформа 8.5.1.1343. Собственные ссылки/объекты, временная запись только с откатом; здесь не запускался.
Подготовка
Создайте НОВУЮ пустую файловую учебную базу, не копию рабочего каталога. В Конфигураторе задайте корню имя Учебная85. Не добавляйте эти объекты в рабочую УТ/КА2/УНФ/БП.
Справочники → Добавить: имя УчебныеТовары. Длина кода 10, тип кода Строка, автонумерация и контроль уникальности включены, длина наименования 100.
Для УчебныеТовары включите иерархию групп и элементов. Добавьте реквизиты Артикул (Строка, длина 20) и Цена (Число, 12 цифр, 2 дробных, неотрицательное). Проверка заполнения для этих учебных реквизитов не устанавливается.
Добавьте табличную часть Штрихкоды: Штрихкод (Строка, длина 20) и Основной (Булево). Обновите конфигурацию базы данных. Модули объектов оставьте пустыми.
Для этого блока УчебныеТовары не подчинён владельцу, не имеет предопределённых элементов и дополнительных обработчиков. Модули объекта/менеджера пусты, подписок и расширений нет. Иерархия групп и элементов допускает два уровня ниже корня.
Точную платформу 8.5.1.1343 проверяет код. Ссылки и объекты создаются самим уроком; UUID не подменяется знакомым кодом из УТ/КА2/УНФ/БП.
Свойства ссылки readonly, свойства полученного объекта могут быть записываемыми. Ссылка.Скопировать возвращает новый объект, но сам метод не записывает его в базу.
Непустой UUID/ссылка не подтверждает наличие записи. Для плановой ссылки проверяется ПолучитьОбъект=Неопределено, а данные отсутствующей записи не читаются.
ВерсияДанных — непрозрачная строка платформы, не число, дата, версия конфигурации или номер обновления. Урок не декодирует и не назначает её вручную.
Здесь в 1С примеры не запускались. Проверены исходники и установленная справка; записи/формы в ваших базах этим заполнением не создавались.
Весь модуль вставьте в серверный общий модуль УчебныеСсылки. Его серверная экспортная процедура ВыполнитьПример вызывается из своей процедуры формы с &НаСервереБезКонтекста. Не вставляйте готовую процедуру внутрь другого обработчика.
В транзакционных опытах временно записываются только собственные новые товар/группы, затем выполняется ОтменитьТранзакцию и при успехе, и при ошибке. Не заменяйте откат фиксацией и не вызывайте этот модуль внутри чужой транзакции.
Запускайте строго в новой пустой базе Учебная85, с пустыми модулями объектов и без подписок. Здесь временно записываются только созданные самим примером объекты.
Отмена транзакции выполняется и при успехе, и при ошибке. Не заменяйте её фиксацией и не запускайте внутри транзакции вызывающего кода.
Откат базы не отменяет письма, HTTP-запросы и другие внешние действия обработчиков. Поэтому копия рабочей конфигурации с неизвестными обработчиками не заменяет эту подготовку.
Процедура ВыполнитьПример() Экспорт
Если Метаданные.Справочники.Найти("УчебныеТовары") = Неопределено Тогда
ВызватьИсключение "Сначала создайте учебный справочник по подготовке";
КонецЕсли;
Если ТранзакцияАктивна() Тогда
ВызватьИсключение "Запустите учебную задачу вне чужой транзакции";
КонецЕсли;
Ссылка = Справочники.УчебныеТовары.ПолучитьСсылку(Новый УникальныйИдентификатор);
НачатьТранзакцию();
Попытка
Товар = Справочники.УчебныеТовары.СоздатьЭлемент();
Товар.УстановитьСсылкуНового(Ссылка);
Корень = Справочники.УчебныеТовары.СоздатьГруппу();
Корень.Наименование = "Бумага";
Корень.УстановитьНовыйКод("У");
Корень.Записать();
Вложенная = Справочники.УчебныеТовары.СоздатьГруппу();
Вложенная.Наименование = "Книги";
Вложенная.Родитель = Корень.Ссылка;
Вложенная.УстановитьНовыйКод("У");
Вложенная.Записать();
Товар.Наименование = "Учебная книга";
Товар.Родитель = Вложенная.Ссылка;
Товар.УстановитьНовыйКод("У");
Товар.Записать();
СсылкаТовара = Товар.Ссылка;
СсылкаКорня = Корень.Ссылка;
СсылкаВложенной = Вложенная.Ссылка;
Сообщить(СсылкаТовара.ПолноеНаименование() = "Бумага/Книги/Учебная книга");
Сообщить(СсылкаТовара.ПолныйКод() = Корень.Код + "/" + Вложенная.Код + "/" + Товар.Код);
Сообщить(СсылкаКорня.Уровень() = 0);
Сообщить(СсылкаВложенной.Уровень() = 1);
Сообщить(СсылкаТовара.Уровень() = 2);
Сообщить(СсылкаТовара.ПринадлежитЭлементу(СсылкаКорня));
Сообщить(СсылкаТовара.ПринадлежитЭлементу(СсылкаВложенной));
Сообщить(Не СсылкаТовара.ПринадлежитЭлементу(СсылкаТовара));
Сообщить(СсылкаТовара.Родитель = СсылкаВложенной);
Сообщить(СсылкаКорня.ЭтоГруппа И СсылкаВложенной.ЭтоГруппа И Не СсылкаТовара.ЭтоГруппа);
ОтменитьТранзакцию();
Исключение
Если ТранзакцияАктивна() Тогда
ОтменитьТранзакцию();
КонецЕсли;
ВызватьИсключение;
КонецПопытки;
Сообщить(Не ТранзакцияАктивна());
Сообщить(Ссылка.ПолучитьОбъект() = Неопределено);
КонецПроцедурыРазбор по шагам
Создать и временно записать две свои группы и один собственный товар.
Получить три настоящие ссылки после записи; родителя передавать ссылкой.
ПолноеНаименование и ПолныйКод включают родителей через /; коды берутся фактические, числовые суффиксы не угадываются.
Корень имеет уровень 0, вложенная группа 1, товар 2. Не вызывать Уровень у пустой ссылки.
Принадлежность учитывает все уровни; сам элемент не подчинён самому себе.
Проверить признаки групп и затем отменить все три собственные записи.
Как проверить результат
Десять проверок собственного дерева Истина, после чего товар отсутствует и транзакция закрыта.
Уровень читается только у существующих внутри транзакции записей.
Нет поиска/удаления существующих групп по совпадающему названию; откат относится только к собственным новым записям.
Ожидаемый результат
Получен осмысленный путь собственного товара с точными правилами методов ссылок.
На что обратить внимание
Объект и ссылка не взаимозаменяемы: только объект используется для изменения данных, ссылка идентифицирует запись.
Ссылки на отсутствующий или отменённый объект не следует читать как существующий товар.
Никакие чужие объекты не ищутся по первому совпадению/первой строке и не удаляются по названию.
Свойства ссылки не присваиваются, а непрозрачная ВерсияДанных не декодируется.
Откат базы не отменяет внешние действия обработчиков, поэтому допускается только подготовленная своя пустая конфигурация без таких обработчиков.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.