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

{ИмяПланаОбмена}.Объект

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

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

Сравнение

Ссылочное

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

Базовые типы: Объект, Объект, Объект, ПланОбмена.Объект, Представляемое, Представляемое, РедактируемыйОбъект<ИмяПланаОбмена.Ссылка, ИмяПланаОбмена.ПараметрыЗаписи, ИмяПланаОбмена.ПараметрыУдаления>, Сущность.Объект


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

{ИмяПланаОбмена}.Объект​

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

{ИмяПланаОбмена}.Объект(Ид: Ууид = Неопределено)
Конструктор с необязательным параметром — значением ссылки.

Перегрузка
{ИмяПланаОбмена}.Объект(Ид : Ууид? = Неопределено, <ИмяРеквизита1>: <ТипРеквизита1> = <ЗначениеПоУмолчаниюРеквизита1>, .... <ИмяРеквизитаN>: <ТипРеквизитаN> = <ЗначениеПоУмолчаниюРеквизитаN>)


{ИмяПланаОбмена}.Объект​

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

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

Перегрузка
{ИмяПланаОбмена}.Объект(Ид : Ууид? = Неопределено)


Свойства​

Код​

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

Код: Строка

Код узла плана обмена. Наличие этого реквизита и его типа зависят от настроек элемента проекта.


МеткаВерсии​

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

МеткаВерсии: Ууид

Случайный Ууид, изменяющийся каждый раз при записи объекта. Используется в механизме оптимистических блокировок.

Переопределение: МеткаВерсии


МоментПометкиУдаления​

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

МоментПометкиУдаления: Момент?

НомерОтправленного​

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

НомерОтправленного: Число

Номер последнего сообщения, отправленного из текущего узла (данного приложения) в адрес данного периферийного узла. Для текущего узла свойство доступно для изменения только в режиме загрузки. При вызове метода Записать() выполняется проверка, что значение не изменилось.


НомерПринятого​

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

НомерПринятого: Число

Максимальный из номеров сообщений, принятых текущим узлом (данным приложением) от данного периферийного узла. Для текущего узла свойство доступно для изменения только в режиме загрузки. При вызове метода Записать() выполняется проверка, что значение не изменилось.


ПометкаУдаления​

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

ПометкаУдаления: Булево

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

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

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

Ссылка​

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

Ссылка.

Переопределение: Ссылка


ЭтотУзел​

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

ЭтотУзел: Булево

Если свойство имеет значение Истина, то данный объект является текущим узлом приложения. В противном случае, объект является периферийным узлом.


{ИмяРеквизита}​

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

ИмяРеквизита: ТипРеквизита

Набор свойств, который содержит значения реквизитов узла. Доступ к значению осуществляется по имени, заданному в проекте.


Методы​

ВСтроку​

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

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

Переопределение
ПланОбмена.Объект::ВСтроку


ВыгрузитьДанные​

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

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

ВыгрузитьДанные(
  ЗаписьСодержимого: ЗаписьXml,
  Данные: ИмяРегистраНакопления.НаборЗаписей|{ИмяСправочника}.Объект|ИмяДокумента.Объект|{ИмяРегистраСведений}.НаборЗаписей|УдалениеОбъекта)
Выгружает указанные данные в сообщение обмена. При этом:

  • конвертирует данные, если необходимо;
  • записывает данные в сообщение обмена.

Примеры​

Выгрузка данных.

метод ВыгрузитьДанные(КодУзлаПолучателя : Строка, ИмяФайла : Строка)
знч Узел = УдаленныеСклады.НайтиПоКоду(КодУзлаПолучателя)
знч УдаленныйСклад = Узел.ЗагрузитьОбъект()
знч ФайлСообщенияОбмена = новый Файл(ИмяФайла)
знч ЗаписьСодержимого= новый ЗаписьXml(ФайлСообщенияОбмена.ОткрытьПотокЗаписи())
исп ОбработкаИсходящегоСообщения = УдаленныеСклады.СоздатьОбработкуИсходящегоСообщения(ЗаписьСодержимого, Узел)
для Данные из УдаленныеСклады.ВыбратьИзмененияВСообщение(Узел, ОбработкаИсходящегоСообщения.НомерСообщения)
если Данные это Товары.Объект
// Специфичная выгрузка, которая не автоматизируется конвертацией данных.
иначе
// Выгрузка, которая автоматизируется конвертацией данных.
УдаленныйСклад.ВыгрузитьДанные(ЗаписьСодержимого, Данные)
;
;
;

ВыгрузитьДанные​

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

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

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

Метод заменен на ВыгрузитьДанные.


ВыгрузитьДанные​

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

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

Метод заменен на ВыгрузитьДанные.


ЗагрузитьДанные​

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

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

