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

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
 
(не показано 9 промежуточных версий 2 участников)
Строка 1: Строка 1:
−
Параметр, который возращает коллекцию [[Платформа_3V/Формы/Источники_данных/Справочник|'''атрибутов''']] элементов справочника - источника серверной карточки [[Платформа_3V/Формы/Источники_данных|'''(entryDataSources)''']] имеет следующую структуру:
+
Параметр, который возращает коллекцию атрибутов элементов [[Платформа_3V/Формы/Источники_данных/Справочник|'''справочника''']] - источника серверной карточки [[Платформа_3V/Формы/Источники_данных|'''(entryDataSources)''']] имеет следующую структуру:
  
 
<syntaxhighlight lang="JSON" line>
 
<syntaxhighlight lang="JSON" line>
Строка 5: Строка 5:
 
"id": 1,
 
"id": 1,
 
"allowMultipleValues": false,
 
"allowMultipleValues": false,
−
"discriminator": "EntryExpressionDictionarySourceParameterDto",
+
"discriminator": "EntryExpressionDictionarySourceParameter",
 
"dictionarySourceId": 100,
 
"dictionarySourceId": 100,
 
"attributeId": 1,
 
"attributeId": 1,
Строка 22: Строка 22:
 
| allowMultipleValues|| Флаг об получении результата в виде коллекции значений (true/false)
 
| allowMultipleValues|| Флаг об получении результата в виде коллекции значений (true/false)
 
|-
 
|-
−
| discriminator|| EntryExpressionDictionarySourceParameterDto
+
| discriminator|| EntryExpressionDictionarySourceParameter
 
|-  
 
|-  
 
| dictionarySourceId || Идентификатор [[Платформа_3V/Формы/Источники_данных/Справочник|'''справочника - источника серверной карточки''']]
 
| dictionarySourceId || Идентификатор [[Платформа_3V/Формы/Источники_данных/Справочник|'''справочника - источника серверной карточки''']]
Строка 33: Строка 33:
 
|}
 
|}
  
−
==Пример использования в качестве параметра выражения==
+
==Пример использования в качестве параметра отчета==
−
При необходимости вычисления некоторого выражения на основании справочника - источника из блока entryDataSources используется соответствующий параметр EntryExpressionDictionarySourceParameterDto
+
При необходимости передать в качестве параметра отчета элементы справочника - источника карточки, используется соответствующий параметр EntryExpressionDictionarySourceParameter
  
−
Кейс: Собрать строковый элемент управления "Наименования договоров (строка)" из наименований договоров, которые выбраны пользователем в соответствующем элементе управления на справочнике "Договоры"
+
Кейс: Отчет отображает отчетную информацию по одной или нескольким компаниям и в качестве параметра с id=1 получает отметку по интересующим компаниям
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; overflow:auto;">
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; overflow:auto;">
Строка 44: Строка 44:
 
