Коллекция движений объекта хранится в реквизите объекта

Движения документа

Движения
документа —
это записи в регистрах, которые создаются
в процессе проведения документа и
отражают изменения, производимые
документом.

Откроем
окно редактирования объекта конфигурации
Документ ПриходнаяНакладная.
Перейдем на закладку
Движения,
раскроем список
Регистры накопления
и отметим регистр накопления
ОстаткиМатериалов
(рис. 6.7).

Рис.6.7. Создание
движений документа «Приходная накладная»
в регистре «Остатки материалов»

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

Рис.6.8. Конструктор
движений

Конструктор
устроен просто. В списке
Регистры
перечислены регистры, в которых документ
может создавать движения. В нашем случае
там пока один регистр
ОстаткиМатериалов

В
списке
Реквизиты документа
должны находиться исходные данные для
создания движений — реквизиты документа
ПриходнаяНакладная.

А
в таблице
Поле — Выражение
должны быть заданы формулы, по которым
будут вычисляться значения измерений
и ресурсов регистра при записи движений
(рис. 6.8).

Обратите
внимание, что по умолчанию конструктор
предлагает нам создавать движения
прихода
(Тип движения регистра — Приход, символ
+ рядом с названием регистра) по регистру
ОстаткиМатериалов.
Это нас вполне устраивает, ведь документ
ПриходнаяНакладная
и должен приходовать материалы.

В
поле выбора
Табличная часть
выберем табличную часть нашего документа
—
Материалы.

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

Теперь
нажмем кнопку
Заполнить выражения.

В
нижнем окне сформируется соответствие
полей (измерений и ресурсов) регистра
и выражений для их расчета (рис. 6.9).

Рис. 6.9. Выбор
табличной части документа и заполнение
выражений для расчета движений регистра

Как
видите, конструктор движений установил
соответствия подходящим образом: в
качестве материала в регистр будет
записан материал из табличной части
документа, в качестве склада — склад,
указанный в шапке документа, а в качестве
количества — количество из табличной
части документа.

Нажмем
кнопку ОК и посмотрим, какой текст
сформировал конс­труктор в модуле
документа
ПриходнаяНакладная
(листинг
6.1).

Конструктор
создал обработчик события
ОбработкаПроведения объекта
конфигурации Документ
ПриходнаяНакладная,
поместил его в модуль объекта и открыл
текст модуля.

Событие
ОбработкаПроведения
является одним из важнейших событий,
связанных с документом. Это событие
возникает при про­ведении документа.
Основное назначение обработчика данного
события — генерация движений по документу.
Выполнение различных операций с данными
в процедуре обработчика влияет на
состояние учета. Таким образом, именно
в эту процедуру разработчик должен
поместить собственные алгоритмы
преобразования данных, выполняемые в
момент проведения документа.

Поясним текст
процедуры обработчика.

Объект
встроенного языка
ДокументОбъект
имеет свойство
Движения. Оно
возвращает объект
КоллекцияДвижений,
содержащий коллекцию наборов записей
регистров, по которым этот документ
может формировать движения.

К
конкретному набору записей этой коллекции
можно обратиться, указав через точку
имя регистра, которому принадлежит этот
набор записей. Например,
Движения.ОстаткиМатериалов.

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

В
первой строке процедуры мы устанавливаем
свойство
Записывать набора
записей регистра в значение
Истина.
То есть в явном виде указываем, что после
завершения обработки проведения
платформа должна будет записать этот
набор записей в базу данных.

Внутри
обработчика расположен цикл
Для Каждого … Из … Цикл. Он
предназначен для перебора строк табличной
части нашего документа.

В
цикле обращение к табличной части
документа происходит по имени
(Материалы).
Переменная
ТекСтрокаМатериалы
содержит объект с данными текущей строки
табличной части документа. Эта переменная
создается в начале цикла и меняется по
мере его прохождения.

В
первой строке тела цикла, используя
метод
Добавить(),
мы добавляем к набору записей, который
создает наш документ в регистре, новую
запись. Тем самым мы создаем объект
РегистрНакопленияЗапись
и сохраняем его в переменной
Движение.

Используя
этот объект, мы можем обратиться к полям
этой записи, указав имя поля через точку
от этой переменной (например,
Движение.Количество).

