Платформа 3V/Формы/Источники данных/Отчет/Параметры/На элементе управления (EntryExpressionUiSourceParameter): различия между версиями

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
Строка 23: Строка 23:
 
| discriminator|| EntryExpressionUiSourceParameterDto
 
| discriminator|| EntryExpressionUiSourceParameterDto
 
|}
 
|}
 
==Пример использования в качестве параметра выражения==
 
При необходимости вычисления некоторого выражения на основании значения элемента управления из блока uiSources используется соответствующий параметр EntryExpressionUiSourceParameterDto
 
 
Кейс: Вычислить полное наименование контрагента. Добавить текст "Публичное акционерное общество" перед значением соответствующего элемента управления "Краткое наименование"
 
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; overflow:auto;">
 
<div style="font-weight:bold;line-height:1.6;">JSON серверной карточки</div>
 
<div class="mw-collapsible-content mw-collapsed-content">
 
<syntaxhighlight lang="JSON" line>
 
{
 
"id": 123,
 
"title": "Использование в выражении параметра EntryExpressionUiSourceParameterDto",
 
"description": "",
 
"uiSources": [
 
{
 
"trimSpaces": false,
 
"defaultValue": null,
 
"value": null,
 
"id": 1,
 
"caption": "Краткое наименование",
 
"enable": true,
 
"visible": true,
 
"hint": null,
 
"uiDataSource": {
 
"attribute": {
 
"id": 23,
 
"discriminator": "OwnAttributeDefinitionDto"
 
},
 
"attributeId": null,
 
"sourceId": 100,
 
"discriminator": "UiDataSourceDictionary"
 
},
 
"doActionOnChangeValue": true,
 
"onAfterChangeValueConditionalActions": null,
 
"onAfterChangeValueByClientConditionalActions": null,
 
"rebuildDependentsObjectOnChange": true,
 
"enableRuleIds": [],
 
"visibleRuleIds": [],
 
"access": null,
 
"isValueChanged": false,
 
"expressionId": null,
 
"discriminator": "StringSourceEntry"
 
},
 
{
 
"trimSpaces": false,
 
"defaultValue": null,
 
"value": null,
 
"id": 2,
 
"caption": "Полное наименование",
 
"enable": true,
 
"visible": true,
 
"hint": null,
 
"uiDataSource": {
 
"attribute": {
 
"id": 2,
 
"discriminator": "OwnAttributeDefinitionDto"
 
},
 
"attributeId": null,
 
"sourceId": 100,
 
"discriminator": "UiDataSourceDictionary"
 
},
 
"doActionOnChangeValue": false,
 
"onAfterChangeValueConditionalActions": null,
 
"onAfterChangeValueByClientConditionalActions": null,
 
"rebuildDependentsObjectOnChange": true,
 
"enableRuleIds": [],
 
"visibleRuleIds": [],
 
"access": null,
 
"isValueChanged": false,
 
"expressionId": 1000,
 
"discriminator": "StringSourceEntry"
 
}
 
],
 
"entryDataSources": [
 
{
 
"dictionaryId": 100,
 
"filter": {
 
"parameterId": 1,
 
"attributeId": 1,
 
"conditionType": "AttributeInCollection",
 
"inversion": false,
 
"conditionId": null,
 
"discriminator": "EntryParameterFilterDto"
 
},
 
"groupingOptions": null,
 
"dictionaryAttributes": null,
 
"defaultValue": [],
 
"defaultValueExpressionId": null,
 
"parameterId": null,
 
"dictionarySourceSelectionMode": "None",
 
"dataSourceAttributesAdditionsSettings": [],
 
"id": 100,
 
"name": "Контрагенты",
 
"isReadOnly": false,
 
"dataEditRuleIds": [],
 
"beforeSaveDataActions": [],
 
"afterSaveDataActions": [],
 
"discriminator": "DictionaryDataSource"
 
}
 
],
 
"parameters": [
 
{
 
"defaultValue": [],
 
"id": 1,
 
"name": "Контрагент"
 
}
 
],
 
"binaryConditionsRules": [],
 
"expressions": [
 
{
 
"id": 1000,
 
"expression": "'Публичное акционерное общество '+[1]",
 
"returnFirstParameterValue": false,
 
"parameters": [
 
{
 
"uiSourceId": 1,
 
"id": 1,
 
"allowMultipleValues": false,
 
"discriminator": "EntryExpressionUiSourceParameterDto"
 
}
 
],
 
"comment": null
 
}
 
],
 
"actions": [],
 
"conditionalActions": [],
 
"conditionActionIdsOnOpen": []
 
}
 
</syntaxhighlight>
 
</div></div>
 
  
 
==Пример использования в качестве параметра отчета==
 
==Пример использования в качестве параметра отчета==

Версия 11:59, 17 сентября 2021

Параметр, который возращает значение элемента управления серверной карточки (uiSource) имеет следующую структуру:

1 {
2     "uiSourceId": 123,
3     "id": 1,
4     "allowMultipleValues": false,
5     "discriminator": "EntryExpressionUiSourceParameterDto"
6 }

Описание свойств параметра

Свойство Описание
uiSourceId Ссылка на идентификатор ("id") элемента управления
id Идентификатор параметра
allowMultipleValues Флаг об получении результата в виде коллекции значений (true/false)
discriminator EntryExpressionUiSourceParameterDto

Пример использования в качестве параметра отчета

При необходимости передать в качестве параметра отчета значение элемента управления из блока uiSources используется соответствующий параметр EntryExpressionUiSourceParameterDto

JSON серверной карточки
 1 {
 2 	"id": 123,
 3 	"title": "Использование в отчете параметра EntryExpressionUiSourceParameterDto",
 4 	"description": "",
 5 	"uiSources": [
 6 		{
 7 			"trimSpaces": false,
 8 			"defaultValue": null,
 9 			"value": null,
10 			"id": 1,
11 			"caption": "Параметр 1 отчета",
12 			"enable": true,
13 			"visible": true,
14 			"hint": null,
15 			"uiDataSource": {
16 				"attribute": {
17 					"id": 2,
18 					"discriminator": "OwnAttributeDefinitionDto"
19 				},
20 				"attributeId": null,
21 				"sourceId": 100,
22 				"discriminator": "UiDataSourceDictionary"
23 			},
24 			"doActionOnChangeValue": true,
25 			"onAfterChangeValueConditionalActions": null,
26 			"onAfterChangeValueByClientConditionalActions": null,
27 			"rebuildDependentsObjectOnChange": true,
28 			"enableRuleIds": [],
29 			"visibleRuleIds": [],
30 			"access": null,
31 			"isValueChanged": false,
32 			"expressionId": null,
33 			"discriminator": "StringSourceEntry"
34 		}
35 	],
36 	"entryDataSources": [
37 		{
38 			"pivotId": 100,
39 			"parameters": [
40 				{
41 					"uiSourceId": 1,
42 					"id": 1,
43 					"allowMultipleValues": false,
44 					"discriminator": "EntryExpressionUiSourceParameterDto"
45 				}
46 			],
47 			"focusOnFirstCell": true,
48 			"id": 100,
49 			"name": null,
50 			"isReadOnly": true,
51 			"dataEditRuleIds": [],
52 			"beforeSaveDataActions": [],
53 			"afterSaveDataActions": [],
54 			"discriminator": "PivotDataSource"
55 		}
56 	],
57 	"parameters": [],
58 	"binaryConditionsRules": [],
59 	"expressions": [],
60 	"actions": [],
61 	"conditionalActions": [],
62 	"conditionActionIdsOnOpen": []
63 }