ЗагрузитьДанные(ЧтениеСодержимого: ЧтениеXml): ИмяРегистраНакопления.НаборЗаписей|{ИмяСправочника}.Объект|ИмяДокумента.Объект|{ИмяРегистраСведений}.НаборЗаписей|УдалениеОбъекта
Загружает данные из сообщения обмена в приложение. Измененные данные передаются в параметре ЧтениеXml. Вызывается для периферийного узла, из которого получено сообщение обмена данными. Выполняет следующие действия:

  • конвертирует данные, если необходимо;
  • устанавливает параметр обмена данными Отправитель, чтобы не регистрировались изменения для узла-отправителя;
  • записывает данные в БД.

Примеры​

Загрузка данных.

метод ЗагрузитьДанные(ИмяФайла : Строка)
знч ФайлСообщенияОбмена = новый Файл(ИмяФайла)
знч ЧтениеСодержимого = новый ЧтениеXml(ФайлСообщенияОбмена.ОткрытьПотокЧтения())
исп ОбработкаВходящегоСообщения= УдаленныеСклады.СоздатьОбработкуВходящегоСообщения(ЧтениеСодержимого)
знч УдаленныйСклад = ОбработкаВходящегоСообщения.Отправитель.ЗагрузитьОбъект() как УдаленныеСклады.Объект
пока ЧтениеСодержимого.ВидУзла == ВидУзлаXml.НачалоЭлемента
если ЧтениеСодержимого.Имя == "Товары.Object"
// Специфичная загрузка, которая не автоматизируется конвертацией данных.
иначе
// Загрузка, которая автоматизируется конвертацией данных
УдаленныйСклад.ЗагрузитьДанные(ЧтениеСодержимого)
;
;
;

ЗагрузитьДанные​

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

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

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

Метод заменен на ЗагрузитьДанные.


ЗагрузитьДанные​

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

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

Метод заменен на ЗагрузитьДанные.


Записать​

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

Записать()
Сохраняет объект в базу данных.

Исключения​

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

Перегрузка
Записать(ПараметрыЗаписи: ИмяПланаОбмена.ПараметрыЗаписи)


Записать​

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

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

Записать(ПараметрыЗаписи: {ИмяПланаОбмена}.ПараметрыЗаписи)
Метод заменен на Записать.


Заполнить​

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

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

Заполнить()
Заполняет сущность, как при интерактивном вызове, путем вызова обработчика ПриЗаполнении, если он есть. Возвращает саму сущность.


Заполнить​

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

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

Метод заменен на Заполнить.


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

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

Представление(): Строка
Возвращает пользовательское представление объекта. Значение берется из реквизита, указанного в свойстве Представление элемента проекта.

Переопределение
Представляемое::Представление


ПриСозданииНаОсновании​

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

ПриСозданииНаОсновании(Основание: <Типисточникасозданиянаосновании>)
Вызывается при создании нового узла плана обмена на основании другого объекта. Подразумевается, что в этом обработчике события разработчик приложения должен реализовать логику создания узла плана обмена на основании какого-либо типа.

Параметр Основание содержит тип, на основании которого создается объект.

Если в элементе проекта плана обмена в качестве источников создания на основании (свойство СозданиеНаОсновании) указано несколько оснований, то будет столько же перегрузок этого события (параметр Основание будет тех типов, которые указаны в свойстве СозданиеНаОсновании).

Например, если у плана обмена указаны источники создания на основании:

СозданиеНаОсновании: [Организации.Ссылка, Филиалы.Ссылка]

То нужно сделать следующие обработчики события ПриСозданииНаОсновании:

@Обработчик
метод ПриСозданииНаОсновании(Основание: Организации.Ссылка)
Организация = Основание
;

Если у элемента проекта не указаны источники создания на основании, то это событие будет отсутствовать.


СоздатьКопию​

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

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

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

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

Создает новый экземпляр узла плана обмена копированием этого объекта.

Исключения​

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


СоздатьКопию​

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

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

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


Удалить​

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

Удалить()
Удаляет объект из базы данных.

Перегрузка
Удалить(ПараметрыУдаления: ИмяПланаОбмена.ПараметрыУдаления)


Удалить​

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

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

Удалить(ПараметрыУдаления: {ИмяПланаОбмена}.ПараметрыУдаления)
Метод заменен на Удалить.


УстановитьПометкуУдаленияПриЗагрузкеДанных​

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

УстановитьПометкуУдаленияПриЗагрузкеДанных(
  ЗначениеПометки: Булево,
  МоментПометкиУдаления: Момент)

Обработчики​

ПриЗаполнении​

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

ПриЗаполнении(ТекстЗаполнения: Строка)
Обработчик, вызываемый при:

  • Интерактивном создании (открытии формы нового объекта)
  • Вызове метода Заполнить (Параметр ТекстЗаполнения при этом равен пустой строке)

Предназначен для предзаполнения сущности в интерактивном режиме. Параметр ТекстЗаполнения содержит текст, введенный в поле ввода перед нажатием кнопки создания нового элемента.


ПриСозданииКопии​

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