Причем
Движение.Материал, Движение.Склад
— это измерения регистра,
Движение.Количество
— это ресурс регистра, а
Движение.ВидДвижения
и
Движение.Период
— стандартные реквизиты регистра, которые
создаются автоматически.

Чтобы
присвоить полям новой записи регистра
соответствующие значения полей документа,
мы обращаемся к полям табличной части,
указав имя поля через точку от переменной
ТекСтрокаМатериалы (например,
ТекСтрокаМатериалы.Материал).

Заметим,
что
Склад
— это реквизит шапки документа, а
Дата
— стандартный реквизит документа, который
создается автоматически. Причем в цикле
меняются только значения полей табличной
части документа —
ТекСтрокаМатериалы.Материал
и
ТекСтрокаМатериалы.Количество.
Остальные поля не меняются, так как
относятся к документу в целом и не
зависят от текущей строки табличной
части документа.

ВидДвиженияНакопления.Приход
— это значение системного перечис­ления,
которое определяет вид движения регистра
накопления
как Приход.

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

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

Рис.6.10. Регистраторы
регистра «ОстаткиМатериалов»

В
заключение отредактируем командный
интерфейс, чтобы в подсистемах
Бухгалтерия, Оказание услуг
и
Учет материалов
была доступна ссылка для просмотра
записей нашего регистра накопления.

Дело в том, что
команды открытия регистров также
добавляются в панель навигации подсистем,
но по умолчанию они невидимы, в отличие
от команд открытия справочников и
документов.

В
дереве объектов конфигурации выделим
ветвь
Подсистемы, вызовем
ее контекстное меню и выберем пункт
Все подсистемы.

В
открывшемся окне слева в списке
Подсистемы
выделим подсистему УчетМатериалов.

Справа
в списке
Командный интерфейс
отразятся все команды выбранной
подсистемы.

В
группе
Панель навигации. Обычное
включим видимость у команды Остатки
материалов
и мышью перетащим ее в группу
Панель навигации. См.также
(рис.
6.11).

Рис.6.11. Настройка
командного интерфейса подсистем

Действительно,
команды открытия регистров накопления
не так часто используются, и поэтому
лучше их перенести в группу См.также
панели навигации разделов интерфейса.

Аналогично,
выделив подсистемы
ОказаниеУслуг
и
Бухгалтерия,
в панели навигации в группе
Обычное
включим видимость у команды Остатки
материалов
и перенесем ее в группу
См.также.

Соседние файлы в предмете [НЕСОРТИРОВАННОЕ]

• #
• #
• #
• #
• #

  01.06.201523.04 Mб8Занятие_4.doc
• #
• #
• #
• #
• #
• #

1С 8.x : Как Получить, Прочитать, Изменить Движения документа по регистру?

 // Чтение движений документа с помощью запроса

Запрос = Новый Запрос;


Запрос.Текст = 

"ВЫБРАТЬ

|	*

|ИЗ

|	РегистрНакопления.ОстаткиНоменклатуры КАК ОстаткиНоменклатуры

|ГДЕ

|	ОстаткиНоменклатуры.Регистратор = &Регистратор";


Запрос.УстановитьПараметр("Регистратор", ПолеВводаРегистратор);   

 // Чтение движений документа

НаборЗаписейРегистра = Движения.ОстаткиНоменклатуры; 


НаборЗаписейРегистра.Прочитать();


Для Каждого Запись из НаборЗаписейРегистра Цикл	


	// Чтение и модификация очередного движения.


КонецЦикла;   

 // Изменение движений документа

Для Каждого НаборЗаписейРегистра из Движения Цикл

	НаборЗаписейРегистра.Прочитать();


	Для Каждого Запись из НаборЗаписейРегистра Цикл	


		// Чтение и модификация очередного движения.


	КонецЦикла;


КонецЦикла;   



  


                       
  

Документы в 1С 8.2 и 8.3 — объект метаданных, с помощью которого в 1С фиксируются хозяйственные операции предприятия.

Каждый созданный документ в конфигурации создать для отражения своего типа операции, например: поступление товаров, списание товаров и т.д.

