Платформа 3V/Формы/Источники данных/Отчет/Параметры/На источнике - справочнике (EntryExpressionDictionarySourceParameterDto): различия между версиями
< Платформа 3V | Формы | Источники данных | Отчет | Параметры
Перейти к навигации
Перейти к поиску
| Строка 198: | Строка 198: | ||
"doActionOnChangeFocusedCell": false, | "doActionOnChangeFocusedCell": false, | ||
"doActionOnChangeCellValue": false, | "doActionOnChangeCellValue": false, | ||
| − | "id": | + | "id": 2, |
"caption": null, | "caption": null, | ||
"enable": false, | "enable": false, | ||
Версия 13:54, 9 апреля 2021
Параметр, который возращает коллекцию атрибутов элементов справочника - источника серверной карточки (entryDataSources) имеет следующую структуру:
1 {
2 "id": 1,
3 "allowMultipleValues": false,
4 "discriminator": "EntryExpressionDictionarySourceParameterDto",
5 "dictionarySourceId": 100,
6 "attributeId": 1,
7 "getFirstElementValue": false,
8 "useAllInstanceElements": false
9 }
Описание свойств параметра
| Свойство | Описание |
|---|---|
| id | Идентификатор параметра |
| allowMultipleValues | Флаг об получении результата в виде коллекции значений (true/false) |
| discriminator | EntryExpressionDictionarySourceParameterDto |
| dictionarySourceId | Идентификатор справочника - источника серверной карточки |
| attributeId | Идентификатор атрибута используемого справочника |
| getFirstElementValue | Флаг на выбор только первого доступного элемента, при условии, что в справочнике пришла множественная отметка (true/false) |
| useAllInstanceElements | Флаг для выбора всех элементов справочника, а не только отмеченных в элементе управления или отметкой по умолчанию (true/false) |
Пример использования в качестве параметра выражения
При необходимости вычисления некоторого выражения на основании справочника - источника из блока entryDataSources используется соответствующий параметр EntryExpressionDictionarySourceParameterDto
Кейс: Собрать строковый элемент управления "Наименования договоров (строка)" из наименований договоров, которые выбраны пользователем в соответствующем элементе управления на справочнике "Договоры"
JSON серверной карточки
1 {
2 "id": 123,
3 "name": "Использование в выражении параметра EntryExpressionDictionarySourceParameterDto",
4 "description": null,
5 "title": null,
6 "entrySettings": null,
7 "uiSources": [
8 {
9 "dataSourceId": 100,
10 "nameTemplate": "",
11 "displayAttribute": null,
12 "hasMultipleValue": true,
13 "hasNullableValue": false,
14 "maxElements": null,
15 "hasServerFiltration": false,
16 "searchSettings": {
17 "maxElements": null,
18 "minInputChars": 2,
19 "searchMode": "Client",
20 "debounceMs": 300
21 },
22 "id": 1,
23 "caption": "Выпадающий список договоров",
24 "enable": true,
25 "visible": true,
26 "hint": null,
27 "doActionOnChangeValue": true,
28 "onAfterChangeValueConditionalActions": null,
29 "onAfterChangeValueByClientConditionalActions": null,
30 "rebuildDependentsObjectOnChange": true,
31 "enableRuleIds": [],
32 "visibleRuleIds": [],
33 "access": null,
34 "isValueChanged": false,
35 "expressionId": null,
36 "discriminator": "DictionarySourceEntry"
37 },
38 {
39 "trimSpaces": false,
40 "defaultValue": null,
41 "value": null,
42 "id": 2,
43 "caption": "Наименования договоров (строка)",
44 "enable": true,
45 "visible": true,
46 "hint": null,
47 "doActionOnChangeValue": false,
48 "onAfterChangeValueConditionalActions": null,
49 "onAfterChangeValueByClientConditionalActions": null,
50 "rebuildDependentsObjectOnChange": true,
51 "enableRuleIds": [],
52 "visibleRuleIds": [],
53 "access": null,
54 "isValueChanged": false,
55 "expressionId": 1000,
56 "discriminator": "StringSourceEntry"
57 }
58 ],
59 "entryDataSources": [
60 {
61 "dictionaryId": 38238,
62 "hierarchyId": null,
63 "filter": null,
64 "sortingOptions": null,
65 "groupingOptions": null,
66 "dictionaryAttributes": null,
67 "defaultValueExpressionId": null,
68 "parameterId": null,
69 "dictionarySourceSelectionMode": "None",
70 "dataSourceAttributesAdditionsSettings": [],
71 "externalFileStorageUrl": null,
72 "filePrefix": null,
73 "defaultNewElementSettings": null,
74 "id": 100,
75 "name": "Договоры",
76 "isReadOnly": true,
77 "dataEditRuleIds": [],
78 "beforeSaveDataActions": [],
79 "afterSaveDataActions": [],
80 "discriminator": "DictionaryDataSource"
81 }
82 ],
83 "parameters": [],
84 "binaryConditionsRules": [],
85 "submitValidateRules": [],
86 "expressions": [
87 {
88 "id": 1000,
89 "expression": "Concatenate(', ', [1])",
90 "returnFirstParameterValue": false,
91 "parameters": [
92 {
93 "id": 1,
94 "allowMultipleValues": true,
95 "discriminator": "EntryExpressionDictionarySourceParameterDto",
96 "dictionarySourceId": 100,
97 "attributeId": 2,
98 "getFirstElementValue": false,
99 "useAllInstanceElements": false
100 }
101 ],
102 "comment": null
103 }
104 ],
105 "controlsValueCalculateRules": [],
106 "actions": [],
107 "conditionActionIdsOnOpen": [],
108 "conditionalActions": [],
109 "selectionSets": [],
110 "reportTemplates": [],
111 "useNewDependenciesBuilder": null
112 }
Пример использования в качестве параметра отчета
При необходимости передать в качестве параметра отчета элементы справочника - источника карточки используется соответствующий параметр EntryExpressionDictionarySourceParameterDto Кейс: Отчет отображает отчетную информацию по одной или нескольким компаниям и в качестве параметра с id=1 получает отметку по интересующим договорам
JSON серверной карточки
1 {
2 "id": 123,
3 "title": "Использование в отчете параметра EntryExpressionDictionarySourceParameterDto",
4 "description": "",
5 "uiSources": [
6 {
7 "dataSourceId": 100,
8 "nameTemplate": "",
9 "displayAttribute": null,
10 "hasMultipleValue": true,
11 "hasNullableValue": false,
12 "maxElements": null,
13 "hasServerFiltration": false,
14 "id": 1,
15 "caption": "Выпадающий список договоров",
16 "enable": true,
17 "visible": true,
18 "hint": null,
19 "doActionOnChangeValue": true,
20 "onAfterChangeValueConditionalActions": null,
21 "onAfterChangeValueByClientConditionalActions": null,
22 "rebuildDependentsObjectOnChange": true,
23 "enableRuleIds": [],
24 "visibleRuleIds": [],
25 "access": null,
26 "isValueChanged": false,
27 "expressionId": null,
28 "discriminator": "DictionarySourceEntry"
29 },
30 {
31 "pivotSourceId": 101,
32 "doActionOnChangeFocusedCell": false,
33 "doActionOnChangeCellValue": false,
34 "id": 2,
35 "caption": null,
36 "enable": false,
37 "visible": true,
38 "hint": null,
39 "uiDataSource": null,
40 "doActionOnChangeValue": false,
41 "onAfterChangeValueConditionalActions": null,
42 "onAfterChangeValueByClientConditionalActions": null,
43 "rebuildDependentsObjectOnChange": true,
44 "enableRuleIds": [],
45 "visibleRuleIds": [],
46 "access": null,
47 "isValueChanged": false,
48 "expressionId": null,
49 "discriminator": "PivotSourceEntry"
50 }
51 ],
52 "entryDataSources": [
53 {
54 "dictionaryId": 38238,
55 "hierarchyId": null,
56 "filter": null,
57 "sortingOptions": null,
58 "groupingOptions": null,
59 "dictionaryAttributes": null,
60 "defaultValueExpressionId": null,
61 "parameterId": null,
62 "dictionarySourceSelectionMode": "None",
63 "dataSourceAttributesAdditionsSettings": [],
64 "externalFileStorageUrl": null,
65 "filePrefix": null,
66 "defaultNewElementSettings": null,
67 "id": 100,
68 "name": "Договоры",
69 "isReadOnly": true,
70 "dataEditRuleIds": [],
71 "beforeSaveDataActions": [],
72 "afterSaveDataActions": [],
73 "discriminator": "DictionaryDataSource"
74 },
75 {
76 "pivotId": 31000,
77 "parameters": [
78 {
79 "id": 1,
80 "allowMultipleValues": true,
81 "discriminator": "EntryExpressionDictionarySourceParameterDto",
82 "dictionarySourceId": 100,
83 "attributeId": 1,
84 "getFirstElementValue": false,
85 "useAllInstanceElements": false
86 }
87 ],
88 "focusOnFirstCell": true,
89 "id": 101,
90 "name": "Отчетная информация компаний",
91 "isReadOnly": true,
92 "dataEditRuleIds": [],
93 "beforeSaveDataActions": [],
94 "afterSaveDataActions": [],
95 "discriminator": "PivotDataSource"
96 }
97 ],
98 "parameters": [],
99 "binaryConditionsRules": [],
100 "expressions": [],
101 "actions": [],
102 "conditionalActions": [],
103 "conditionActionIdsOnOpen": []
104 }