Платформа 3V/Формы/Компоненты/Основные/Кнопка/Кнопка 'Сохранить'

!!!СТРАНИЦА НАХОДИТСЯ В СТАДИИ РАЗРАБОТКИ!!!

Кнопку "Сохранить" можно реализовать двумя способами:
1. кнопка ButtonSubmitSourceEntryDto,
2. кнопка CustomButtonEntry.

Обе кнопки могут содержать дополнительные действия помимо сохранения. Основным отличием является порядок сохранения данных - в кнопке ButtonSubmitSourceEntryDto нельзя управлять порядком сохранения.

ButtonSubmitSourceEntryDto

Пример

Имеется справочник контрагентов, ниже представлена серверная карточка для добавления наименования нового контрагента.
1. Добавлен контрол кнопка Сохранить id=100.
Этот вид кнопки сохраняет все введенные данные автоматически, при условии, что источник (источники), куда записываются данные имеет свойство "isReadOnly": false.

 1 {
 2       "actionConfirmation": {
 3         "message": null,
 4         "conditionId": null
 5       },
 6       "controlsValueCalculateRulesIds": [],
 7       "conditionalActions": [],
 8       "onBeforeClickConditionalActions": [],
 9       "submitRuleIds": [],
10       "id": 100,
11       "caption": "Сохранить",
12       "enable": true,
13       "visible": true,
14       "hint": null,
15       "uiDataSource": null,
16       "doActionOnChangeValue": true,
17       "onAfterChangeValueConditionalActions": null,
18       "onAfterChangeValueByClientConditionalActions": null,
19       "rebuildDependentsObjectOnChange": false,
20       "enableRuleIds": [],
21       "visibleRuleIds": [],
22       "access": null,
23       "isValueChanged": false,
24       "expressionId": null,
25       "discriminator": "ButtonSubmitSourceEntry"
26     }

2. Кнопка Сохранить будет сохранять введенное в строку значение в источник - справочник id=3.

 1 {
 2       "dictionaryId": 47,
 3       "hierarchyId": null,
 4       "filter": null,
 5       "sortingOptions": null,
 6       "groupingOptions": null,
 7       "dictionaryAttributes": null,
 8       "defaultValue": [],
 9       "defaultValueExpressionId": null,
10       "parameterId": null,
11       "dictionarySourceSelectionMode": "None",
12       "dataSourceAttributesAdditionsSettings": [],
13       "externalFileStorageUrl": null,
14       "filePrefix": null,
15       "defaultNewElementSettings": null,
16       "id": 3,
17       "name": "Список контрагентов",
18       "isReadOnly": false,
19       "dataEditRuleIds": [],
20       "beforeSaveDataActions": [],
21       "afterSaveDataActions": [],
22       "discriminator": "DictionaryDataSource"
23     
24 }

Здесь два контрола - кнопка Сохранить и строка для ввода нового наименования.
Источник один - справочник в который записываются новые данные, важно, что его свойство isReadOnly имеет значение false, поэтому кнопка типа ButtonSubmitSourceEntry автоматически записывает все введенные данные.

JSON серверной карточки

 1 {
 2   "id": 315,
 3   "name": "Кнопка сохранить (ButtonSubmitSourceEntry)",
 4   "description": null,
 5   "title": "Пример кнопки Сохранить ButtonSubmitSourceEntry",
 6   "entrySettings": null,
 7   "uiSources": [
 8     {
 9       "actionConfirmation": {
10         "message": null,
11         "conditionId": null
12       },
13       "controlsValueCalculateRulesIds": [],
14       "conditionalActions": [],
15       "onBeforeClickConditionalActions": [],
16       "submitRuleIds": [],
17       "id": 100,
18       "caption": "Сохранить",
19       "enable": true,
20       "visible": true,
21       "hint": null,
22       "uiDataSource": null,
23       "doActionOnChangeValue": true,
24       "onAfterChangeValueConditionalActions": null,
25       "onAfterChangeValueByClientConditionalActions": null,
26       "rebuildDependentsObjectOnChange": false,
27       "enableRuleIds": [],
28       "visibleRuleIds": [],
29       "access": null,
30       "isValueChanged": false,
31       "expressionId": null,
32       "discriminator": "ButtonSubmitSourceEntry"
33     },
34     {
35       "trimSpaces": false,
36       "defaultValue": null,
37       "value": null,
38       "id": 1,
39       "caption": "Новый контрагент",
40       "enable": true,
41       "visible": true,
42       "hint": null,
43       "uiDataSource": {
44         "attribute": {
45           "id": 2,
46           "discriminator": "OwnAttributeDefinitionDto"
47         },
48         "attributeId": null,
49         "sourceId": 3,
50         "discriminator": "UiDataSourceDictionary"
51       },
52       "doActionOnChangeValue": false,
53       "onAfterChangeValueConditionalActions": null,
54       "onAfterChangeValueByClientConditionalActions": null,
55       "enableRuleIds": [],
56       "visibleRuleIds": [],
57       "access": null,
58       "isValueChanged": false,
59       "expressionId": null,
60       "discriminator": "StringSourceEntry"
61     }
62   ],
63   "entryDataSources": [
64     {
65       "dictionaryId": 47,
66       "hierarchyId": null,
67       "filter": null,
68       "sortingOptions": null,
69       "groupingOptions": null,
70       "dictionaryAttributes": null,
71       "defaultValue": [],
72       "defaultValueExpressionId": null,
73       "parameterId": null,
74       "dictionarySourceSelectionMode": "None",
75       "dataSourceAttributesAdditionsSettings": [],
76       "externalFileStorageUrl": null,
77       "filePrefix": null,
78       "defaultNewElementSettings": null,
79       "id": 3,
80       "name": "Список контрагентов",
81       "isReadOnly": false,
82       "dataEditRuleIds": [],
83       "beforeSaveDataActions": [],
84       "afterSaveDataActions": [],
85       "discriminator": "DictionaryDataSource"
86     }
87   ],
88   "parameters": [],
89   "binaryConditionsRules": [],
90   "submitValidateRules": [],
91   "expressions": [],
92   "controlsValueCalculateRules": [],
93   "actions": [],
94   "conditionActionIdsOnOpen": [],
95   "conditionalActions": [],
96   "selectionSets": [],
97   "reportTemplates": [],
98   "useNewDependenciesBuilder": null
99 }