Документы могут проводиться, а могут просто записываться. Документ, у которого разрешено проведение, как правило, при проведении создает записи в регистрах сведений, регистрах накопления, регистрах бухгалтерии, регистрах расчета, тем самым внося изменения в учет организации. Документы, у которых запрещено проведение, обычно используются как печатные формы, например: счет, доверенность и т.д.

Рассмотрим основные настройки и свойства документов.

Настройка и свойства документов в 1C 8.3 и 8.2

Рассмотрим самые интересные вкладки с точки зрения разработчика.

Данные

Одна из основные вкладок документа:

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

Получите 267 видеоуроков по 1С бесплатно:

Движения документа

Самая важная вкладка, на которой определяется состав регистров, по которым будет делать движения документ:

Рассмотрим подробно свойства документа на этой странице:

Проведение — разрешить или запретить. Определяет, будут ли движения по данному документу.

Оперативное проведение — разрешить или запретить. Если установлено разрешить, то проведение документа будущей датой невозможно.

Удаление движений — определяет режим очистки движения документа: Удалять автоматически при отмене проведения — движения будут очищены только при нажатии кнопки «Отмена проведения», но не удаляет при перепроведении. Удалять автоматически — значит, что движения будут удаляться в любом случае, даже если документ 1С перепроводится. Не удалять автоматически — значит, что удаление движений берет на себя разработчик системы.

Также для построения простых движений документа существует специальный конструктор движений, позволяющий упростить разработку:

Ввод на основании

Документ может быть введен на основании плана обмена, справочника, бизнес-процесса, задачи или другого документа. Для удобства можно воспользоваться специальным конструктором ввода на основании, который автоматически сгенерирует модуль обработчика заполнения:

Прочее

На вкладке Прочее можно найти очень важное свойство документа 1С (Режим блокировки):

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

Также со вкладки Прочее можно перейти в модуль менеджера и модуль объекта.

Небольшое обзорное видео про документы в 1С для программистов:

Если Вы начинаете изучать 1С программирование, рекомендуем наш бесплатный курс (не забудьте подписаться на YouTube — регулярно выходят новые видео):

К сожалению, мы физически не можем проконсультировать бесплатно всех желающих, но наша команда будет рада оказать услуги по внедрению и обслуживанию 1С. Более подробно о наших услугах можно узнать на странице Услуги 1С или просто позвоните по телефону +7 (499) 350 29 00. Мы работаем в Москве и области.

Если необходимо просто прочитать движения, без последующей модификации, можно воспользоваться запросом к нужному регистру:
Код 1C v 8.х
В запросе выбираем все поля (кроме виртуальных) из таблицы регистра РегистрНакопления.ОстаткиНоменклатуры с отбором по регистратору. Значением параметра Регистратор нужно будет установить ссылку на документ.

Если же нужно чтение с последующей модификацией движений, следует воспользоваться объектной моделью представления информации: в свойстве Движения объекта документа обратиться к нужному регистру (в нашем случае это регистр ОстаткиНоменклатуры) и прочитать набор записей регистра.
Код 1C v 8.х

Если требуется изменить движения документа по всем регистрам, нужно обойти фиксированную коллекцию, содержащуюся в свойстве Движения:
Код 1C v 8.х
Сначала открываем цикл перебора свойств свойства Движения – коллекций наборов записей регистров, для которых наш документ является регистратором.
Далее читаем наборы записей каждой коллекции и открываем цикл перебора записей данного набора записей.

Если необходимо просто прочитать движения, без последующей модификации, можно воспользоваться запросом к нужному регистру:
Код 1C v 8.х
В запросе выбираем все поля (кроме виртуальных) из таблицы регистра РегистрНакопления.ОстаткиНоменклатуры с отбором по регистратору. Значением параметра Регистратор нужно будет установить ссылку на документ.

Если же нужно чтение с последующей модификацией движений, следует воспользоваться объектной моделью представления информации: в свойстве Движения объекта документа обратиться к нужному регистру (в нашем случае это регистр ОстаткиНоменклатуры) и прочитать набор записей регистра.
Код 1C v 8.х

Если требуется изменить движения документа по всем регистрам, нужно обойти фиксированную коллекцию, содержащуюся в свойстве Движения:
Код 1C v 8.х
Сначала открываем цикл перебора свойств свойства Движения – коллекций наборов записей регистров, для которых наш документ является регистратором.
Далее читаем наборы записей каждой коллекции и открываем цикл перебора записей данного набора записей.