{
 
{
 
"id": 123,
 
"id": 123,
−
"name": "Использование в выражении параметра EntryExpressionDictionarySourceParameterDto",
+
"title": "Использование в отчете параметра EntryExpressionDictionarySourceParameter",
−
"description": null,
+
"description": "",
−
"title": null,
 
−
"entrySettings": null,
 
 
"uiSources": [
 
"uiSources": [
 
{
 
{
Строка 57: Строка 55:
 
"maxElements": null,
 
"maxElements": null,
 
"hasServerFiltration": false,
 
"hasServerFiltration": false,
−
"searchSettings": {
 
−
"maxElements": null,
 
−
"minInputChars": 2,
 
−
"searchMode": "Client",
 
−
"debounceMs": 300
 
−
},
 
 
"id": 1,
 
"id": 1,
−
"caption": "Выпадающий список договоров",
+
"caption": "Выпадающий список компаний",
 
"enable": true,
 
"enable": true,
 
"visible": true,
 
"visible": true,
Строка 80: Строка 72:
 
},
 
},
 
{
 
{
−
"trimSpaces": false,
+
"pivotSourceId": 101,
−
"defaultValue": null,
+
"doActionOnChangeFocusedCell": false,
−
"value": null,
+
"doActionOnChangeCellValue": false,
 
"id": 2,
 
"id": 2,
−
"caption": "Наименования договоров (строка)",
+
"caption": null,
−
"enable": true,
+
"enable": false,
 
"visible": true,
 
"visible": true,
 
"hint": null,
 
"hint": null,
 +
"caption": "Отчетная информация компаний",
 +
"uiDataSource": null,
 
"doActionOnChangeValue": false,
 
"doActionOnChangeValue": false,
−
"onAfterChangeValueConditionalActions": null,
 
−
"onAfterChangeValueByClientConditionalActions": null,
 
−
"rebuildDependentsObjectOnChange": true,
 
−
"enableRuleIds": [],
 
−
"visibleRuleIds": [],
 
−
"access": null,
 
−
"isValueChanged": false,
 
−
"expressionId": 1000,
 
−
"discriminator": "StringSourceEntry"
 
−
}
 
−
],
 
−
"entryDataSources": [
 
−
{
 
−
"dictionaryId": 38238,
 
−
"hierarchyId": null,
 
−
"filter": null,
 
−
"sortingOptions": null,
 
−
"groupingOptions": null,
 
−
"dictionaryAttributes": null,
 
−
"defaultValueExpressionId": null,
 
−
"parameterId": null,
 
−
"dictionarySourceSelectionMode": "None",
 
−
"dataSourceAttributesAdditionsSettings": [],
 
−
"externalFileStorageUrl": null,
 
−
"filePrefix": null,
 
−
"defaultNewElementSettings": null,
 
−
"id": 100,
 
−
"name": "Договоры",
 
−
"isReadOnly": true,
 
−
"dataEditRuleIds": [],
 
−
"beforeSaveDataActions": [],
 
−
"afterSaveDataActions": [],
 
−
"discriminator": "DictionaryDataSource"
 
−
}
 
−
],
 
−
"parameters": [],
 
−
"binaryConditionsRules": [],
 
−
"submitValidateRules": [],
 
−
"expressions": [
 
−
{
 
−
"id": 1000,
 
−
"expression": "Concatenate(', ', [1])",
 
−
"returnFirstParameterValue": false,
 
−
"parameters": [
 
−
{
 
−
"id": 1,
 
−
"allowMultipleValues": true,
 
−
"discriminator": "EntryExpressionDictionarySourceParameterDto",
 
−
"dictionarySourceId": 100,
 
−
"attributeId": 2,
 
−
"getFirstElementValue": false,
 
−
"useAllInstanceElements": false
 
−
}
 
−
],
 
−
"comment": null
 
−
}
 
−
],
 
−
"controlsValueCalculateRules": [],
 
−
"actions": [],
 
−
"conditionActionIdsOnOpen": [],
 
−
"conditionalActions": [],
 
−
"selectionSets": [],
 
−
"reportTemplates": [],
 
−
"useNewDependenciesBuilder": null
 
−
}
 
−
</syntaxhighlight>
 
−
</div></div>
 
−
 
−
==Пример использования в качестве параметра отчета==
 
−
При необходимости передать в качестве параметра отчета элементы справочника - источника карточки используется соответствующий параметр EntryExpressionDictionarySourceParameterDto
 
−
Кейс: Отчет отображает отчетную информацию по одной или нескольким компаниям и в качестве параметра с id=1 получает отметку по интересующим договорам
 
−
 
−
<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": "Использование в отчете параметра EntryExpressionDictionarySourceParameterDto",
 
−
"description": "",
 
−
"uiSources": [
 
−
{
 
−
"dataSourceId": 100,
 
−
"nameTemplate": "",
 
−
"displayAttribute": null,
 
−
"hasMultipleValue": true,
 
−
"hasNullableValue": false,
 
−
"maxElements": null,
 
−
"hasServerFiltration": false,
 
−
"id": 1,
 
−
"caption": "Выпадающий список договоров",
 
−
"enable": true,
 
−
"visible": true,
 
−
"hint": null,
 
−
"doActionOnChangeValue": true,
 
 
"onAfterChangeValueConditionalActions": null,
 
"onAfterChangeValueConditionalActions": null,
 
"onAfterChangeValueByClientConditionalActions": null,
 
"onAfterChangeValueByClientConditionalActions": null,
Строка 192: Строка 91:
 
"isValueChanged": false,
 
"isValueChanged": false,
 
"expressionId": null,
 
"expressionId": null,
−
"discriminator": "DictionarySourceEntry"
+
"discriminator": "PivotSourceEntry"
 
}
 
}
 
],
 
],
Строка 211: Строка 110:
 
"defaultNewElementSettings": null,
 
"defaultNewElementSettings": null,
 
"id": 100,
 
"id": 100,
−
"name": "Договоры",
+
"name": "Компании",
 
"isReadOnly": true,
 
"isReadOnly": true,
 
"dataEditRuleIds": [],
 
"dataEditRuleIds": [],
Строка 224: Строка 123:
 
"id": 1,
 
"id": 1,
 
"allowMultipleValues": true,
 
"allowMultipleValues": true,
−
"discriminator": "EntryExpressionDictionarySourceParameterDto",
+
"discriminator": "EntryExpressionDictionarySourceParameter",
 
"dictionarySourceId": 100,
 
"dictionarySourceId": 100,
 
"attributeId": 1,
 
"attributeId": 1,

Текущая версия на 11:51, 16 марта 2022

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

1 {
2 	"id": 1,
3 	"allowMultipleValues": false,
4 	"discriminator": "EntryExpressionDictionarySourceParameter",
5 	"dictionarySourceId": 100,
6 	"attributeId": 1,
7 	"getFirstElementValue": false,
8 	"useAllInstanceElements": false
9 }

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

Свойство Описание
id Идентификатор параметра
allowMultipleValues Флаг об получении результата в виде коллекции значений (true/false)
discriminator EntryExpressionDictionarySourceParameter
dictionarySourceId Идентификатор справочника - источника серверной карточки
attributeId Идентификатор атрибута используемого справочника
getFirstElementValue Флаг на выбор только первого доступного элемента, при условии, что в справочнике пришла множественная отметка (true/false)
useAllInstanceElements Флаг для выбора всех элементов справочника, а не только отмеченных в элементе управления или отметкой по умолчанию (true/false)

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

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

Кейс: Отчет отображает отчетную информацию по одной или нескольким компаниям и в качестве параметра с id=1 получает отметку по интересующим компаниям

JSON серверной карточки
  1 {
  2 	"id": 123,
  3 	"title": "Использование в отчете параметра EntryExpressionDictionarySourceParameter",
  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": "EntryExpressionDictionarySourceParameter",
 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 }
Источник — https://wiki.3v-group.net/index.php?title=Платформа_3V/Формы/Источники_данных/Отчет/Параметры/На_источнике_-_справочнике_(EntryExpressionDictionarySourceParameterDto)&oldid=6243