CustomButtonEntry

Кнопка CustomButtonEntry требует добавить действие, которое сохраняет добавленный элемент в источнике данных.

 1 {
 2   "id": 1,
 3   "caption": "Сохранить",
 4   "nullable": true,
 5   "enable": true,
 6   "visible": true,
 7   "hint": null,
 8   "nullable": true
 9   "uiDataSource": null,
10   "doActionOnChangeValue": true,
11   "onAfterChangeValueConditionalActions": null,
12   "onAfterChangeValueActions": null,
13   "onAfterChangeValueByClientConditionalActions": null,
14   "onAfterChangeValueByClientActions": null,
15   "rebuildDependentsObjectOnChange": true,
16   "enableExpressionIds": [],
17   "visibleExpressionIds": [],
18   "isValueChanged"  boolean
19   "expressionId": [],
20   "controlsValueCalculateRulesIds"[],
21   "actions"  [ 51, 50]
22   "onBeforeClickConditionalActions": [],
23   "onBeforeClickActions": [],
24   "submitRuleIds": [],
25   "discriminator": CustomButtonEntry,
26 }

Пример

Кейс: Внести данные об отпуске сотрудника - ФИО и период, при нажатии кнопки "Сохранить" произойдет вычисление количества дней отпуска, после этого данные сохранятся.

Вычисление и запись результата