Реквизиты формы

Набор реквизитов формы описывает состав данных, которые отображаются, редактируются или хранятся в форме. При этом реквизиты формы сами по себе не обеспечивают возможности отображения и редактирования данных. Для отображения и редактирования служат элементы формы (смотрите раздел «Элементы формы» данной главы), связанные с реквизитами формы. Совокупность всех реквизитов формы будем называть данными формы.

Важно! Необходимо помнить, что, в отличие от обычных форм, все данные управляемой формы должны быть описаны в виде реквизитов. Не допускается использование переменных модуля формы в качестве источников данных для элементов формы.

Имеется возможность назначить Основной реквизит формы, т. е. реквизит, который будет определять стандартную функциональность формы (расширение формы). Следует помнить, что основной реквизит у формы может быть только один.

Расширение формы – это дополнительные свойства, методы и параметры формы объекта УправляемаяФорма, характерные для объекта, являющегося основным элементом формы.

В процессе разработки формы можно явно задать возможность просмотра и редактирования конкретных реквизитов формы, в разрезе ролей, с помощью свойств Просмотр и Редактирование (подробнее смотрите раздел «Ролевая настройка формы» главы «Редакторы»). Кроме того, доступность того или иного реквизита в самой форме можно настраивать с помощью функциональных опций (подробнее о функциональных опциях можно посмотреть в главе «Управление интерфейсом конфигурации»).

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

Типы данных, доступные в управляемой форме

Управляемая форма отличается от обычной формы также и типами данных, с которыми она работает. Если обычная форма работает с большинством типов, которые предоставляет 1С:Предприятие (в том числе и вида СправочникОбъект, ДокументОбъект и т. д.), то в управляемой форме можно выделить следующие категории типов:

• типы, которые непосредственно используются в форме – это те типы, которые существуют на стороне тонкого и Веб-клиента (например, Число, СправочникСсылка.Товары, ГрафическаяСхема, ТабличныйДокумент);

• типы, которые будут преобразованы в специальные типы данных – типы данных управляемой формы. Такие типы отображаются в списке реквизитов формы в круглых скобках, например (СправочникОбъект.Товары);

• динамический список (подробнее см. раздел «Динамический список» данной главы).

Преобразование прикладных объектов в данные формы

Некоторые прикладные типы (такие как СправочникОбъект и т. д.) не существуют на стороне тонкого и Веб-клиентов (подробнее см. главу «Концепция управляемого приложения»). Поэтому для представления в форме таких прикладных типов в платформе введены специальные типы данных, предназначенные для работы в управляемых формах. Эта особенность управляемого приложения обуславливает необходимость выполнять преобразование прикладных объектов в данные формы (и обратно).

Используются следующие типы данных:

• ДанныеФормыСтруктура – содержит набор свойств произвольного типа. Свойствами могут быть другие структуры, коллекции или структуры с коллекциями. Таким типом представляется, например, в форме СправочникОбъект.

• ДанныеФормыКоллекция – это список типизированных значений, похожий на массив. Доступ к элементу коллекции осуществляется по индексу или по идентификатору. Доступ по идентификатору может отсутствовать в некоторых случаях. Это обусловлено типом прикладного объекта, который представлен этой коллекцией. Идентификатором может быть любое целое число. Таким типом представляется, например, в форме табличная часть.

• ДанныеФормыСтруктураСКоллекцией – это объект, который представлен в виде структуры и коллекции одновременно. С ним можно обращаться как с любой из этих сущностей. Таким типом представляется, например, в форме набор записей.

• ДанныеФормыДерево – объект предназначен для хранения иерархических данных.

Прикладной объект представлен либо одним, либо несколькими элементами данных формы. В общем виде иерархия и состав данных формы зависят от сложности и взаимосвязи прикладных объектов управляемой формы.

Например, документ, содержащий табличную часть, будет представлен объектом типа ДанныеФормыСтруктура (собственно документ), которому подчинен объект типа ДанныеФормыКоллекция (табличная часть документа).

Важно! Во время разработки конфигурации важно помнить, что прикладные объекты доступны только на сервере, в то время как объектами данных форм можно пользоваться и на сервере, и на клиенте.

