Платформа 3V/Формы/Источники данных/Отчет/Параметры/На источнике - справочнике (EntryExpressionDictionarySourceParameterDto): различия между версиями
< Платформа 3V | Формы | Источники данных | Отчет | Параметры
Перейти к навигации
Перейти к поиску
Версия 10:12, 16 апреля 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 "caption": "Отчетная информация компаний",
40 "uiDataSource": null,
41 "doActionOnChangeValue": false,
42 "onAfterChangeValueConditionalActions": null,
43 "onAfterChangeValueByClientConditionalActions": null,
44 "rebuildDependentsObjectOnChange": true,
45 "enableRuleIds": [],
46 "visibleRuleIds": [],
47 "access": null,
48 "isValueChanged": false,
49 "expressionId": null,
50 "discriminator": "PivotSourceEntry"
51 }
52 ],
53 "entryDataSources": [
54 {
55 "dictionaryId": 38238,
56 "hierarchyId": null,
57 "filter": null,
58 "sortingOptions": null,
59 "groupingOptions": null,
60 "dictionaryAttributes": null,
61 "defaultValueExpressionId": null,
62 "parameterId": null,
63 "dictionarySourceSelectionMode": "None",
64 "dataSourceAttributesAdditionsSettings": [],
65 "externalFileStorageUrl": null,
66 "filePrefix": null,
67 "defaultNewElementSettings": null,
68 "id": 100,
69 "name": "Компании",
70 "isReadOnly": true,
71 "dataEditRuleIds": [],
72 "beforeSaveDataActions": [],
73 "afterSaveDataActions": [],
74 "discriminator": "DictionaryDataSource"
75 },
76 {
77 "pivotId": 31000,
78 "parameters": [
79 {
80 "id": 1,
81 "allowMultipleValues": true,
82 "discriminator": "EntryExpressionDictionarySourceParameterDto",
83 "dictionarySourceId": 100,
84 "attributeId": 1,
85 "getFirstElementValue": false,
86 "useAllInstanceElements": false
87 }
88 ],
89 "focusOnFirstCell": true,
90 "id": 101,
91 "name": "Отчетная информация компаний",
92 "isReadOnly": true,
93 "dataEditRuleIds": [],
94 "beforeSaveDataActions": [],
95 "afterSaveDataActions": [],
96 "discriminator": "PivotDataSource"
97 }
98 ],
99 "parameters": [],
100 "binaryConditionsRules": [],
101 "expressions": [],
102 "actions": [],
103 "conditionalActions": [],
104 "conditionActionIdsOnOpen": []
105 }