JSON серверной карточки

  1 {
  2   "id": 356,
  3   "title": "",
  4   "description": "",
  5   "uiSources": [
  6     {
  7       "submitRuleIds": [],
  8       "actionConfirmation": {
  9         "message": null,
 10         "conditionId": null
 11       },
 12       "controlsValueCalculateRulesIds": [],
 13       "conditionalActions": [
 14         222,
 15         111,
 16         333
 17       ],
 18       "onBeforeClickConditionalActions": [],
 19       "id": 200,
 20       "caption": "Кнопка для вычисления длительности периода",
 21       "enable": true,
 22       "visible": true,
 23       "hint": null,
 24       "uiDataSource": null,
 25       "doActionOnChangeValue": false,
 26       "onAfterChangeValueConditionalActions": null,
 27       "onAfterChangeValueByClientConditionalActions": null,
 28       "enableRuleIds": [],
 29       "visibleRuleIds": [],
 30       "access": {
 31         "read": {
 32           "roles": [],
 33           "inversion": false,
 34           "default": true
 35         },
 36         "edit": {
 37           "roles": [],
 38           "inversion": false,
 39           "default": true
 40         }
 41       },
 42       "isValueChanged": false,
 43       "expressionId": null,
 44       "discriminator": "CustomButtonEntry"
 45     },
 46     {
 47       "id": 222,
 48       "caption": "Длительность периода",
 49       "enable": true,
 50       "visible": true,
 51       "uiDataSource": {
 52         "attribute": {
 53           "id": 20,
 54           "discriminator": "OwnAttributeDefinitionDto"
 55         },
 56         "attributeId": null,
 57         "sourceId": 1,
 58         "discriminator": "UiDataSourceDictionary"
 59       },
 60       "discriminator": "StringSourceEntry",
 61       "doActionOnChangeValue": false
 62     },
 63     {
 64       "defaultValue": null,
 65       "value": null,
 66       "id": 21,
 67       "caption": "Дата начала периода",
 68       "enable": true,
 69       "visible": true,
 70       "hint": null,
 71       "doActionOnChangeValue": false,
 72       "onAfterChangeValueConditionalActions": null,
 73       "onAfterChangeValueByClientConditionalActions": null,
 74       "visibleRuleIds": [],
 75       "isValueChanged": false,
 76       "expressionId": null,
 77       "discriminator": "DateTimeSourceEntry"
 78     },
 79     {
 80       "defaultValue": null,
 81       "value": null,
 82       "id": 22,
 83       "caption": "Дата конца периода",
 84       "enable": true,
 85       "visible": true,
 86       "hint": null,
 87       "doActionOnChangeValue": false,
 88       "onAfterChangeValueConditionalActions": null,
 89       "onAfterChangeValueByClientConditionalActions": null,
 90       "visibleRuleIds": [],
 91       "isValueChanged": false,
 92       "expressionId": null,
 93       "discriminator": "DateTimeSourceEntry"
 94     },
 95     {
 96       "trimSpaces": false,
 97       "defaultValue": null,
 98       "value": null,
 99       "id": 1,
100       "caption": "Список сотрудников",
101       "enable": true,
102       "visible": true,
103       "hint": null,
104       "uiDataSource": {
105         "attribute": {
106           "id": 2,
107           "discriminator": "OwnAttributeDefinitionDto"
108         },
109         "attributeId": null,
110         "sourceId": 1,
111         "discriminator": "UiDataSourceDictionary"
112       },
113       "doActionOnChangeValue": false,
114       "onAfterChangeValueConditionalActions": null,
115       "onAfterChangeValueByClientConditionalActions": null,
116       "enableRuleIds": [],
117       "visibleRuleIds": [],
118       "access": null,
119       "isValueChanged": false,
120       "expressionId": null,
121       "discriminator": "StringSourceEntry"
122     },
123     {
124       "id": 2,
125       "pivotSourceId": 2,
126       "doActionOnChangeFocusedCell": false,
127       "doActionOnChangeCellValue": true,
128       "caption": "Пивот Режимы",
129       "enable": true,
130       "visible": true,
131       "hint": null,
132       "uiDataSource": null,
133       "doActionOnChangeValue": false,
134       "onAfterChangeValueConditionalActions": null,
135       "onAfterChangeValueByClientConditionalActions": null,
136       "enableRuleIds": [],
137       "visibleRuleIds": [],
138       "access": {},
139       "isValueChanged": false,
140       "expressionId": null,
141       "discriminator": "PivotSourceEntry"
142     }
143   ],
144   "entryDataSources": [
145     {
146       "dictionaryId": 316,
147       "hierarchyId": null,
148       "filter": null,
149       "sortingOptions": null,
150       "groupingOptions": null,
151       "dictionaryAttributes": null,
152       "defaultValue": [],
153       "defaultValueExpressionId": null,
154       "parameterId": null,
155       "dictionarySourceSelectionMode": "None",
156       "dataSourceAttributesAdditionsSettings": [],
157       "externalFileStorageUrl": null,
158       "filePrefix": null,
159       "defaultNewElementSettings": null,
160       "id": 1,
161       "name": "Отпуска",
162       "isReadOnly": false,
163       "dataEditRuleIds": [],
164       "beforeSaveDataActions": [],
165       "afterSaveDataActions": [],
166       "discriminator": "DictionaryDataSource"
167     },
168     {
169       "pivotId": 358,
170       "parameters": [],
171       "id": 2,
172       "name": "Пивот Сотрудник и количество дней отпуска",
173       "isReadOnly": false,
174       "dataEditRuleIds": [],
175       "beforeSaveDataActions": [],
176       "afterSaveDataActions": [],
177       "discriminator": "PivotDataSource"
178     }
179   ],
180   "parameters": null,
181   "binaryConditionsRules": [],
182   "expressions": [
183     {
184       "id": 222,
185       "expression": "if(IsNullOrEmpty([21]) or IsNullOrEmpty([22]), Null(), (TrimTime([22])-TrimTime([21]))+1)",
186       "returnFirstParameterValue": false,
187       "parameters": [
188         {
189           "uiSourceId": 22,
190           "id": 22,
191           "discriminator": "EntryExpressionUiSourceParameterDto"
192         },
193         {
194           "uiSourceId": 21,
195           "id": 21,
196           "discriminator": "EntryExpressionUiSourceParameterDto"
197         }
198       ],
199       "comment": null
200     }
201   ],
202   "actions": [
203     {
204       "dataSourcesIds": [
205         1
206       ],
207       "id": 111,
208       "comment": "Сохранение значения",
209       "discriminator": "SaveDataSourceAction"
210     },
211     {
212       "id": 222,
213       "controlId": 222,
214       "expressionId": 222,
215       "comment": "Вычисление количества дней отпуска",
216       "discriminator": "CalculateControlValueAction"
217     },
218     {
219       "instanceId": 2,
220       "id": 333,
221       "comment": null,
222       "discriminator": "RebuildSourceInstanceAction"
223     }
224   ],
225   "conditionalActions": [
226     {
227       "id": 111,
228       "binaryConditionRuleId": null,
229       "actions": [
230         111
231       ],
232       "parallelRunning": true
233     },
234     {
235       "id": 222,
236       "binaryConditionRuleId": null,
237       "actions": [
238         222
239       ]
240     },
241     {
242       "id": 333,
243       "binaryConditionRuleId": null,
244       "actions": [
245         333
246       ]
247     }
248   ],
249   "conditionActionIdsOnOpen": null
250 }