Передача данных между клиентской и серверной частями управляемой формы

Фактически можно сказать, что данные формы – это унифицированное представление данных различных прикладных объектов, с которыми форма работает единообразно и которые присутствуют и на сервере, и на клиенте. То есть форма содержит некоторую «проекцию» данных прикладных объектов в виде своих собственных типов данных и выполняет преобразование между ними при необходимости. Однако в случае если разработчик конфигурации реализует свой алгоритм обработки данных, то преобразование данных (из специализированных типов в прикладные и обратно) он должен выполнять самостоятельно.

При редактировании реквизитов формы в специализированном редакторе (подробнее см. раздел «Реквизиты формы» главы «Редакторы») имеется возможность влиять на передачу данных между клиентом и сервером во время работы формы. Для этого служит колонка редактора реквизитов Использовать всегда. Действие этого свойства различается для трех типов реквизитов:

• Для реквизита, подчиненного динамическому списку (колонке динамического списка):
  • свойство включено – реквизит всегда считывается из базы данных и включается в данные формы;
  • свойство выключено – реквизит считывается из базы данных и включается в данные формы только тогда, когда есть видимый в данный момент элемент формы, связанный с реквизитом или его подчиненным реквизитом.

• Для реквизита, подчиненного коллекции движений:
  • свойство включено – движения документа считываются из базы данных и будут присутствовать в данных формы;
  • свойство выключено – движения документа не будут считываться из базы данных и не попадут в данные формы (если нет элемента формы, ссылающегося на движения документа).

• Остальные реквизиты формы:
  • свойство включено – реквизит будет присутствовать в данных формы вне зависимости от того, есть или нет хоть один элемент формы, который связан с реквизитом или его подчиненным реквизитом;
  • свойство выключено – реквизит будет присутствовать в данных формы только в том случае, если есть элемент формы, связанный с реквизитом или его подчиненным реквизитом. В отличие от реквизитов динамического списка, здесь не играет роли видимость элемента, связанного с реквизитом.

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

Методы для преобразования данных прикладных объектов в данные формы

Для конвертирования прикладных объектов в данные формы и обратно существует набор глобальных методов:

• ЗначениеВДанныеФормы(),
• ДанныеФормыВЗначение(),
• КопироватьДанныеФормы().

Важно! Методы, работающие с прикладными объектами, доступны только в серверных процедурах. Метод для копирования значений между данными формы доступен на сервере и на клиенте, так как не требует прикладных объектов в качестве параметров.

Во время конвертирования данных формы в прикладной объект нужно учитывать их совместимость.

• ЗначениеВДанныеФормы() – преобразует объект прикладного типа в данные формы;
• ДанныеФормыВЗначение() – преобразует данные формы в объект прикладного типа;
• КопироватьДанныеФормы() – производит копирование данных формы, обладающих совместимой структурой. Возвращает значение Истина, если копирование произведено, или Ложь, если структура объектов несовместима.

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

Приведем пример, как использовать преобразование данных в собственных алгоритмах.

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
  ОбъектТовар = Справочники.Товары.НайтиПоНаименованию(«Кофейник»).ПолучитьОбъект();
  ЗначениеВДанныеФормы(ОбъектТовар, Объект);
КонецПроцедуры
 
&НаКлиенте
Процедура Записать()
  ЗаписатьНаСервере();
КонецПроцедуры
 
&НаСервере
Процедура ЗаписатьНаСервере()
  ОбъектТовар = ДанныеФормыВЗначение(Объект, Тип(«СправочникОбъект.Товары»));
  ОбъектТовар.Записать();
КонецПроцедуры

Также у объекта УправляемаяФорма существуют методы, доступные на сервере:

• ЗначениеВРеквизитФормы() – выполняет преобразование объекта прикладного типа в заданный реквизит формы.
• РеквизитФормыВЗначение() – преобразует реквизит данных формы в объект прикладного типа.

Использование данных методов обычно удобнее, так как они, имеют, например, информацию о типе реквизита формы. Кроме того, метод РеквизитФормыВЗначение() выполняет установку соответствия данных формы и объекта, которая используется при формировании сообщений. Подробнее об этом можно прочитать в главе «Сервисные возможности навигации».

Приведем пример использования этих методов.

