Перейти к основному содержимому

{ИмяСправочника}.Ссылка

Версия 8.0 и выше

{ИмяРазработчика}::{ИмяПроекта}::{ИмяПодсистемы}::{ИмяСправочника}.Ссылка @ВПроекте Доступность: КлиентИСервер

Ссылка на элемент справочника.

Сравнение

Структурное

Иерархия типа​

Базовые типы: Объект, Представляемое, Стд::ИнтеграционнаяШина::СправочникИнформационныхСистем.Ссылка, Стд::Справочники::Справочник.Ссылка, Стд::Сущности::Сущность.Ключ, Стд::Сущности::Сущность.Ссылка

Конструкторы​

{ИмяСправочника}.Ссылка​

Доступность: КлиентИСервер

ИмяСправочника.Ссылка(Ид: Ууид)

Свойства​

Ид​

Доступность: КлиентИСервер ТолькоЧтение

Ид: Ууид

Переопределение: Ид

Методы​

ВСтроку​

Доступность: КлиентИСервер

ВСтроку(): Строка

Переопределение
Справочник.Ссылка::ВСтроку

ЗагрузитьОбъект​

Доступность: Сервер

ЗагрузитьОбъект(Заблокировать: Булево = Ложь): {ИмяСправочника}.Объект?
Загружает объект справочника по текущей ссылке.

Заблокировать - признак необходимости установить блокировку на загружаемый объект до окончания текущей транзакции. Если объекта по ссылке не существует, возвращает Неопределено.

Исключения​

ИсключениеТаймаутаБлокировки - если не удалось установить блокировку по таймауту. ИсключениеНетАктивнойТранзакции - при попытке заблокировать элемент вне транзакции. ИсключениеДоступЗапрещен - при отсутствии прав на загрузку объекта.

Переопределение
Справочник.Ссылка::ЗагрузитьОбъект

Примеры​

Чтение объекта в транзакции с последующим изменением.

метод ЗаменитьСтавкуНДС(ТоварыКИзменению: ЧитаемыйМассив<Номенклатура.Ссылка>, НоваяСтавкаНДС: СтавкиНДС.Ссылка)
    исп Транзакция = Транзакции.Начать()
    
    для Ссылка из ТоварыКИзменению
        // Изменяемый в транзакции объект нужно считывать с исключительной блокировкой,
        // иначе при параллельном исполнении может возникнуть взаимоблокировка (deadlock)
        знч Товар = Ссылка.ЗагрузитьОбъект(Истина)
        
        если Товар == Неопределено
            // Ссылка может быть недействительной
            продолжить
        ;
           
        Товар.СтавкаНДС = НоваяСтавкаНДС
        Товар.Записать()
    ;
    
    Транзакция.Фиксировать()
;

Представление​

Доступность: КлиентИСервер

Представление(): Строка

Переопределение
Справочник.Ссылка::Представление

СоздатьКопиюОбъекта​

Версия 9.0 и выше

Доступность: Сервер

@ИменованныеПараметры
СоздатьКопиюОбъекта(
Ид: Ууид = Неопределено,
<Реквизит1>: <ТипРеквизита1> = <ЗначениеПоУмолчаниюРеквизита1>,
....<РеквизитN>: <ТипРеквизитаN> = <ЗначениеПоУмолчаниюРеквизитаN>)

Вызов возможен только с именованными параметрами

Создает новый элемент справочника копированием элемента справочника на который указывает эта ссылка.

Исключения​

ИсключениеДоступЗапрещен - при отсутствии прав на загрузку объекта - источника создания копированием. ИсключениеИсточникКопированияСущностиНеСуществует - Если ссылка у которой был вызван метод указывает на несуществующий объект.

Примеры​

Создать копию товара, указав другое значение ставки НДС

метод СкопироватьНоменклатуру(ИсходныйТовар: Номенклатура.Ссылка)
    знч Копия = ИсходныйТовар.СоздатьКопиюОбъекта(СтавкаНДС = СтавкиНДС.БезНДС())
    Копия.Записать()
;

СоздатьКопиюОбъекта​

Версия 8.0 и ниже

Доступность: Сервер

@ИменованныеПараметры
СоздатьКопиюОбъекта(
Ид: Ууид,
Родитель: {ИмяСправочника}.Ссылка?,
Код: Строка,
Наименование: Строка,
Описание: Строка,
ПользовательПоУмолчанию: Пользователи.Ссылка?,
ИдТокена: Строка,
ИмяСвойстваУчастника: Строка
): {ИмяСправочника}.Объект
Метод заменен на СоздатьКопиюОбъекта.

Список унаследованных методов​

Объект​

ПолучитьТип

Представляемое​

Справочник.Ссылка​

ВСтроку (Переопределение)

ЗагрузитьОбъект (Переопределение)

Представление (Переопределение)

СправочникИнформационныхСистем.Ссылка​

ВСтроку (Переопределение)

ЗагрузитьОбъект (Переопределение)

Последнее обновление