Общая логика

011 012

Новая концепция формы - новый способ работы с формой, которая 013 поменяла способ общения между сервером и клиентом, а именно 014 коммуникация между ними происходит в форме запрос/команды. Клиент 015 делает запрос и получает список команд, которых ему надо 016 выполнить.

017 018

В новой концепции появилась иерархия форм - теперь есть такие 019 понятия, как родительские и дочерние формы.

020 021

Если форма была создана не с другой формы, то она является 022 корневой и не имеет родителя.

023 024

Если форма была создана с другой формы (поле БО, нажатие на 025 кнопку добавить), то новая созданная (вложенная) форма будет 026 дочерной, а ее родителем будет предыдущая форма

027 028

Первый этап

029 030

Первый этап сохранении/изменении инстанции - это создание 031 черновика.

032 033

Черновик создается в регистре 034 InstanceDraftCreateRegister.

035 036

При создании черновика НАДО передать всю полезную информацию про 037 контекст, откуда запрос делается. Под полезной информацией 038 понимается уровень вложенности текущей инстанции, есть ли вообще 039 текущая инстанция (текущей инстанции может и не быть, пример - 040 нажатие на + над таблицой).

041 042

При создании черновика происходят следующие события (очередность 043 сохранена):

044 045

046  Копирование с поля
047  
048  Формулы
049  
050  Скрипт на открытие формы
051  
052  Активация ловушки-липучки (объязует пользователя сохранить данную форму)
053  
054  
055  
056

057 058

Второй этап

059 060

Второй этап сохранении/изменении инстанции - это изменение 061 черновика.

062 063

Данные о полей берутся с регистра 064 InstanceFormRegister

065 066

Эти данные хранят минимальную информацию; остальная информация о 067 полях, включая storedValue, извлекается со следующих регистров:

068 069

070  InstanceFieldFormRegister
071  
072  InstanceFieldFormDataRegister
073  
074  
075  
076

077 078

Значение записываются в черновик с помощью метода: 079 InstanceFieldFormRegister.saveBoiFieldValue()

080 081

Алгоритм действий внутри вышенаписанного метода следующая:

082 083

084  Проверка всех BoiFieldValueToSave
085  
086  Обновление участников
087  
088  Копирование полей
089  
090  Вычисление формул
091  
092  Скрипты на изменение полей
093  
094  Применение изменений
095  
096  Валидация формы
097  
098  
099  
100

101 102

Третий этап

103 104

Третий (и последний) этап сохранении/изменении инстанции - это 105 применение/отмена черновика.

106 107

При отмене формы отрабатывается скрипт на закрытие формы.

108 109

Также при отмене формы удаляются:

110 111

112  Запрашиваемая форма
113  
114  Прямые потомки данной формы
115  
116  Непрямые потомки данной формы
117  
118  
119  
120

121 122

Непрямыми потомками формы являются потомки прямых потомков формы 123 (процесс рекурсивный).

124 125

Метод, который отвечает за отмену формы: 126 InstanceDraftRegister.removeDraft()

127 128

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

130 131

Если форма имеет родителя, то применятся она будет в 132 родительский черновик.

133 134

Если форма не имеет родителя, то она применяется в саму 135 инстанцию.

136 137

Метод, который отвечает за применение формы: 138 InstanceDraftRegister.validateAndApplyAndRemoveDraft()

139