&НаСервере
Процедура ПересчитатьНаСервере()
 
  // Преобразует реквизит Объект в прикладной объект.
  Документ = РеквизитФормыВЗначение(«Объект»);
 
  // Выполняет пересчет методом, определенным в модуле документа.
  Документ.Пересчитать();
 
  // Преобразует прикладной объект обратно в реквизит.
  ЗначениеВРеквизитФормы(Документ, «Объект»);
КонецПроцедуры

Программный интерфейс

ДанныеФормыДерево (FormDataTree)

Методы:

• НайтиПоИдентификатору (FindById)
• ПолучитьЭлементы (GetItems)

Описание:

Предназначен для моделирования дерева в данных управляемой формы.

Доступность: клиент, сервер, тонкий клиент, веб-клиент. Данный объект может быть сериализован в/из XDTO. Тип XDTO, соответствующий данному объекту определяется в пространстве имен . Имя типа XDTO:

ПолучитьЭлементы (GetItems)

Синтаксис:

ПолучитьЭлементы()

Возвращаемое значение:

Тип: ДанныеФормыКоллекцияЭлементовДерева.

Описание:

Получает коллекцию элементов дерева верхнего уровня.

Доступность: клиент, сервер, тонкий клиент, веб-клиент.

НайтиПоИдентификатору (FindById)

Синтаксис:

НайтиПоИдентификатору(<Идентификатор>)

Параметры:

<Идентификатор> (обязательный)

Тип: Число. Идентификатор элемента дерева.

Возвращаемое значение:

Тип: ДанныеФормыЭлементДерева.

Описание:

Получает элемент коллекции по идентификатору.

Доступность: клиент, сервер, тонкий клиент, веб-клиент.

ДанныеФормыЭлементДерева (FormDataTreeItem)

Свойства:

<Имя свойства> (<Имя свойства>)

Методы:

• ПолучитьИдентификатор (GetId)
• ПолучитьРодителя (GetParent)
• ПолучитьЭлементы (GetItems)
• Свойство (Property)

Описание:

Элемент дерева данных формы.

Доступность: клиент, сервер, тонкий клиент, веб-клиент. Данный объект может быть сериализован в/из XDTO. Тип XDTO, соответствующий данному объекту определяется в пространстве имен . Имя типа XDTO:

ДанныеФормыКоллекцияЭлементовДерева (FormDataTreeItemCollection)

Элементы коллекции:
ДанныеФормыЭлементДерева

Для объекта доступен обход коллекции посредством оператора Для каждого … Из … Цикл. При обходе выбираются элементы коллекции.
Возможно обращение к элементу коллекции посредством оператора […]. В качестве аргумента передается индекс элемента.

Методы:

• Вставить (Insert)
• Добавить (Add)
• Индекс (IndexOf)
• Количество (Count)
• Очистить (Clear)
• Получить (Get)
• Сдвинуть (Move)
• Удалить (Delete)

Описание:

Коллекция элементов дерева.

Доступность: клиент, сервер, тонкий клиент, веб-клиент.

См. также:

• ДанныеФормыЭлементДерева, метод ПолучитьЭлементы
• ДанныеФормыДерево, метод ПолучитьЭлементы

Особенности работы с деревом значений

Обновление дерева

Существует проблема падения платформы при обновлении дерева.

Если в дереве был развернут какой-либо узел и выбран подчиненный узел, то при обновлении дерева функцией ЗначениеВДанныеФормы
происходит падение платформы.

Решение: перед обновлением нужно очищать дерево.

Например:

&НаСервере
Процедура ОчиститьДерево(элементы)
	Для каждого элемент из элементы Цикл
		ОчиститьДерево(элемент.ПолучитьЭлементы());
	КонецЦикла;
	элементы.Очистить();
КонецПроцедуры

&НаСервере
Процедура ЗаполнитьДеревоПонятий()
	дзПонятия = срСвойства.ПостроитьДеревоПонятий(НаДату, Мета.ТекущаяИБ());
	ОчиститьДерево(ДеревоПонятий.ПолучитьЭлементы());
	ЗначениеВДанныеФормы(дзПонятия, ДеревоПонятий);
КонецПроцедуры

&НаКлиенте
Процедура НаДатуПриИзменении(Элемент)
	ЗаполнитьДеревоПонятий();