ПриСозданииКопии(Источник: ИмяПланОбмена.Данные)
Вызывается при создании нового узла плана обмена копированием существующего. На момент вызова этого обработчика значения реквизитов у нового объекта будут уже заполнены из узла-источника. Не будут автоматически копироваться стандартные реквизиты узла плана обмена:

  • Код,
  • НомерОтправленного,
  • НомерПринятого,
  • ЭтотУзел.

Кроме того, не будут копироваться реквизиты, копирование которых отключено в плане обмена с помощью свойства ЗаполнятьПриКопировании.

Параметр Источник содержит данные исходного узла плана обмена, копированием которого и создается новый узел.

Примеры​

В проекте есть план обмена УдаленныеСклады. Необходимо сделать так, чтобы при копировании узла этого плана обмена в реквизит ДатаСоздания подставлялась текущая дата.

@Обработчик
метод ПриСозданииКопии(Источник: УдаленныеСклады.Данные)
ДатаСоздания = ДатаВремя.Сейчас()
;

ПередЗаписью​

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

ПередЗаписью(
  До: ИмяПланОбмена.Данные,
  ПараметрыЗаписи: ИмяПланОбмена.ПараметрыЗаписи)
Обработчик, вызываемый перед записью объекта в базу данных. Для нового объекта параметр До соответствует текущему состоянию объекта.

Выполняется в транзакции.

Примеры​

Подписка на событие, объявленная в общем модуле.

@Подписка(Событие{УдаленныеСклады.Объект.ПередЗаписью})
метод ПодпискаПередЗаписью(Источник: УдаленныеСклады.Данные,
До: УдаленныеСклады.Данные,
Параметры: УдаленныеСклады.ПараметрыЗаписи)
// Обработка события
;

ПередУдалением​

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

ПередУдалением(ПараметрыУдаления: ИмяПланОбмена.ПараметрыУдаления)
Обработчик, вызываемый перед удалением объекта из базы данных.

Выполняется в транзакции.

Примеры​

Подписка на событие, объявленная в общем модуле.

@Подписка(Событие{УдаленныеСклады.Объект.ПередУдалением})
метод ПодпискаПередУдалением(Источник: УдаленныеСклады.Данные,
Параметры: УдаленныеСклады.ПараметрыУдаления)
// Обработка события
;

ПослеЗаписи​

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

ПослеЗаписи(
  До: ИмяПланОбмена.Данные,
  ПараметрыЗаписи: ИмяПланОбмена.ПараметрыЗаписи)
Обработчик, вызываемый после записи объекта в базу данных.

Выполняется в транзакции.

Примеры​

Подписка на событие, объявленная в общем модуле.

@Подписка(Событие{УдаленныеСклады.Объект.ПослеЗаписи})
метод ПодпискаПослеЗаписи(Источник: УдаленныеСклады.Данные,
До: УдаленныеСклады.Данные,
Параметры: УдаленныеСклады.ПараметрыЗаписи)
// Обработка события
;

ПослеУдаления​

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

ПослеУдаления(ПараметрыУдаления: ИмяПланОбмена.ПараметрыУдаления)
Обработчик, вызываемый после удаления объекта в базе данных.

Выполняется в транзакции.

Примеры​

Подписка на событие, объявленная в общем модуле.

@Подписка(Событие{УдаленныеСклады.Объект.ПослеУдаления})
метод ПодпискаПослеУдаления(Источник: УдаленныеСклады.Данные,
Параметры: УдаленныеСклады.ПараметрыУдаления)
// Обработка события
;

ПриВыгрузкеДанных​

ПриВыгрузкеДанных(Параметры: ПараметрыВыгрузкиОбменаДанными)
Обработчик, вызываемый при выгрузке данных.


ПриЗагрузкеДанных​

ПриЗагрузкеДанных(Параметры: ПараметрыЗагрузкиОбменаДанными)
Обработчик, вызываемый при загрузке данных.


ПриЗаполнении​

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

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

ПриЗаполнении(ТекстЗаполнения: Строка)
Метод заменен на ПриЗаполнении.


ПриСозданииКопии​

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

ПриСозданииКопии(Источник: {ИмяПланаОбмена}.Данные)
Метод заменен на ПриСозданииКопии.


ПередЗаписью​

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

Метод заменен на ПередЗаписью.


ПередУдалением​

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

ПередУдалением(ПараметрыУдаления: {ИмяПланаОбмена}.ПараметрыУдаления)
Метод заменен на ПередУдалением.


ПослеЗаписи​

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

Метод заменен на ПослеЗаписи.


ПослеУдаления​

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

ПослеУдаления(ПараметрыУдаления: {ИмяПланаОбмена}.ПараметрыУдаления)
Метод заменен на ПослеУдаления.


ПриЗаполнении​

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

ПриЗаполнении()
Метод заменен на ПриЗаполнении.


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

Объект​

ПолучитьТип

ПланОбмена.Объект​

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

ЭтоНовый

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

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

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

Сущность.Объект​

Ссылка