Движения по регистру сведений
- Александр Анисков
Описание движений по регистру сведений всегда начинается с заголовка, в качестве которого выступает синоним регистра сведений, а в скобках его имя согласно метаданным.
Пример
Расчет нормирования расходов (РасчетНормированияРасходов)
Если при проведении требуется учесть какие-либо особенности, они должны быть описаны перед таблицей движений.
Описание движений
В качестве описания используется таблица следующего вида:
| Данные | Источник | Комментарий |
|---|---|---|
|
| Особенности записи значений, если таковые имеются |
При это все виды данных должны быть разграничены между собой заглавной строкой, с объединенными ячейками и соответствующим значением.
Пример описания движений по регистру:
| Данные | Источник | Комментарий |
|---|---|---|
| Предопределенные | ||
| Период | Дата | дата документа |
| Измерения | ||
| Организация | Организация | из шапки документа |
| Контрагент | ТЧ → Контрагенты → Контрагент | |
| Ресурсы | ||
| Куратор | ТЧ → Контрагенты → Куратор | |
| Реквизиты | ||
| Приказ | ТЧ → Контрагенты → Приказ | |
Описание колонок
При указании имен данных, источников или реквизитов в комментариях необходимо придерживаться Правил указания имен.
Данные
В качестве данных выступают имена предопределенных колонок, измерений, ресурсов или реквизитов, которые требуется записывать. В качестве значения указывается имя, а в скобочках синоним. Синоним может не указываться, если он не отличается от имени разделенного пробелами.
Источник данных
В качестве источника данных может выступать:
- Реквизит шапки регистратора
- Реквизит табличной части регистратор
Ранее рассчитанная переменная
- Пустое значение (см. примечание ниже, о составных типах значений)
- "Как есть" - это означает, оставить значение, которое устанавливается в текущий момент (только в случае изменения существующих движений)
ВАЖНО
Для измерений, ресурсов или реквизитов, имеющих составной тип данных (например: несколько справочников, документов или др. типов) значение указанное как "пустое значение" будет интерпретировано при разработке, как значение "Неопределено", т.е. без указанного типа. В некоторых случаях это неприемлимо. Тогда необходимо указывать "Справочник.Контрагенты.ПустаяСсылка" (или "Справочник → Контрагенты → Пустая ссылка").
Комментарий
В качестве комментария может быть указан любая произвольная информация, необходимая разработчику при программировании.
Предопределенные данные
Для периодического регистра сведений всегда есть предопределенный реквизит "Период". В качестве значения реквизита может выступать только тип "Дата" с указанием или без времени (зависит от периодичности регистра сведений).
Разграничение по видам операций
Применяются общие требования.
Регистр сведений, не подчиненный регистратору
В некоторых случаях, регистр может быть не подчинен регистратору. Например: согласно бизнес-логики движения в данный регистр вносятся вручную или некоторыми документами.
В таком случае необходимо чтобы были обеспечены следующие обязательные требования:
- в реквизиты необходимо добавить реквизит
- Имя: ИсточникДвижений (может быть изменено)
- Синоним: Источник движений (может быть изменено)
- Тип: ЛюбаяСсылка
- Индексировать: Индексировать
- обеспечить удаление ранее созданных движений из регистра, в случае отмены проведения документа или удалении элементов справочников, бизнес-процессов, планов счетов и т.п.
Реквизит "ИсточникДвижений" заполняется ссылкой на объект, который создал движения. По данному реквизиту, при удалении, отбираются значения для очистки.
ВАЖНО
В некоторых случаях, данное требование сложно к выполнению. Например если регистр сведений находится на поддержке стороннего разработчика. В таком случае, необходимо обсудить с руководителем проекта или архитектором проекта данный момент и отразить его в особенностях технического описания проекта.