КонецПроцедуры

ПроведениеСервер.ИнициализироватьДополнительныеСвойстваДляПроведения(Ссылка, ДополнительныеСвойства, РежимПроведения);

Документы.РеализацияТоваровУслуг.ИнициализироватьДанныеДокумента(Ссылка, ДополнительныеСвойства);

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

Запрос = Новый Запрос;
ЗаполнитьПараметрыИнициализации(Запрос, ДокументСсылка);

ТекстыЗапроса = Новый СписокЗначений;
ТекстЗапросаТаблицаЗаказыКлиентов(Запрос, ТекстыЗапроса, Регистры);
ТекстЗапросаТаблицаСвободныеОстатки(Запрос, ТекстыЗапроса, Регистры);
ТекстЗапросаТаблицаОбеспечениеЗаказов(Запрос, ТекстыЗапроса, Регистры);
ТекстЗапросаТаблицаТоварыКОтгрузке(Запрос, ТекстыЗапроса, Регистры);
…

ПроведениеСервер.ИнициализироватьТаблицыДляДвижений(Запрос, ТекстыЗапроса, ДополнительныеСвойства.ТаблицыДляДвижений, Истина);

ПроведениеСервер.ПодготовитьНаборыЗаписейКРегистрацииДвижений(ЭтотОбъект);

ЗаказыСервер.ОтразитьЗаказыКлиентов(ДополнительныеСвойства, Движения, Отказ);
ЗапасыСервер.ОтразитьСвободныеОстатки(ДополнительныеСвойства, Движения, Отказ);
ЗапасыСервер.ОтразитьОбеспечениеЗаказов(ДополнительныеСвойства, Движения, Отказ);
ЗаказыСервер.ОтразитьТоварыКОтгрузке(ДополнительныеСвойства, Движения, Отказ);
…

ТаблицаЗаказыКлиентов = ДополнительныеСвойства.ТаблицыДляДвижений.ТаблицаЗаказыКлиентов;
…
ДвиженияЗаказыКлиентов.Загрузить(ТаблицаЗаказыКлиентов);

ПроведениеСервер.ЗаписатьНаборыЗаписей(ЭтотОбъект);

Объект.Движения.Записать();

ПроведениеСервер.ВыполнитьКонтрольРезультатовПроведения(ЭтотОбъект, Отказ);

ПроведениеСервер.ОчиститьДополнительныеСвойстваДляПроведения(ДополнительныеСвойства);

Документы.СчетФактураВыданный.АктуализироватьСчетФактуру(ЭтотОбъект, Истина, ТребуетсяСчетФактура());
РегистрыСведений.ТребуетсяОформлениеСчетаФактуры.ОтразитьНеобходимостьОформленияСчетаФактуры(ДополнительныеСвойства, Отказ);

&НаСервереБезКонтекста
Процедура ПерепровестиДокументРеализацииПоРегиструСвободныеОстатки(РеализацияСсылка, Отказ)
 
	РеализацияОбъект = РеализацияСсылка.ПолучитьОбъект();
ПроведениеСервер.ИнициализироватьДополнительныеСвойстваДляПроведения(РеализацияСсылка, РеализацияОбъект.ДополнительныеСвойства, РежимПроведенияДокумента.Неоперативный);
      	Документы.РеализацияТоваровУслуг.ИнициализироватьДанныеДокумента(РеализацияСсылка, РеализацияОбъект.ДополнительныеСвойства);
        	ЗапасыСервер.ОтразитьСвободныеОстатки(РеализацияОбъект.ДополнительныеСвойства, РеализацияОбъект.Движения, Отказ);
        	РеализацияОбъект.Движения.Записать();
        	
КонецПроцедуры // ПерепровестиДокументРеализацииПоРегиструСвободныеОстатки()

Об авторе

PDF-версия статьи для участников группы ВКонтакте

Мы ведем группу ВКонтакте – http://vk.com/kursypo1c.

Если Вы еще не вступили в нее – сделайте это сейчас, и в блоке ниже (на этой странице) появятся ссылки на скачивание материалов.

Если Вы уже участник группы – нужно просто повторно авторизоваться в ВКонтакте, чтобы скрипт Вас узнал. В случае проблем решение стандартное: очистить кэш браузера или подписаться через другой браузер.